# Supertonic 3 — Demo Locale

Demo locale di **Supertonic 3**, un motore TTS on-device da ~99M parametri con supporto a **31 lingue** (italiano incluso). Gira su **CPU**, senza GPU.

## Servizi

| Servizio | Porta | Descrizione |
|---|---|---|
| Demo Gradio | `0.0.0.0:7860` | Interfaccia web per test rapidi |
| Server HTTP | `0.0.0.0:7788` | API REST + endpoint OpenAI-compatibile |

## Avvio rapido

```bash
source .venv/bin/activate
ORT_DISABLE_CPU_THREAD_AFFINITY=1

# Demo Gradio (B)
python app.py

# Server HTTP (C)
supertonic serve --host 0.0.0.0 --port 7788
```

## Screenshot

Apri http://localhost:7860 per l'interfaccia Gradio o http://localhost:7788/docs per la documentazione API.

## API HTTP

**Endpoint OpenAI-compatibile:**
```bash
curl -X POST http://localhost:7788/v1/audio/speech \
  -H "Content-Type: application/json" \
  -d '{"model": "supertonic-3", "input": "Ciao mondo!", "voice": "M1"}' \
  -o output.wav
```

**Endpoint nativo:**
```bash
curl -X POST http://localhost:7788/v1/tts \
  -H "Content-Type: application/json" \
  -d '{"text": "Ciao mondo!", "lang": "it", "voice_style": "M1"}' \
  -o output.wav
```

## Lingue supportate (31)

Arabo, Bulgaro, Croato, Ceco, Danese, Olandese, Inglese, Estone, Finlandese, Francese, Tedesco, Greco, Hindi, Ungherese, Indonesiano, **Italiano**, Giapponese, Coreano, Lettone, Lituano, Polacco, Portoghese, Rumeno, Russo, Slovacco, Sloveno, Spagnolo, Svedese, Turco, Ucraino, Vietnamita

Usa `lang="na"` per modalità language-agnostic.

## Voci preset

Maschili: M1–M5 · Femminili: F1–F5

## Installazione

```bash
python -m venv .venv
source .venv/bin/activate
pip install supertonic gradio
# Per il server HTTP:
pip install 'supertonic[serve]'
```

## Crediti

- Modello: [Supertone Inc.](https://github.com/supertone-inc/supertonic) (MIT + OpenRAIL-M)
- Demo originale: [Francesco Gruner](https://francescogruner.it/supertonic-tts-voce-ai-italiano-windows/)