> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agenthuman.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Add an Agent Human avatar to your LiveKit Agent in three steps

## Step 1 — Install and configure

```bash theme={null}
pip install "livekit-agents[agenthuman]"
```

Set your environment variables:

```bash theme={null}
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
```

## Step 2 — Add `AvatarSession` to your agent

Import `AvatarSession`, instantiate it with your avatar, and call `start()` before starting the agent session:

```python theme={null}
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
    )
```

That's it. `AvatarSession` creates the Agent Human session, generates the LiveKit token, and routes your agent's audio output through the avatar video stream automatically.

## Step 3 — Run your agent

```bash theme={null}
python agent.py start
```

<Note>
  `avatar.start()` reads `LIVEKIT_URL`, `LIVEKIT_API_KEY`, and `LIVEKIT_API_SECRET` from environment variables. You can also pass them directly — see [Configuration](/documentation/livekit/configuration).
</Note>