README.md

---
title: EG Autonomous TTS Studio
emoji: "🎙️"
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
license: mit
short_description: Enterprise text-to-speech studio with Edge neural voices.
---

# EG Autonomous TTS Studio

Production-ready Text-to-Speech Space powered by FastAPI, with a branded web interface and dual synthesis modes:

- `translate`: fast Google Translate TTS URL generation + proxy playback
- `edge`: high-quality MP3 generation via Microsoft Edge TTS voices

## Features

- Professional EG AUTONOMOUS branded UI
- Instant audio playback in-browser
- Language and provider switching
- Voice catalog loading for Edge TTS
- Long-text chunking for Translate TTS
- JSON API output for direct app integration

## Project Structure

- `app.py`: FastAPI application entrypoint
- `tts_engine.py`: Edge TTS engine helpers and CLI utilities
- `templates/index.html`: UI template
- `static/app.css`: branded styles
- `static/app.js`: frontend logic and API integration
- `Dockerfile`: Space runtime configuration
- `requirements.txt`: Python dependencies

## API Endpoints

### Health

`GET /health`

### Bootstrap data

`GET /api/bootstrap`

Returns defaults, providers, and network information for the UI.

### Translate URL

`GET /api/translate-url?text=Hello&tl=en`

Returns:
- `directUrl`
- `proxyUrl`
- `segments`

### Translate audio proxy

`GET /api/translate-audio?text=Hello&tl=en`

Returns playable audio bytes for embedding in `<audio>`.

### Voice catalog (Edge)

`GET /api/voices?filter=en-US`

Returns available voice options filtered by locale or name.

### Synthesize

`POST /api/synthesize`

Translate mode:

```json
{
  "provider": "translate",
  "text": "Hello from EG Autonomous",
  "lang": "en",
  "slow": false
}
```

Edge mode:

```json
{
  "provider": "edge",
  "text": "Hello from EG Autonomous",
  "voice": "en-US-AriaNeural",
  "rate": "+0%",
  "volume": "+0%",
  "pitch": "+0Hz"
}
```

## Local Development

```bash
pip install -r requirements.txt
uvicorn app:app --host 0.0.0.0 --port 7860
```

Open:

`http://127.0.0.1:7860`

## Deployment Notes (Hugging Face Spaces)

- Space SDK: `docker`
- Port: `7860`
- Build source: repository `Dockerfile`

No runtime git clone is required. The repository itself is the deployment source.