A voice-based intelligent assistant built with ❤️ for Kinyarwanda speakers. This assistant listens to your speech in Kinyarwanda, understands your request using NLP, and replies in natural-sounding Kinyarwanda using TTS. The app features a clean Gradio interface for easy interaction.
# kinyarwanda-voice-assisstant
A voice-based intelligent assistant built with ❤️ for Kinyarwanda speakers. This assistant listens to your speech in Kinyarwanda, understands your request using NLP, and replies in natural-sounding Kinyarwanda using TTS. The app features a clean Gradio interface for easy interaction.
## ⚙️ What the Assistant Does
1. **ASR (Automatic Speech Recognition)** – Transcribes spoken Kinyarwanda audio using a fine-tuned Whisper model.
2. **NLP (Natural Language Processing)** – Understands the transcription and generates a response based on Kinyarwanda logic and phrases.
3. **TTS (Text-to-Speech)** – Converts the response into natural Kinyarwanda speech using gTTS.
4. **UI (User Interface)** – A simple and friendly interface built with Gradio.
---
## 🚀 How to Run the Project
### 1. Clone the repository
```bash
git clone
github.com
cd kinyarwanda-voice-assisstant
```
### 2. Install packages
```bash
pip install -r requirements.txt
```
### 3. Run voice assisstant
```bash
py main.py
```
Developed by ISHIMWE Angela Lorie🤓