Skip to content

Add standalone notebook for TTS inference (Python 3.10+ / Coqui-TTS v0.22)#8

Merged
agent87 merged 2 commits intoagent87:mainfrom
osinkolu:main
Feb 13, 2026
Merged

Add standalone notebook for TTS inference (Python 3.10+ / Coqui-TTS v0.22)#8
agent87 merged 2 commits intoagent87:mainfrom
osinkolu:main

Conversation

@osinkolu
Copy link
Contributor

@osinkolu osinkolu commented Feb 6, 2026

Summary

I've added a standalone Jupyter Notebook (Digital_Umuganda_TTS_Inference_Tutorial.ipynb) that allows users to run the Kinyarwanda TTS model in modern environments, such as Google Colab or local Python 3.10+ setups.

Problem

The current repository setup relies on older dependencies (specifically a 2021 commit of coqui-tts) that do not compile easily on newer Python versions. Running the model with the latest coqui-tts library normally causes crashes due to:

  1. Config Mismatches: Missing keys like output_sample_rate and phoneme_language.
  2. Path Errors: Hardcoded local paths in the original config.json.
  3. Runtime Errors: A logic conflict in newer library versions where the speaker embedding is dropped if use_d_vector_file is set to True during inference.

Solution

This notebook provides a "one-click" solution that:

  • Automates Setup: Handles git lfs pull and installs modern dependencies.
  • In-Memory Patching: Fixes the configuration errors dynamically without modifying the existing config.json on disk (preserving the original repo structure).
  • Runtime Fix: Includes a runtime patch to force the model to accept speaker embeddings, resolving the crash in modern Coqui-TTS versions.

Tested successfully on Google Colab.

@agent87 agent87 self-assigned this Feb 13, 2026
@agent87 agent87 merged commit 65ad0ff into agent87:main Feb 13, 2026
1 of 4 checks passed
@agent87
Copy link
Owner

agent87 commented Feb 13, 2026

Thank you @osinkolu for the contribution.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants