Voice Server

Local HTTP service for text-to-speech playback using Piper TTS.

Features

• HTTP POST endpoint for text-to-speech requests
• High-quality neural TTS using Piper
• Non-blocking audio playback with sounddevice
• Async request queue for concurrent handling
• Automatic OpenAPI documentation

Quick Start

# Install dependencies
uv pip install -e ".[dev]"

# Run server
uvicorn app.main:app --reload

# Test endpoint
curl -X POST http://localhost:8000/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, world!"}'

API Endpoints

• POST /notify - Submit text for TTS playback
• GET /health - Health check endpoint
• GET /voices - List available voice models
• GET /docs - OpenAPI documentation

Configuration

See .env.example for configuration options.

License

MIT