Quickstart

curl -fsSL https://cartesia.sh | sh
cartesia auth login

curl -LsSf https://astral.sh/uv/install.sh | sh

uv init my-voice-agent && cd my-voice-agent
uv add cartesia-line

import os
from line.llm_agent import LlmAgent, LlmConfig, end_call
from line.voice_agent_app import VoiceAgentApp

async def get_agent(env, call_request):
    return LlmAgent(
        model="anthropic/claude-haiku-4-5-20251001", # Or "gpt-5-nano", "gemini/gemini-2.5-flash", etc.
        api_key=os.getenv("ANTHROPIC_API_KEY"),
        tools=[end_call],
        config=LlmConfig(
            system_prompt="You are a helpful assistant.",
            introduction="Hello! How can I help you today?",
        ),
    )

app = VoiceAgentApp(get_agent=get_agent)

if __name__ == "__main__":
    app.run()

ANTHROPIC_API_KEY=your-api-key PORT=8000 uv run python main.py

cartesia chat 8000

cartesia init    # Choose "Create new" and name your agent
cartesia deploy

cartesia env set ANTHROPIC_API_KEY=your-api-key

cartesia env set --from .env

cartesia call +1XXXXXXXXXX