Skill

server

Start/stop Kokoro TTS HTTP server. TRIGGERS - start tts server, kokoro server, tts http, stop tts server.

Install

Run in your terminal

npx claudepluginhub terrylica/cc-skills --plugin kokoro-tts

Tool Access

This skill is limited to using the following tools:

ReadWriteEditBashGlobAskUserQuestion

Supporting Assets

View in Repository

references/server-api.md

references/service-management.md

Skill Content

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

138.6k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

cost-optimization

1 file

Optimizes cloud costs on AWS, Azure, GCP via rightsizing, tagging strategies, reserved instances, spot usage, and spending analysis. Use for expense reduction and governance.

cloud-infrastructure

33.0k

Stats

Parent Repo Stars28

Parent Repo Forks4

Last CommitApr 1, 2026

Actions

View Source View Plugin View on GitHub View README

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)

~/.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:

Compile Swift launcher binary
Create launchd plist at ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist
Bootstrap: launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist

Stop

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist

Verify

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
`KOKORO_SERVER_PORT`	`8779`	Listen port
`KOKORO_SERVER_HOST`	`127.0.0.1`	Bind address
`KOKORO_DEFAULT_VOICE`	`af_heart`	Default voice
`KOKORO_DEFAULT_LANG`	`en-us`	Default language
`KOKORO_DEFAULT_SPEED`	`1.0`	Speech speed (0.1–5.0)
`KOKORO_PLAY_LOCAL`	`0`	Play via afplay

Troubleshooting

Issue	Cause	Solution
Port already in use	Another server running	`lsof -i :8779` to find, kill it
Model load fails	Not installed	Run `/kokoro-tts:install` first
Slow first request	Warmup synthesis	Normal — first request triggers model load

Post-Execution Reflection

After this skill completes, check before closing:

Did the command succeed? — If not, fix the instruction or error table that caused the failure.
Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.