server

Kokoro TTS サーバー

Kokoro TTS HTTP サーバー（localhost:8779 の OpenAI 互換 /v1/audio/speech エンドポイント）を管理します。

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある、パラメーターが変化している、または回避策が必要だった場合は、先送りせず直ちにこのファイルを修正してください。実際に再現可能な問題がある場合のみ更新してください。

サーバーの概要

サーバーでは次の操作ができます。

• GET /health — ヘルスステータスの JSON
• GET /v1/models — 利用可能なモデルの一覧
• POST /v1/audio/speech — テキストを音声に合成（WAV、MP3、Opus、PCM）

クイックスタート

起動（フォアグラウンド、テスト用）

~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_server.py

起動（launchd、本番用）

macOS の launchd ポリシーに従い、launchd の plist では bash スクリプトではなく、コンパイル済みの Swift バイナリを起動する必要があります。ユーザーを次の手順に沿って案内してください。

1. Swift ランチャーバイナリをコンパイルする
2. ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist に launchd plist を作成する
3. ブートストラップする：launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist

停止

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

確認

curl -s http://127.0.0.1:8779/health | python3 -m json.tool

期待される結果：{"status": "ok", "provider": "kokoro-tts-mlx", "model": "mlx-community/Kokoro-82M-bf16", "device": "mlx-metal"}

環境変数

変数	デフォルト	用途
KOKORO_SERVER_PORT	8779	リッスンポート
KOKORO_SERVER_HOST	127.0.0.1	バインドアドレス
KOKORO_DEFAULT_VOICE	af_heart	デフォルトの音声
KOKORO_DEFAULT_LANG	en-us	デフォルトの言語
KOKORO_DEFAULT_SPEED	1.0	音声速度（0.1～5.0）
KOKORO_PLAY_LOCAL	0	afplay で再生

トラブルシューティング

問題	原因	解決策
ポートがすでに使用中	別のサーバーが実行中	lsof -i :8779 で確認し、プロセスを終了する
モデルの読み込みに失敗	インストールされていない	まず /kokoro-tts:install を実行する
最初のリクエストが遅い	ウォームアップ合成	正常です。最初のリクエストでモデルが読み込まれます

実行後の振り返り

このスキルの実行後、終了する前に確認してください。

1. コマンドは成功しましたか？ — 失敗した場合は、失敗の原因となった手順またはエラーテーブルを修正してください。
2. パラメーターや出力に変化はありましたか？ — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーターテーブルを更新してください。
3. 回避策が必要でしたか？ — 臨機応変な対応（別のフラグ、追加手順など）が必要だった場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

実際に再現可能な問題がある場合のみ更新し、推測に基づく更新はしないでください。