Voice Server - Discord voice integration server
- User service file for ~/.config/systemd/user/ - Restarts on failure with 5s delay - Logs to journald Install with: cp voice-server.service ~/.config/systemd/user/ systemctl --user daemon-reload systemctl --user enable --now voice-server 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| app | ||
| tests | ||
| .env.example | ||
| .gitignore | ||
| PRD.md | ||
| PROJECT_ROADMAP.json | ||
| pyproject.toml | ||
| README.md | ||
| voice-server.service | ||
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 playbackGET /health- Health check endpointGET /voices- List available voice modelsGET /docs- OpenAPI documentation
Configuration
See .env.example for configuration options.
License
MIT