README.md

---
title: ActualTTS (Piper CLI, CPU)
emoji: 🗣
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# ActualTTS (Piper CLI, CPU)

FastAPI wrapper around the *Piper* TTS CLI for CPU-only synthesis.  
Voices are cached under a writable dir and can be provisioned via API.

## Endpoints

### Health
GET /health → engine info, available voices, cache dirs

### Provision
POST /provision  
Body: {"voice":"en_US-amy-medium"}  
Downloads the ONNX + JSON for the requested voice if missing.

### Make WAV (JSON → URL)
POST /speak  
Body:
```json
{
  "text": "Hello",
  "voice": "en_US-lessac-high",
  "length_scale": 1.08,
  "noise_scale": 0.35,
  "noise_w": 0.90
}