mohammedaly22/VoiceTut-TTS
<div align="center">
<img src="https://raw.githubusercontent.com/MohammedAly22/VoiceTuT-TTS/main/assets/VoiceTut-TTS-Banner.png" alt="VoiceTut-TTS" width="100%" />
๐น VoiceTut-TTS
An Open-Source Text-to-Speech Model for Egyptian Arabic & Code-Switching
      
VoiceTut-TTS is an Egyptian-Arabic text-to-speech model fine-tuned from OmniVoice on ~380 hours of Egyptian podcast speech. It produces natural Egyptian speech with seamless Arabic โ English code-switching, ships 17 built-in studio voices, supports zero-shot voice cloning, and includes a robust Egyptian-Arabic text normalization pipeline plus true streaming for long text.
</div>
Why "VoiceTut"? Tut โ after the boy-king Tutankhamun (ุชูุช ุนูุฎ ุขู ูู) โ anchors the model in Egyptian identity, just as our companion ASR model [QwenCleo-ASR](https://github.com/MohammedAly22/qwencleo-asr) is named after Cleopatra. Together they form an Egyptian speech stack: Cleo listens, Tut speaks. ๐๏ธ๐ฃ๏ธ
๐ Links
- ๐ง Audio demo (VoiceTut vs. base OmniVoice): https://mohammedaly22.github.io/VoiceTuT-TTS/
- ๐ Interactive Space: https://huggingface.co/spaces/mohammedaly22/VoiceTut-TTS
- ๐ป GitHub (code, notebooks): https://github.com/MohammedAly22/VoiceTuT-TTS
- ๐ฆ PyPI: https://pypi.org/project/voicetut-tts/
โจ Features
- ๐ฏ Egyptian-first โ fine-tuned specifically on Egyptian Arabic, not generic MSA.
- ๐ Code-switching โ handles real Arabic + English mixed speech (
ุนูุฏู meeting ุจูุฑุฉ). - ๐ฃ๏ธ 17 built-in voices โ male & female studio speakers, each with style tags.
- ๐งฌ Zero-shot cloning โ clone any voice from a few seconds of reference audio.
- ๐ข Robust normalization โ numbers, dates, times, currencies, phones, emails, URLs, abbreviations + diacritics & name dictionaries.
- โก True streaming โ long text is split into sentences and yielded as audio chunks.
๐ฆ Installation
# PyTorch matching your CUDA (see https://pytorch.org)
pip install torch --index-url https://download.pytorch.org/whl/cu121
# OmniVoice backbone (not on PyPI โ install from GitHub)
pip install git+https://github.com/k2-fsa/OmniVoice.git
pip install voicetut-tts๐ Usage
from voicetut_tts import VoiceTutTTS
tts = VoiceTutTTS.from_pretrained("mohammedaly22/VoiceTut-TTS")
# 1) Built-in speaker
tts.synthesize("ุงุฒูู ุนุงู
ู ุงูู ุงูููุงุฑุฏุฉุ", speaker="Mohamed", output="out.wav")
# 2) Zero-shot voice cloning
tts.synthesize("ุงูููุงุฑุฏู ุงูุฌู ุญูู ุงูู",
ref_audio="my_voice.wav", ref_text="ุฏู ุงูุตูุช ุจุชุงุนู", output="clone.wav")
# 3) Code-switching + generation params
tts.synthesize("ุนูุฏู meeting ุงูุณุงุนุฉ 3:30 ูู
ุนุงูุง ุงู presentation",
speaker="Asmaa", num_step=48, guidance_scale=2.5, speed=1.05, output="cs.wav")Streaming long text:
for sr, chunk in tts.stream(long_paragraph, speaker="Sayed"):
play(chunk) # plays each sentence as it's generated
tts.synthesize_long(long_paragraph, "long.wav", speaker="Sayed")๐ฃ๏ธ Built-in Voices
Each voice ships with a reference clip + Arabic style tags (e.g. ุดุจุงุจู, ุญููู, ูุงุฏู). Browse and listen in the Space.
๐ Performance
Measured on a single NVIDIA T4 (Colab),float16,num_step=32. Reproduce with `examples/04_evaluation.ipynb`.
On A100 / H100 expect markedly lower RTF and TTFA.
๐๏ธ Training
- Base model: k2-fsa/OmniVoice (Qwen3-0.6B text backbone + Higgs audio tokenizer)
- Data: ~380 h Egyptian-Arabic YouTube podcasts (
language_id = arz) - Steps: 20,000 ยท LR: 3e-5 ยท bf16
โ ๏ธ Responsible Use
Voice cloning is provided to enable beneficial use cases โ voice assistants, accessibility, educational and creative content. Do not use it to impersonate real people, produce deceptive or misleading audio, or harm, harass, or defraud anyone. Always obtain consent before cloning a real person's voice, and disclose synthetic audio where appropriate.
๐ License & Citation
Apache-2.0.
@software{voicetut_tts_2026,
author = {Mohammed Aly},
title = {VoiceTut-TTS: Egyptian Arabic & Code-Switching Text-to-Speech},
year = {2026},
url = {https://github.com/MohammedAly22/VoiceTuT-TTS},
note = {Fine-tuned from OmniVoice}
}