Remove Hausa language support - model discontinued

EMERGENCY_FLUTTER_FIX.md

@@ -0,0 +1,284 @@
+# 🚨 EMERGENCY Flutter Fix - 404 & Microphone Issues
+
+## ⚡ **QUICK FIX 1: API URL (404 Error)**
+
+Your Hugging Face Space URL format is incorrect. Try these URLs in order:
+
+### **Option A: Try this URL format:**
+```dart
+static const String baseUrl = 'https://carsaai-carsa-api.hf.space';
+```
+
+### **Option B: If Option A fails, try:**
+```dart
+static const String baseUrl = 'https://carsaai-carsa-api.hf.space:7860';
+```
+
+### **Option C: If both fail, use direct Space URL:**
+```dart
+static const String baseUrl = 'https://huggingface.co/spaces/CarsaAI/carsa_api/proxy';
+```
+
+## ⚡ **QUICK FIX 2: Microphone Crash**
+
+### **Step 1: Update pubspec.yaml**
+```yaml
+dependencies:
+  flutter:
+    sdk: flutter
+  http: ^1.1.0
+  # ADD THESE IMMEDIATELY:
+  permission_handler: ^11.0.1
+  flutter_sound: ^9.2.13
+  path_provider: ^2.1.1
+```
+
+### **Step 2: Run this command:**
+```bash
+flutter pub get
+```
+
+### **Step 3: Update AndroidManifest.xml**
+
+File: `android/app/src/main/AndroidManifest.xml`
+
+```xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- ADD THESE PERMISSIONS -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+    
+    <application
+        android:label="carsa_ai"
+        android:name="${applicationName}"
+        android:icon="@mipmap/ic_launcher">
+        <!-- Your existing app configuration -->
+    </application>
+</manifest>
+```
+
+### **Step 4: Create Simple Audio Service**
+
+Create `lib/services/simple_audio_service.dart`:
+
+```dart
+import 'dart:io';
+import 'package:flutter_sound/flutter_sound.dart';
+import 'package:permission_handler.dart';
+import 'package:path_provider/path_provider.dart';
+
+class SimpleAudioService {
+  static FlutterSoundRecorder? _recorder;
+  static bool _isInitialized = false;
+
+  static Future<void> init() async {
+    if (_isInitialized) return;
+    
+    _recorder = FlutterSoundRecorder();
+    await _recorder!.openRecorder();
+    _isInitialized = true;
+    print('✅ Audio service initialized');
+  }
+
+  static Future<bool> checkPermissions() async {
+    var status = await Permission.microphone.status;
+    if (!status.isGranted) {
+      status = await Permission.microphone.request();
+    }
+    print('🎤 Microphone permission: ${status.isGranted}');
+    return status.isGranted;
+  }
+
+  static Future<String?> startRecording() async {
+    try {
+      await init();
+      
+      if (!await checkPermissions()) {
+        throw Exception('Microphone permission denied');
+      }
+
+      final directory = await getTemporaryDirectory();
+      final filePath = '${directory.path}/recording.wav';
+
+      await _recorder!.startRecorder(
+        toFile: filePath,
+        codec: Codec.pcm16WAV,
+      );
+
+      print('🔴 Recording started: $filePath');
+      return filePath;
+    } catch (e) {
+      print('❌ Recording error: $e');
+      return null;
+    }
+  }
+
+  static Future<String?> stopRecording() async {
+    try {
+      final path = await _recorder!.stopRecorder();
+      print('⏹️ Recording stopped: $path');
+      return path;
+    } catch (e) {
+      print('❌ Stop recording error: $e');
+      return null;
+    }
+  }
+}
+```
+
+### **Step 5: Update Your UI (Quick Version)**
+
+```dart
+import 'package:flutter/material.dart';
+import 'services/api_service.dart';
+import 'services/simple_audio_service.dart';
+
+class QuickFixScreen extends StatefulWidget {
+  @override
+  _QuickFixScreenState createState() => _QuickFixScreenState();
+}
+
+class _QuickFixScreenState extends State<QuickFixScreen> {
+  bool isRecording = false;
+  bool isLoading = false;
+  String result = '';
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: Text('Carsa AI - Emergency Fix')),
+      body: Padding(
+        padding: EdgeInsets.all(20),
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            // Test Translation Button
+            ElevatedButton(
+              onPressed: isLoading ? null : _testTranslation,
+              child: Text('Test Translation'),
+            ),
+            
+            SizedBox(height: 20),
+            
+            // Recording Button
+            GestureDetector(
+              onTap: isLoading ? null : (isRecording ? _stopRecording : _startRecording),
+              child: Container(
+                width: 100,
+                height: 100,
+                decoration: BoxDecoration(
+                  color: isRecording ? Colors.red : Colors.blue,
+                  shape: BoxShape.circle,
+                ),
+                child: Icon(
+                  isRecording ? Icons.stop : Icons.mic,
+                  color: Colors.white,
+                  size: 50,
+                ),
+              ),
+            ),
+            
+            SizedBox(height: 20),
+            
+            if (isLoading)
+              CircularProgressIndicator(),
+            
+            SizedBox(height: 20),
+            
+            Text(
+              result,
+              style: TextStyle(fontSize: 16),
+              textAlign: TextAlign.center,
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  Future<void> _testTranslation() async {
+    setState(() {
+      isLoading = true;
+      result = 'Testing translation...';
+    });
+
+    try {
+      final response = await ApiService.translateText('Hello', 'twi');
+      setState(() {
+        result = 'Translation SUCCESS: ${response['translated_text']}';
+      });
+    } catch (e) {
+      setState(() {
+        result = 'Translation ERROR: $e';
+      });
+    } finally {
+      setState(() => isLoading = false);
+    }
+  }
+
+  Future<void> _startRecording() async {
+    setState(() {
+      isLoading = true;
+      result = 'Starting recording...';
+    });
+
+    try {
+      final path = await SimpleAudioService.startRecording();
+      if (path != null) {
+        setState(() {
+          isRecording = true;
+          result = 'Recording... Tap to stop';
+        });
+      } else {
+        throw Exception('Failed to start recording');
+      }
+    } catch (e) {
+      setState(() {
+        result = 'Recording ERROR: $e';
+      });
+    } finally {
+      setState(() => isLoading = false);
+    }
+  }
+
+  Future<void> _stopRecording() async {
+    setState(() {
+      isLoading = true;
+      result = 'Stopping recording...';
+    });
+
+    try {
+      final path = await SimpleAudioService.stopRecording();
+      setState(() => isRecording = false);
+      
+      if (path != null) {
+        // Try speech to text
+        final response = await ApiService.speechToText(path);
+        setState(() {
+          result = 'Speech-to-Text SUCCESS: ${response['transcribed_text']}';
+        });
+      }
+    } catch (e) {
+      setState(() {
+        isRecording = false;
+        result = 'Speech-to-Text ERROR: $e';
+      });
+    } finally {
+      setState(() => isLoading = false);
+    }
+  }
+}
+```
+
+## 🎯 **IMMEDIATE ACTION:**
+
+1. **Try URL Option A first** in your API service
+2. **Add the dependencies** to pubspec.yaml
+3. **Run** `flutter pub get`
+4. **Add permissions** to AndroidManifest.xml
+5. **Test the quick fix screen**
+
+If Option A doesn't work, try Option B, then Option C.
+
+**This should fix both your 404 and microphone crashes immediately!** 🚀

FIND_CORRECT_URL.md

@@ -0,0 +1,129 @@
+# 🔍 Find Your Correct API URL - 404 Troubleshooting
+
+## 🚨 **Your Space is giving 404 errors - Let's find the right URL!**
+
+### **Step 1: Check Your Space Status**
+
+1. **Go to your Space directly**: https://huggingface.co/spaces/CarsaAI/carsa_api
+2. **Look for these indicators:**
+   - ✅ **"Running"** status (green)
+   - ❌ **"Building"** status (yellow) 
+   - ❌ **"Runtime Error"** status (red)
+   - ❌ **"Stopped"** status (gray)
+
+### **Step 2: If Your Space Shows "Running", Try These URLs:**
+
+#### **URL Format 1:**
+```
+https://carsaai-carsa-api.hf.space
+```
+
+#### **URL Format 2 (with port):**
+```
+https://carsaai-carsa-api.hf.space:7860
+```
+
+#### **URL Format 3 (alternative naming):**
+```
+https://carsa-ai-carsa-api.hf.space
+```
+
+#### **URL Format 4 (proxy path):**
+```
+https://huggingface.co/spaces/CarsaAI/carsa_api/proxy
+```
+
+#### **URL Format 5 (direct embed):**
+```
+https://carsaai-carsa-api.hf.space/health
+```
+
+### **Step 3: Test URLs in Your Browser**
+
+**Open each URL in your browser and look for:**
+
+✅ **Working URL will show:**
+```json
+{
+  "status": "Carsa AI API is running",
+  "version": "1.0.0",
+  "services": ["translation", "speech-to-text", "text-to-speech"]
+}
+```
+
+❌ **404 Error will show:**
+```
+404 - Sorry, we can't find the page you are looking for.
+```
+
+### **Step 4: If ALL URLs Give 404**
+
+Your Space might not be properly deployed. Check these:
+
+#### **A. Check Space Logs:**
+1. Go to: https://huggingface.co/spaces/CarsaAI/carsa_api
+2. Click **"Logs"** tab
+3. Look for errors in the build/runtime logs
+
+#### **B. Common Issues:**
+- **Build Failed**: Space never started properly
+- **Runtime Error**: Space started but crashed
+- **Port Issues**: App running on wrong port
+- **Branch Issues**: Code not on correct branch
+
+#### **C. Force Rebuild:**
+1. Go to your Space settings
+2. Click **"Restart this Space"**
+3. Wait for rebuild to complete
+
+### **Step 5: Alternative URLs to Try**
+
+If the standard format doesn't work, your Space might use:
+
+```
+https://hf.space/carsaai/carsa_api
+https://spaces.huggingface.co/CarsaAI/carsa_api
+https://carsaai-carsa-api.hf.space/gradio_api/health
+```
+
+### **Step 6: Quick Debug Test**
+
+**Test this simple URL in your browser:**
+```
+https://carsaai-carsa-api.hf.space/docs
+```
+
+If this works, you'll see the **FastAPI documentation page**.
+
+### **Step 7: Update Your Flutter App**
+
+Once you find the working URL, update your Flutter `api_service.dart`:
+
+```dart
+class ApiService {
+  // Replace with the URL that works from Step 2-3
+  static const String baseUrl = 'YOUR_WORKING_URL_HERE';
+  
+  // Test translation endpoint
+  static Future<void> testConnection() async {
+    try {
+      final response = await http.get(Uri.parse('$baseUrl/health'));
+      print('✅ Connection test: ${response.statusCode}');
+      print('✅ Response: ${response.body}');
+    } catch (e) {
+      print('❌ Connection failed: $e');
+    }
+  }
+}
+```
+
+---
+
+## 🎯 **IMMEDIATE ACTIONS:**
+
+1. **Check your Space status** at: https://huggingface.co/spaces/CarsaAI/carsa_api
+2. **Try each URL format** in your browser
+3. **Look at Space logs** if all URLs fail
+4. **Report back** which URL works (or if none work)
+
+**Let me know what you see when you check your Space page!** 🔍

asr_engine.py

@@ -179,17 +179,8 @@ class ASREngine:
                 logger.warning("Empty audio array after preprocessing")
                 return ""
             
-            # Perform transcription with optimized settings
-            result = self.transcriber(
-                audio_array,
-                generate_kwargs={
-                    "task": "transcribe",
-                    "language": "english",
-                    "do_sample": False,
-                    "num_beams": 1,
-                    "temperature": 0.0
-                }
-            )
+            # Perform transcription with compatible settings
+            result = self.transcriber(audio_array)
             
             # Extract text from result
             if isinstance(result, dict):

main.py

@@ -109,6 +109,13 @@ def translate_text(request: TranslationRequest):
     if not translation_engine:
         raise HTTPException(status_code=503, detail="Translation Engine not available.")
     
+    # Block Hausa requests (discontinued)
+    if request.target_lang.lower() == "hausa":
+        raise HTTPException(
+            status_code=400, 
+            detail="Hausa translation has been discontinued. Please use Twi, Ga, or Ewe instead."
+        )
+    
     try:
         result = translation_engine.translate(request.text, request.target_lang)
         return {"translated_text": result}

requirements-hf.txt

@@ -5,8 +5,8 @@ python-multipart==0.0.20
 
 # AI/ML libraries
 torch==2.5.1
-transformers==4.48.0
-tokenizers==0.21.0
+transformers==4.44.0
+tokenizers==0.19.1
 accelerate==1.2.1
 
 # Audio processing

t_space_urls.py

@@ -0,0 +1,50 @@
+
+                   SSUUMMMMAARRYY OOFF LLEESSSS CCOOMMMMAANNDDSS
+
+      Commands marked with * may be preceded by a number, _N.
+      Notes in parentheses indicate the behavior if _N is given.
+      A key preceded by a caret indicates the Ctrl key; thus ^K is ctrl-K.
+
+  h  H                 Display this help.
+  q  :q  Q  :Q  ZZ     Exit.
+ ---------------------------------------------------------------------------
+
+                           MMOOVVIINNGG
+
+  e  ^E  j  ^N  CR  *  Forward  one line   (or _N lines).
+  y  ^Y  k  ^K  ^P  *  Backward one line   (or _N lines).
+  ESC-j             *  Forward  one file line (or _N file lines).
+  ESC-k             *  Backward one file line (or _N file lines).
+  f  ^F  ^V  SPACE  *  Forward  one window (or _N lines).
+  b  ^B  ESC-v      *  Backward one window (or _N lines).
+  z                 *  Forward  one window (and set window to _N).
+  w                 *  Backward one window (and set window to _N).
+  ESC-SPACE         *  Forward  one window, but don't stop at end-of-file.
+  ESC-b             *  Backward one window, but don't stop at beginning-of-file.
+  d  ^D             *  Forward  one half-window (and set half-window to _N).
+  u  ^U             *  Backward one half-window (and set half-window to _N).
+  ESC-)  RightArrow *  Right one half screen width (or _N positions).
+  ESC-(  LeftArrow  *  Left  one half screen width (or _N positions).
+  ESC-}  ^RightArrow   Right to last column displayed.
+  ESC-{  ^LeftArrow    Left  to first column.
+  F                    Forward forever; like "tail -f".
+  ESC-F                Like F but stop when search pattern is found.
+  r  ^R  ^L            Repaint screen.
+  R                    Repaint screen, discarding buffered input.
+        ---------------------------------------------------
+        Default "window" is the screen height.
+        Default "half-window" is half of the screen height.
+ ---------------------------------------------------------------------------
+
+                          SSEEAARRCCHHIINNGG
+
+  /_p_a_t_t_e_r_n          *  Search forward for (_N-th) matching line.
+  ?_p_a_t_t_e_r_n          *  Search backward for (_N-th) matching line.
+  n                 *  Repeat previous search (for _N-th occurrence).
+  N                 *  Repeat previous search in reverse direction.
+  ESC-n             *  Repeat previous search, spanning files.
+  ESC-N             *  Repeat previous search, reverse dir. & spanning files.
+  ^O^N  ^On         *  Search forward for (_N-th) OSC8 hyperlink.
+  ^O^P  ^Op         *  Search backward for (_N-th) OSC8 hyperlink.
+  ^O^L  ^Ol            Jump to the currently selected OSC8 hyperlink.
+  ESC-u                Undo (toggle) search highlighting.

translation_engine.py

@@ -8,8 +8,6 @@ Supported Languages:
 - Twi (Akan) - 'twi'
 - Ga - 'ga' 
 - Ewe - 'ewe'
-- Hausa - 'hausa'
-- Yoruba - 'yoruba'
 - Igbo - 'igbo'
 - Swahili - 'swahili'
 - Amharic - 'amharic'
@@ -54,7 +52,8 @@ class TranslationEngine:
             "twi": "Helsinki-NLP/opus-mt-en-tw",
             "ga": "Helsinki-NLP/opus-mt-en-gaa", 
             "ewe": "Helsinki-NLP/opus-mt-en-ee",
-            "hausa": "Helsinki-NLP/opus-mt-en-ha",
+            # Hausa removed - model discontinued
+            # "hausa": "Helsinki-NLP/opus-mt-en-ha",
             # Note: Yoruba model temporarily disabled - no valid model found
             # "yoruba": "Helsinki-NLP/opus-mt-en-yo",  # This model doesn't exist
             "igbo": "Helsinki-NLP/opus-mt-en-ig", 
@@ -68,7 +67,7 @@ class TranslationEngine:
         self.translators = {}
         
         # Load critical models (the ones your Flutter app primarily uses)
-        self.critical_languages = ["twi", "ga", "ewe", "hausa"]
+        self.critical_languages = ["twi", "ga", "ewe"]
         self._load_critical_models()
         
         logger.info("Translation Engine initialized successfully!")