README.md

---
title: VoxStudio
emoji: 🎙️
colorFrom: yellow
colorTo: red
sdk: docker
pinned: false
---

# 🎙️ VoxStudio — AI Text-to-Speech

Offline-capable AI TTS supporting **English** and **Hindi (हिंदी)**, powered by [Piper TTS](https://github.com/rhasspy/piper).

> Voice models (~60 MB each) download automatically on first use.

## 🗣️ Voices

### Hindi (हिंदी)
| Voice | Gender |
|---|---|
| Rohan | ♂ Male |
| Pratham | ♂ Male |
| Priyamvada | ♀ Female |

### English
| Voice | Gender | Accent | Quality |
|---|---|---|---|
| Lessac | ♂ Male | US | Medium |
| Ryan | ♂ Male | US | High |
| Joe | ♂ Male | US | Medium |
| Amy | ♀ Female | US | Medium |
| Kristin | ♀ Female | US | Medium |
| Alan | ♂ Male | British | Medium |
| Jenny | ♀ Female | British | Medium |

## 🚀 Deploy to HuggingFace Spaces

```bash
# 1. Create a new Space on huggingface.co/new-space
#    → Select "Docker" as the SDK template

# 2. Clone your new empty space
git clone https://huggingface.co/spaces/<your-username>/voxstudio
cd voxstudio

# 3. Copy all project files in, then push
git add .
git commit -m "🎙️ Initial VoxStudio deployment"
git push
```

## 🏃 Run Locally

```bash
pip install -r requirements.txt
python app.py
# Open: http://localhost:7860
```

## 🛠 Stack
- **TTS**: [Piper TTS](https://github.com/rhasspy/piper)
- **Models**: [rhasspy/piper-voices](https://huggingface.co/rhasspy/piper-voices)
- **Backend**: Flask · **Deploy**: Docker