xtts-ug-lang

XTTS Ugandan Languages (xtts-ug-lang)

This model is a fine-tuned version of Coqui's XTTS-v2 designed to support multiple Ugandan languages.

Supported Languages

The model was trained with special language tokens natively injected into the vocabulary:

• Luganda ([lg])
• Acholi ([ach])
• Masaaba ([mas])
• Runyankore ([nyn])
• Soga ([sog])
• Ugandan English ([en-ug])

Dataset

Trained on the reuben256/votex-v1 dataset comprising over 248 hours of high-quality speech data.

Training Details

• Fine-tuned using the XTTS GPT trainer.
• The base model's embedding matrices were successfully patched and resized to support the new vocabulary IDs.

Usage

To use this with the standard Coqui TTS library, download the repository and load it locally. Make sure you use the patched config.json and vocab.json included in this repository.

Because the underlying library has strict language validation, you should set language="en" in the API call but include your specific language token (e.g., [lg]) directly inside the text string.

Python Example

from TTS.api import TTS

# 1. Download the repo and set the paths to the local directory
model_dir = "./xtts-ug-lang"
config_path = f"{model_dir}/config.json"

# 2. Initialize the TTS API
tts = TTS(
    model_path=model_dir,
    config_path=config_path
)

# 3. Generate Audio
# Pass language="en" to bypass strict checks, but prepend the real language tag to the text.
text_to_speak = "[lg] Ekiseera kino kyamagero."

tts.tts_to_file(
    text=text_to_speak,
    speaker_wav="path/to/reference/speaker.wav", # Your reference audio for voice cloning
    language="en",
    file_path="output.wav"
)
print("Audio generated successfully!")