> ## 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 and JavaScript.

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.

<CodeGroup>
  ```python Python theme={null}
  from zeroruntime.plugins import AnamAvatar

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

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

  ```typescript Node JS theme={null}
  import { AnamAvatar } from '@zeroruntime/js-sdk/plugins';

  const avatar = AnamAvatar({
    avatar_id: '<avatar-id>',
  });

  // Pipeline({ avatar, ... })
  ```
</CodeGroup>

## 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](/runtime-sdk/build/modalities/avatars/integration) for how it wires into the
pipeline, or browse the full [plugins overview](/runtime-sdk/plugins/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.