serverlisted

# Kokoro TTS Server Manage the Kokoro TTS HTTP server — an OpenAI-compatible `/v1/audio/speech` endpoint on localhost:8779. > **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues. ## Server Overview The server provides: - `GET /health` — Health status JSON - `GET /v1/models` — List available models - `POST /v1/audio/speech` — Synthesize text to audio (WAV, MP3, Opus, PCM) ## Quick Start ### Start (foreground, for testing) ```bash ~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_server.py ``` ### Start (launchd, for production) Per the macOS launchd policy, the launchd plist must launch a compiled Swift binary (not a bash script). Guide the user through: 1. Compile Swift launcher binary 2. Create launchd plist at `~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist` 3. Bootstrap: `launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist` ### Stop ```bash launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist ``` ### Verify ```bash curl -s http://127.0.0.1:8779/health | python3 -m json.tool ``` Expected: `{"status": "ok", "provider": "kokoro-tts-mlx", "model": "mlx-community/Kokoro-82M-bf16", "device": "mlx-metal"}` ## Environment Variables | Variable | Default | Purpose | | -