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

# Anam

> Use the Anam avatar plugin in a Zero Runtime pipeline. Setup and usage in Python.

Anam is an **avatar** plugin. It renders a real-time, lip-synced AI avatar synchronized to
the agent's speech output.

## Setup

Set your Anam API key in the worker environment. Generate a key from the [Anam site](https://www.anam.ai/):

```bash theme={null}
export ANAM_API_KEY=<key>
```

## Usage

Import the plugin and pass it to the pipeline's `avatar` slot.

```python theme={null}
from zrt.plugins import AnamAvatar

avatar = AnamAvatar(
    avatar_id="<avatar-id>",
)

# Pipeline(avatar=avatar, ...)
```

## Parameters

| Parameter      | Type  | Default | Description                                                                                                                             |
| -------------- | ----- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `api_key`      | `str` | `None`  | Anam API key. Falls back to the `ANAM_API_KEY` environment variable when unset.                                                         |
| `avatar_id`    | `str` | `""`    | Identifier of the avatar to use. Falls back to the `ANAM_AVATAR_ID` environment variable, then to a built-in default avatar when empty. |
| `persona_name` | `str` | `None`  | Optional persona name to apply to the avatar.                                                                                           |
| `voice_id`     | `str` | `None`  | Optional voice identifier for the avatar.                                                                                               |

The avatar renders a lip-synced video track from the agent's speech; see the
[avatar integration guide](/build/modalities/avatars/integration) for how it wires into the
pipeline, or browse the full [plugins overview](/plugins/overview).