Dieudonne-Ibikoraneza/kinyarwanda-voice-assistant

# 🗣️ Kinyarwanda Voice Companion A lightweight, AI-powered voice assistant built specifically for Kinyarwanda speakers. This tool enables seamless voice interaction by converting spoken language into text, understanding the query, and responding with lifelike speech. --- ## 🚀 What This Project Does This assistant is designed to support **end-to-end voice communication** in Kinyarwanda. The system enables you to: - 🎙️ Speak naturally in Kinyarwanda - 🧠 Get meaningful responses via AI or rule-based logic - 🔊 Hear back clear Kinyarwanda speech in real-time Whether you're building a localized chatbot, learning language tech, or experimenting with voice AI, this project serves as a flexible foundation. --- ## ✨ Key Capabilities | Feature | Description | |----------------------|-----------------------------------------------------------------------------| | 🎧 Voice Recognition | Translates Kinyarwanda speech into text using pre-trained acoustic models | | 🤖 NLP Engine | Understands the user's intent using hybrid logic (rule-based + GPT) | | 🔈 Voice Synthesis | Responds in fluent, natural Kinyarwanda using TTS technology | | 🌐 Web Interface | Launches an interactive UI powered by Gradio | | 💬 Custom Responses | Supports intent-specific, predefined answers for faster interaction | --- ## 🧠 How It Works graph TD A[🎙️ User Speaks] --> B[STT Engine - Transcribe Speech] B --> C[NLP Module - Understand Intent] C --> D[Response Generation - Rule or GPT] D --> E[TTS Engine - Synthesize Speech] E --> F[🔊 Audio Output] 🛠 Installation Guide ⚙️ Requirements Python 3.8 or later GPU (for TTS performance, optional) pip 🔧 Setup Steps # Clone your version ```bash git clone github.com``` ```cd kinyarwanda-voice-companion``` # Install dependencies ```pip install …