Quick Start

pip install "livekit-agents[agenthuman]"

AGENTHUMAN_API_KEY=ah_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
AGENTHUMAN_AVATAR_ID=avat_xxxxxxxxxxxxxxxxxxxxxxxx   # optional: defaults to a stock avatar
LIVEKIT_URL=wss://your-project.livekit.cloud
LIVEKIT_API_KEY=your-livekit-key
LIVEKIT_API_SECRET=your-livekit-secret

from livekit.agents import Agent, AgentServer, AgentSession, JobContext, TurnHandlingOptions, cli
from livekit.plugins import agenthuman

server = AgentServer()

@server.rtc_session()
async def entrypoint(ctx: JobContext):
    session = AgentSession(
        # ... your STT, LLM, TTS config
        turn_handling=TurnHandlingOptions(
            interruption={"mode": "vad", "resume_false_interruption": False},
        ),
    )

    avatar = agenthuman.AvatarSession(
        avatar_id="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
    )

if __name__ == "__main__":
    cli.run_app(server)

python agent.py start