# Telnyx Hermes Tts

> Telnyx TTS provider contribution for Hermes Agent — integrates into tools/tts_tool.py.

- Skill: `team-telnyx/telnyx-hermes-tts` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add team-telnyx/telnyx-hermes-tts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/team-telnyx/telnyx-hermes-tts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: team-telnyx (https://skillmd.com/u/team-telnyx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/team-telnyx/telnyx-hermes-tts

---


# Telnyx Hermes TTS Provider

Use this skill when integrating or validating the Telnyx Text-to-Speech provider for Hermes.

## Architecture

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.

## Provider details

| Field | Value |
|-------|-------|
| Provider ID | `telnyx` |
| WebSocket endpoint | `wss://api.telnyx.com/v2/text-to-speech/speech?voice=<voice>` |
| Default voice | `Telnyx.NaturalHD.astra` |
| Output format | MP3 |
| Auth | `TELNYX_API_KEY` (Bearer) |
| Endpoint override | `TELNYX_TTS_BASE_URL` env var |

## Integration

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.

## Configure

```bash
export TELNYX_API_KEY="***"
```

Optional WebSocket URL override:

```bash
export TELNYX_TTS_BASE_URL="wss://your-proxy.example.com/v2/text-to-speech/speech"
```

## Available voices

| 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`.

## Running tests

```bash
# 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
```

## Notes

- No `pip install` needed — the provider function is copy-pasted into hermes-agent.
- Local tests use a mock WebSocket; live tests hit the real Telnyx API.
- The endpoint override (`TELNYX_TTS_BASE_URL`) is covered by tests.