Quick Start

pip install "livekit-agents[agenthuman]"

AGENTHUMAN_API_KEY=ah_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
AGENTHUMAN_AVATAR=avat_xxxxxxxxxxxxxxxxxxxxxxxx   # optional default avatar
LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your-livekit-key
LIVEKIT_API_SECRET=your-livekit-secret

import agenthuman
from livekit.agents import Agent, AgentServer, AgentSession, JobContext

server = AgentServer()

@server.rtc_session()
async def entrypoint(ctx: JobContext):
    session = AgentSession(
        # ... your STT, LLM, TTS config
    )

    avatar = agenthuman.AvatarSession(
        avatar="avat_xxxxxxxxxxxxxxxxxxxxxxxx",
        aspect_ratio="4:3"
    )
    await avatar.start(session, room=ctx.room)

    await session.start(
        agent=Agent(instructions="You are a helpful assistant."),
        room=ctx.room
    )

python agent.py start