tizah/speech_ai_naija

NaijaVoice is a web-based voice customer support bot that allows Nigerian users to speak their questions in **Hausa**, **Yoruba**, **Igbo**, or **Fulani** and receive AI-powered voice responses in their language. # NaijaVoice — Multilingual Voice Customer Support Bot NaijaVoice is a web-based voice customer support bot that allows Nigerian users to speak their questions in **Hausa**, **Yoruba**, **Igbo**, or **Fulani** and receive AI-powered voice responses in their language. ## How It Works 1. **Speak** a question in your language 2. **Transcription** via Whisper (fine-tuned for African languages) 3. **AI Response** from Gemini 2.0 Flash (with Nigerian cultural context) 4. **Voice Reply** spoken back in your language via Google Cloud TTS ## Tech Stack - **Frontend:** Next.js 14, TypeScript, Tailwind CSS, Zustand, TanStack Query - **Backend:** FastAPI, Whisper Large v3, Gemini 2.0 Flash, Google Cloud TTS ## Getting Started ### Backend ```bash cd backend python -m venv venv && source venv/bin/activate pip install -r requirements.txt uvicorn main:app --reload --port 8000 ``` ### Frontend ```bash cd frontend npm install npm run dev ``` ### With Docker ```bash docker-compose up --build ``` ## Supported Languages | Language | Code | Region | |----------|------|--------| | Hausa | `ha` | North | | Yoruba | `yo` | Southwest | | Igbo | `ig` | Southeast | | Fulani | `ff` | North | | English | `en` | Fallback |