An open source project for realtime translation between multi-african languages
# AfriLingua
**Real-time AI translation for African indigenous languages.**
English ↔ Igbo · Yoruba · Hausa — live speech, documents, and text.
AfriLingua is an open-source project that makes language barriers disappear for speakers of African indigenous languages. Whether you are attending a conference, watching a presentation, or participating in a meeting conducted in English (or in Igbo, Yoruba, or Hausa), AfriLingua provides live transcribed translation on screen and through audio — in real time.
> **Use case:** An Igbo speaker at an English-language conference hears the translated speech in Igbo through their earphones while the original English transcript appears side by side on their screen. An English speaker in the same room gets the reverse — automatic translation of everything said in Igbo, Yoruba, or Hausa.
---
## Features
| Feature | Description |
|---|---|
| **Live conversation** | Speak into a microphone; hear and read the translation in real time |
| **Auto language detection** | Automatically identifies whether speech or text is English, Igbo, Yoruba, or Hausa |
| **Document translation** | Upload `.txt`, `.pdf`, or `.docx` files and download the translated version |
| **Text translation** | Paste or type any text and translate instantly, with optional audio playback |
| **Bidirectional** | Translates both ways: English → native language and native → English |
| **Offline-capable** | All models run locally on CPU — no cloud API required after setup |
| **Fine-tunable** | Built-in data pipeline to collect open corpora and fine-tune the translation model on domain-specific data |
| **Extensible** | Designed so any new language can be added by the community |
---
## Supported Languages
| Language | Code | ASR | TTS | Translation |
|---|---|---|---|---|
| English | `eng_Latn` | Whisper-small | pyttsx3 | NLLB-200 |
| Igbo | `ibo_Latn` | MMS-1B-All | MMS-TTS | NLLB-200 |
| Yoruba | `yor_Latn` | MMS-1B-All | MMS-TTS | NLLB-200 |
| Hausa | `hau_La …