MIYUPPIE/Multilingual-Voice-Assistant

A powerful, culturally-aware AI voice assistant that speaks Yoruba, Hausa, and Igbo using advanced technologies. # 🌍 Multilingual Voice Assistant A powerful, culturally-aware AI voice assistant that speaks **Yoruba**, **Hausa**, and **Igbo** using advanced technologies: - **🗣️ Speech Recognition**: OpenAI Whisper - **🧠 Language Understanding**: OpenAI GPT + YarnGPT - **🔊 Speech Synthesis**: pyttsx3 - **🎯 Cultural Context**: YarnGPT-style prompt engineering ## ✨ Features ✅ **Real-time Voice Interaction** - Speak in your native language ✅ **Multi-language Support** - Yoruba, Hausa, Igbo ✅ **Cultural Awareness** - Context-aware responses ✅ **Conversation Memory** - Maintains chat history ✅ **Easy Setup** - Automated installation scripts ✅ **Production Ready** - Error handling & logging ## 🚀 Quick Start ### Prerequisites - Python 3.8+ - FFmpeg - OpenAI API Key (get one free) ### Installation ```bash # Clone/navigate to project cd /path/to/multilang # Automatic setup (recommended) python setup.py # OR manual setup python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt cp .env.example .env ``` **Then add your OpenAI API key to `.env`:** ```env OPENAI_API_KEY=sk-your-api-key-here ``` ### Usage ```bash # Interactive mode - choose language python main.py --language yoruba # Other languages python main.py --language hausa python main.py --language igbo # Test mode python main.py --test ``` ## 🎯 How It Works ``` User speaks → Whisper transcribes → YarnGPT enhances → GPT responds → pyttsx3 speaks back → User hears response ``` ### Example Interaction ``` 🎤 Recording for 10 seconds... Speak now! ✓ Recording complete 🎙️ Transcribing audio in Yorùbá... ✓ Transcribed text: Bawo ni o? 🤖 Generating response in Yorùbá (YarnGPT-enhanced)... ✓ Response generated: Ọ dàa... [culturally appropriate response] 🔊 Speaking in Yorùbá: [Audio plays] ``` ## 🌐 Supported Languages | Language | Code | Greeting | Region | |----------|------|----------|--------| | **Yoruba** | `yoruba` | Báwo ni? | Nigeria | | **Hausa** | `hausa` …