This is kinyarwanda AI ASSISTANT
# Kinyarwanda_Voice_AI 🇷🇼
Kinyarwanda Voice Assistant - A locally-run AI assistant that understands and speaks Kinyarwanda. Features speech recognition (STT), natural language processing, and text-to-speech (TTS) with Gradio web interface. Ideal for Rwandan developers, researchers, and language preservation efforts.
Demo Screenshot
## Features ✨
- 🎙️ Speech-to-text for Kinyarwanda using NeMo Conformer model
- 🔊 Text-to-speech with custom KinyaTTS VITS2 model
- 💬 Natural language processing for question answering
- 🖥️ Gradio web interface with:
- Microphone recording
- Audio file upload
- Automatic response playback
- 🌐 Ready for deployment
## Installation 🛠️
### Prerequisites
- Python 3.8 or higher
- pip package manager
- (Optional) NVIDIA GPU for faster inference
### Setup
1. Clone the repository:
```bash
git clone
github.com
cd KINY-AI-ASSISTANT-
```
2. Create venv
```bash
python -m venv kinya-venv
```
Then activate it
3. Install dependencies:
```bash
pip install -r requirements.txt
```
4. Download models (automatic on first run):
```bash
ASR: mbazaNLP/Kinyarwanda_nemo_stt_conformer_model
TTS: Pre-trained KinyaTTS model
```
### Usage 🚀
Running the Web Interface
```bash
python interface.py
```
The interface will launch at:
```bash
localhost
```
Using the Assistant
Speak or upload audio in Kinyarwanda
The assistant will:
- Transcribe your speech
- Generate an appropriate response
- Speak back the response
### Project Structure 📂
```bash
.
├── interface.py # Gradio interface
├── assistant.py # Main assistant pipeline
├── stt_module.py # Speech-to-text processing
├── tts_module.py # Text-to-speech synthesis
├── nlp_module.py # Natural language processing
├── audio_samples/ # Example audio files
├── outputs/ # Generated response audio
└── requirements.txt # Dependencies
```
### Requirements
```bash
gradio>=3.0
torch>=1.10
tor …