Metadata-Version: 2.4
Name: f5-myanmar-tts
Version: 0.2.0
Summary: Official Python API and CLI for F5-TTS Burmese (794.5h Pretrained Foundation Model)
Author: freococo
License: CC-BY-NC-4.0
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: torch
Requires-Dist: torchaudio
Requires-Dist: f5-tts
Requires-Dist: vocos
Requires-Dist: huggingface_hub
Requires-Dist: soundfile

# f5-myanmar-tts 🇲🇲

Official Python library and CLI for the **F5-TTS Burmese Foundation Model** (794.5 hours of Burmese speech, 20 epochs / 569,780 steps).

Automatically downloads and caches model weights directly from Hugging Face: [`freococo/F5-Myanmar-TTS`](https://huggingface.co/freococo/F5-Myanmar-TTS).

---

## ⚡ Quickstart (CLI)

```bash
# Speak any Burmese sentence with bundled voice
f5-myanmar "လူတွေ အားလုံးကို ချစ်မြတ်နိုးပါ တန်ဖိုးထားပါ လေးစားစွာ ဆက်ဆံပါ" -o output.wav

# Clone your own voice (3 to 5 seconds of audio)
f5-myanmar "မင်္ဂလာပါ ခင်ဗျာ" --ref-audio my_voice.wav --ref-text "ကျွန်တော် မောင်မောင်ပါ" -o custom.wav
```

---

## 🐍 Python API (Just 3 lines!)

```python
from f5_myanmar_tts import MyanmarTTS

# Auto-downloads model on first run!
tts = MyanmarTTS()

# Generate Burmese speech
tts.speak(
    "လူတွေ အားလုံးကို ချစ်မြတ်နိုးပါ တန်ဖိုးထားပါ လေးစားစွာ ဆက်ဆံပါ", 
    output_file="speech.wav"
)
```

### Advanced Voice Cloning:
```python
tts.speak(
    text="စိတ်ချမ်းသာ ကိုယ်ကျန်းမာ ရှိကြပါစေ",
    ref_audio="my_reference.wav",
    ref_text="ဒါက ကျွန်တော့်အသံပါ",
    output_file="clone.wav",
    speed=1.0
)
```

---

## 📜 License & Dedication
Released under **CC BY-NC 4.0** for free research, cultural preservation, education, and open-source innovation.  
Base model powered by [F5-TTS](https://github.com/SWivid/F5-TTS) and [Vocos](https://huggingface.co/charactr/vocos-mel-24khz).
