Build

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

1. Install the plugin

pip install "telnyx-livekit-plugin @ git+https://github.com/team-telnyx/telnyx-livekit-plugin.git#subdirectory=telnyx-livekit-plugin"

This is the Telnyx-maintained plugin. It includes features the official livekit-plugins-telnyx package doesn’t have yet. Both install the livekit.plugins.telnyx module, so install only one.

Plugin source on GitHub

2. Write your agent

Create agent.py:

import asyncio
from livekit.agents import Agent, AgentSession, JobContext, RoomInputOptions
from livekit.plugins import openai, silero, telnyx

class MyAgent(Agent):
    def __init__(self):
        super().__init__(instructions="You are a helpful voice assistant.")

    async def on_enter(self):
        self.session.generate_reply(
            instructions="Greet the caller and ask how you can help."
        )

async def entrypoint(ctx: JobContext):
    session = AgentSession(
        stt=telnyx.STT(
            transcription_engine="Deepgram",
            base_url="wss://api.telnyx.com/v2/speech-to-text/transcription",
        ),
        llm=openai.LLM.with_telnyx(model="zai-org/GLM-5.2"),
        tts=telnyx.TTS(
            voice="Minimax.speech-2.8-turbo.English_radiant_girl",
            sample_rate=24000,
        ),
        vad=silero.VAD.load(),
    )

    await ctx.connect()
    await session.start(
        agent=MyAgent(),
        room=ctx.room,
        room_input_options=RoomInputOptions(),
    )

    disconnect_event = asyncio.Event()

    @ctx.room.on("disconnected")
    def on_disconnect(*args):
        disconnect_event.set()

    await disconnect_event.wait()

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

Room name prefixes

Telnyx prefixes LiveKit room names for routing. If your application logic reads ctx.room.name, you must strip the Telnyx prefix before comparing it with room names from your own system:

room_name = ctx.room.name
if ":" in room_name:
    _, room_name = room_name.split(":", 1)

3. Add a requirements file

Create requirements.txt:

livekit-agents
livekit-plugins-openai
livekit-plugins-silero
telnyx-livekit-plugin @ git+https://github.com/team-telnyx/telnyx-livekit-plugin.git#subdirectory=telnyx-livekit-plugin

4. Deploy

lk agent deploy . --secrets TELNYX_API_KEY=$TELNYX_API_KEY

The platform builds your image in-cluster, deploys it, and starts the worker. Check the status:

lk agent list

Tail logs once it’s running:

lk agent logs --id <AGENT_ID>

Swap models

The example above uses Telnyx-hosted defaults. Swap any component independently:

STT — Deepgram, Nova-3, Nova-2, Flux → STT plugin
TTS — MiniMax, Telnyx KokoroTTS, Telnyx Ultra (REST API only), ElevenLabs (BYOK), Azure → TTS plugin
LLM — GPT-4o-mini, Kimi-K2.6, Claude (BYOK) → LLM plugin

Next steps

Telephony — Connect your agent to a phone number
Deploy reference — Secrets, rollbacks, multi-region

LiveKit on Telnyx (Beta)

Migration

Deploy

Plugin Reference

Observability

Telephony

Reference

For AI Agents

Build

1. Install the plugin

2. Write your agent

Room name prefixes

3. Add a requirements file

4. Deploy

Swap models

Next steps

​1. Install the plugin

​2. Write your agent

​Room name prefixes

​3. Add a requirements file

​4. Deploy

​Swap models

​Next steps

1. Install the plugin

2. Write your agent

Room name prefixes

3. Add a requirements file

4. Deploy

Swap models

Next steps