// Telnyx TTS provider contribution for Hermes Agent — integrates into tools/tts_tool.py.
| name | telnyx-hermes-tts |
| description | Telnyx TTS provider contribution for Hermes Agent — integrates into tools/tts_tool.py. |
| metadata | {"clawdbot":{"emoji":"🔊","requires":{"env":["TELNYX_API_KEY"]},"primaryEnv":"TELNYX_API_KEY"}} |
Use this skill when integrating or validating the Telnyx Text-to-Speech provider for Hermes.
This is not a standalone plugin. Hermes handles TTS through built-in
providers dispatched in tools/tts_tool.py. This repo contains the Telnyx
provider function and tests, ready to be contributed upstream.
| Field | Value |
|---|---|
| Provider ID | telnyx |
| WebSocket endpoint | wss://api.telnyx.com/v2/text-to-speech/speech |
| Default voice | Telnyx.NaturalHD.astra |
| Output format | MP3 |
| Auth | TELNYX_API_KEY (Bearer) |
| Endpoint override | TELNYX_TTS_BASE_URL env var |
See README.md for step-by-step instructions on adding the Telnyx TTS provider
to tools/tts_tool.py in hermes-agent. Requires adding websockets as a
dependency.
export TELNYX_API_KEY="***"
Optional WebSocket URL override:
export TELNYX_TTS_BASE_URL="wss://your-proxy.example.com/v2/text-to-speech/speech"
| Family | Example voices |
|---|---|
Telnyx.NaturalHD | astra, luna, orion, celeste, bond, andromeda |
Telnyx.KokoroTTS | af_alloy, af_bella, am_adam, am_michael |
Telnyx.Natural | (see live catalog) |
Telnyx.Ultra | (see live catalog) |
Full catalog: GET /v2/text-to-speech/voices with a valid TELNYX_API_KEY.
# No credentials needed
python -m pytest tests/test_telnyx_tts_static.py tests/test_telnyx_tts_runtime.py -q
# Live test (requires TELNYX_API_KEY)
export TELNYX_API_KEY=***
python -m pytest tests/test_telnyx_tts_live.py -q
pip install needed — the provider function is copy-pasted into hermes-agent.TELNYX_TTS_BASE_URL) is covered by tests.