kokoro-tts.yaml 2.3 KB

123456789101112131415161718192021
  1. name: kokoro-tts
  2. title: Kokoro TTS (local)
  3. repo: https://github.com/brunosouzas/hermes-kokoro-tts
  4. sha: d8e8769d6997f29f98da7ceea97b4e3a76688b39
  5. description: "Local Kokoro-82M text-to-speech on Apple Silicon (MLX) and Linux (PyTorch on CPU): adds the kokoro-mlx speech provider (tts.provider: kokoro-mlx) with sentence-by-sentence PCM streaming for voice mode, read-aloud and text_to_speech, an optional voice per language that switches per sentence between Brazilian Portuguese and English (tested by the author) and Italian (not yet tested by the author), and an optional dictionary of English words a non-English voice pronounces in English without changing voice; plus hermes kokoro install, status, restart, voices, say, words and uninstall. Disclosure — hermes kokoro install creates a separate Python 3.11 environment with uv (about 1.1 GB on macOS or 1.3 GB on Linux from PyPI, plus spaCy's en_core_web_sm wheel from its GitHub release and, on Linux, the CPU-only torch wheel from download.pytorch.org, both pinned by SHA-256), downloads the model at a pinned revision from Hugging Face (mlx-community/Kokoro-82M-bf16 on macOS, hexgrad/Kokoro-82M on Linux, about 340 MB), and installs a background service that keeps a local server running (a launchd agent on macOS, a systemd user unit on Linux, both named dev.hermes.kokoro-tts). The server listens only on 127.0.0.1 (it refuses other addresses), runs offline, and does not log the text; the text to speak goes only to that local server, bypassing any proxy settings. Writes the environment, model cache and log under ~/Library/Application Support/hermes-kokoro-tts (macOS) or ~/.local/share/hermes-kokoro-tts (Linux), the requested audio files, and the profile's config.yaml only when you run hermes kokoro words add or remove. No API keys, no telemetry."
  6. maintainer: brunosouzas
  7. tier: community
  8. category: voice
  9. requires_hermes: ">=0.22.2"
  10. docs_url: https://github.com/brunosouzas/hermes-kokoro-tts#readme
  11. version: "0.4.0"
  12. readme: true
  13. platforms: [macos, linux]
  14. known_issues:
  15. - "Runs on macOS with Apple Silicon (MLX) and on Linux x86_64 with a systemd user session."
  16. - "Under plugins.isolation: host the hermes kokoro terminal command is not available (Hermes skips plugin CLI commands in the host); the speech provider still registers."
  17. capabilities:
  18. provides_tools: []
  19. provides_hooks: []
  20. provides_middleware: []
  21. requires_env: []