// Telnyx STT provider contribution for Hermes Agent — integrates into tools/transcription_tools.py.
| name | telnyx-hermes-stt |
| description | Telnyx STT provider contribution for Hermes Agent — integrates into tools/transcription_tools.py. |
| metadata | {"clawdbot":{"emoji":"🎙️","requires":{"env":["TELNYX_API_KEY"]},"primaryEnv":"TELNYX_API_KEY"}} |
Use this skill when integrating or validating the Telnyx Speech-to-Text provider for Hermes.
This is not a standalone plugin. Hermes handles STT through built-in
providers dispatched in tools/transcription_tools.py. This repo contains the
Telnyx provider function and tests, ready to be contributed upstream.
| Field | Value |
|---|---|
| Provider ID | telnyx |
| Endpoint | https://api.telnyx.com/v2/ai/audio/transcriptions |
| Default model | openai/whisper-large-v3-turbo |
| Protocol | OpenAI-compatible (multipart/form-data) |
| Auth | TELNYX_API_KEY (Bearer) |
| Base URL override | TELNYX_STT_BASE_URL env var |
| Language override | TELNYX_STT_LANGUAGE env var (ISO-639-1, default en) |
See README.md for step-by-step instructions on adding the Telnyx STT provider
to tools/transcription_tools.py in hermes-agent. No new dependencies are
required — the existing openai package is reused with the Telnyx base URL.
export TELNYX_API_KEY="***"
Optional:
export TELNYX_STT_BASE_URL="https://api.telnyx.com/v2/ai"
export TELNYX_STT_LANGUAGE="en"
# No credentials needed
python -m pytest tests/test_telnyx_stt_static.py tests/test_telnyx_stt_runtime.py -q
# Live test (requires TELNYX_API_KEY)
export TELNYX_API_KEY=***
python -m pytest tests/test_telnyx_stt_live.py -q
pip install needed — the provider function is copy-pasted into hermes-agent.TELNYX_STT_BASE_URL) is covered by tests.