Skip to main content
First time building? Complete Quickstart — Step 1 to configure your CLI and register with the platform.

1. Install the plugin

This is the Telnyx-maintained plugin, which includes the latest features and fixes ahead of the upstream livekit-plugins-telnyx PyPI package. We host our own release to iterate faster than the upstream cadence allows. Use the git install above for the current recommended version.
Plugin source on GitHub

2. Write your agent

Create agent.py:
The only Telnyx-specific parts are the stt, tts, and llm — everything else is standard LiveKit.

3. Add a requirements file

Create requirements.txt:

4. Deploy

The platform builds your image in-cluster, deploys it, and starts the worker. Check the status:
Tail logs once it’s running:

Swap models

The example above uses Telnyx-hosted defaults. Swap any component independently:
  • STT — Deepgram, Nova-3, Nova-2, Flux → STT plugin
  • TTS — Telnyx Natural HD, MiniMax, Rime, ElevenLabs (BYOK), Azure → TTS plugin
  • LLM — GPT-4o-mini, Kimi-K2.6, Claude (BYOK) → LLM plugin

Next steps