# 🗣️ 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 …