Jean-Aime-2025/kinyarwanda_voice_assistant
Domaine:
natural language processingType de record:
software
Créateur:
Jea
Hôte:
# 🗣️ Kinyarwanda Voice Assistant
This is an open-source voice assistant for the Kinyarwanda language, featuring automatic speech recognition (ASR), natural language understanding (NLU), and text-to-speech (TTS). It allows users to ask questions in Kinyarwanda and get spoken responses.
---
## 🚀 Features
- **ASR with KinyaWhisper** – Converts spoken Kinyarwanda into text using a Whisper model fine-tuned for the language.
- **NLU with simple NLP matching** – Finds best-matching answers from a local Q&A database using fuzzy string matching.
- **TTS with Coqui TTS** – Synthesizes responses in natural-sounding speech.
- **Local audio playback** – Works on Windows, macOS, and Linux.
---
## 🧰 Technologies Used
- Python 3.8+
- HuggingFace Transformers
- Torchaudio
- Coqui TTS
- Git & GitHub
---
## 📁 Project Structure
---
## 🛠️ Setup Instructions
### 1. Clone the Repository
```bash
git clone github.com
cd kinya-voice-assistant
kinya-voice-assistant/ ├── data/ │ └── qa_pairs.json # Q&A knowledge base ├── audio/ │ └── response.wav # Generated speech ├── src/ │ ├── asr.py # Audio-to-text using KinyaWhisper │ ├── nlp.py # Text matching and response selection │ ├── ttls.py # Text-to-speech using Coqui TTS │ └── main.py # Main script ├── requirements.txt # Dependencies └── README.md # This file
yaml
Copy
Edit
---
## 🛠️ Setup Instructions
### 1. Clone the Repository
```bash
git clone github.com
cd kinya-voice-assistant
```
## 2. Create Virtual Environment
```bash
python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
```
## 3. Install Dependencies
```bash
pip install -r requirements.txt
```
### If you haven’t installed Coqui TTS yet:
```bash
pip install TTS
```
## 🧪 How to Run
Place a 16kHz WAV file in the project folder
Update the path in main.py if needed.
#### Run:
``` bash
python src/main.py
```
The assistant will transcribe t …