README.md

🗣️ Kinyarwanda Voice Assistant 🇷🇼

This project is a voice assistant for the Kinyarwanda language using OpenAI's Whisper model. It allows users to transcribe audio into text, making speech-to-text accessible for Kinyarwanda speakers.

📌 Features

• 🔊 Load and process audio files
• 🧠 Transcribe Kinyarwanda speech using a fine-tuned Whisper model
• 📝 Simple, lightweight, and easy to extend

🛠️ Tech Stack

• Python 3.12+
• PyTorch
• torchaudio
• HuggingFace Transformers
• Whisper model (benax-rw/KinyaWhisper)

🚀 Getting Started

1. Clone the repo

git clone https://github.com/your-username/kinyarwanda-voice-assistant.git
cd kinyarwanda-voice-assistant

2. Install the dependencies

pip install -r requirements.txt

3. Run the application

cd app
python assistant.py

👉🏾 Please make sure you are connected to a stable internet as the model requires heavy dependencies.

Credits

• Model by https://github.com/benax-rw