First agent

export LIVEKIT_URL=wss://your-project.livekit.cloud
export LIVEKIT_API_KEY=your-livekit-key
export LIVEKIT_API_SECRET=your-livekit-secret

export DEEPGRAM_API_KEY=your-deepgram-key
export OPENAI_API_KEY=your-openai-key
export CARTESIA_API_KEY=your-cartesia-key

export LIVEKIT_URL=ws://localhost:7880
export LIVEKIT_API_KEY=devkey
export LIVEKIT_API_SECRET=secret

"""LiveKit voice agent with VoiceGateway cost metering and LLM fallback."""

from livekit.agents import Agent, AgentSession, WorkerOptions, cli
from livekit.plugins import cartesia, deepgram, openai

import voicegateway


class MyAgent(Agent):
    def __init__(self) -> None:
        super().__init__(
            instructions=(
                "You are a friendly voice assistant. Keep your answers short "
                "and clear. One or two sentences unless asked for more."
            ),
        )


async def entrypoint(ctx) -> None:
    await ctx.connect()

    # guard() wraps the LLM with a fallback and a daily budget.
    # It returns a drop-in openai.LLM, so AgentSession sees no difference.
    guarded_llm = voicegateway.guard(
        openai.LLM(model="gpt-4o-mini"),
        fallback=[openai.LLM(model="gpt-4o")],
        rate_limit="60/min",
        budget="$5.00/day",
        project="my-agent",
    )

    session = AgentSession(
        stt=deepgram.STT(model="nova-3"),
        llm=guarded_llm,
        tts=cartesia.TTS(model="sonic-3"),
    )

    # attach() is the single meter. Call it once, before session.start().
    voicegateway.attach(session, project="my-agent")

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


if __name__ == "__main__":
    cli.run_app(WorkerOptions(entrypoint_fnc=entrypoint))

python agent.py dev

voicegw dashboard              # opens the browser at http://localhost:8080
voicegw costs --project my-agent
voicegw logs  --project my-agent
voicegw status