README.md

metadata

title: Tiny Code-Only TTS
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.23.0
app_file: app.py
pinned: false

Tiny Code-Only TTS for Hugging Face Spaces

This project builds a simple text-to-speech system from code only.

• No API key
• No external model
• No pretrained checkpoint
• Pure Python waveform synthesis
• Gradio UI for Hugging Face Spaces

What it does

It converts text into robotic speech audio using a lightweight phoneme-style synthesizer. The engine uses handcrafted sound rules for vowels, fricatives, stops, nasals, liquids, and pauses.

This is a starter TTS project for deployment and experimentation. It is intentionally simple and CPU-friendly.

Project structure

.
├── app.py
├── requirements.txt
└── mini_tts/
    ├── __init__.py
    ├── config.py
    ├── normalizer.py
    ├── service.py
    └── synth.py

Run locally

pip install -r requirements.txt
python app.py

Deploy on Hugging Face Spaces

1. Create a new Space.
2. Choose Gradio.
3. Upload these files.
4. Space will install requirements.txt.
5. Open the app and generate speech directly from text.

Notes

• The voice is synthetic and simple by design.
• You can tune pitch, speed, and voice color in the UI.
• You can extend phoneme rules in mini_tts/synth.py.