| --- |
| license: other |
| language: |
| - ha |
| tags: |
| - text-to-speech |
| - xtts |
| - hausa |
| - coqui |
| library_name: coqui-tts |
| --- |
| |
| # XTTS-v2 Hausa — multi-speaker (3 speakers, 10 epochs) |
|
|
| Fine-tuned [Coqui XTTS-v2](https://huggingface.co/coqui/XTTS-v2) for Hausa (`ha`), trained on |
| `vaghawan/hausa-tts-24khz-waxalnlp-3-clean`, `vaghawan/hausa-tts-24khz-waxalnlp-5-clean`, `vaghawan/hausa-tts-24khz-naijavoices-O0456`. |
|
|
| ## Files |
|
|
| | File | Purpose | |
| |------|---------| |
| | `best_model.pth` | Fine-tuned GPT checkpoint (epoch 10) | |
| | `config.json` | Model config (includes Hausa language) | |
| | `vocab.json` | Extended Hausa BPE vocabulary | |
| | `references/hausa_fe_waxal_nlp_3.wav` | Speaker reference for `hausa_fe_waxal_nlp_3` | |
| | `references/hausa_fe_waxal_nlp_5.wav` | Speaker reference for `hausa_fe_waxal_nlp_5` | |
| | `references/hausa_fe_naijavoices_O0456.wav` | Speaker reference for `hausa_fe_naijavoices_O0456` | |
| | `infer.py` | Inference script | |
| | `xtts_hausa_patch.py` | Required Hausa runtime patches | |
| | `env_config.py` | Config loader | |
| | `config.env.example` | Example settings (copy to `config.env`) | |
| | `samples.txt` | Default eval sentences | |
| | `requirements.txt` | Python dependencies | |
|
|
| ## Quick start |
|
|
| ```bash |
| pip install -r requirements.txt |
| cp config.env.example config.env |
| |
| python infer.py --model-dir . --speaker-wav references/hausa_fe_waxal_nlp_3.wav |
| |
| # Single line: |
| python infer.py --model-dir . --text "Ina kwana." --speaker-wav references/hausa_fe_waxal_nlp_3.wav --out outputs/out.wav |
| ``` |
|
|
| # All speakers (one WAV per reference): |
| python infer.py --model-dir . --all-speakers --out-dir outputs/samples |
|
|
| ## Training details |
|
|
| - Base model: Coqui XTTS-v2 |
| - Epochs: 10 |
| - Language: Hausa (`ha`) |
| - Speakers: `hausa_fe_waxal_nlp_3`, `hausa_fe_waxal_nlp_5`, `hausa_fe_naijavoices_O0456` |
|
|
| ## License |
|
|
| XTTS-v2 uses the [Coqui Public Model License](https://huggingface.co/coqui/XTTS-v2). |
| Check each dataset license before redistribution. |
|
|
