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

# Avatar Integration

> Add a managed photorealistic avatar from Anam or Simli to your agent.

The quickest way to add a face is a managed avatar provider. Construct the avatar and pass it
to the pipeline's `avatar` slot; the SDK streams the agent's speech to the provider, which
renders a lip-synced video track into the room.

## Anam

Set your Anam credentials, then construct `AnamAvatar`:

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

<CodeGroup>
  ```python title="main.py" Python theme={null}
  from zrt.plugins import AnamAvatar
  from zrt.inference import AICousticsDenoise

  avatar = AnamAvatar(
      avatar_id="<avatar-id>",   # falls back to ANAM_AVATAR_ID / a default
  )

  pipeline = Pipeline(
      stt=DeepgramSTT(), llm=OpenAILLM(), tts=ElevenLabsTTS(),
      vad=SileroVAD(), turn_detector=TurnDetector(model="echo-large"),
      avatar=avatar,
      denoise=AICousticsDenoise(model_id="quail-vf-2.2-l-16khz"),
  )
  ```
</CodeGroup>

| Parameter      | Type  | Default   | Description                                           |
| :------------- | :---- | :-------- | :---------------------------------------------------- |
| `api_key`      | `str` | `None`    | Anam API key. Falls back to `ANAM_API_KEY`.           |
| `avatar_id`    | `str` | a default | The avatar to render. Falls back to `ANAM_AVATAR_ID`. |
| `persona_name` | `str` | `None`    | Optional persona name for the avatar.                 |
| `voice_id`     | `str` | `None`    | Optional voice override for the avatar.               |

## Simli

Set your Simli credentials, then construct `SimliAvatar` with the face to render:

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

<CodeGroup>
  ```python title="main.py" Python theme={null}
  from zrt.plugins import SimliAvatar
  from zrt.inference import AICousticsDenoise

  avatar = SimliAvatar(
      face_id="<face-id>",   # falls back to SIMLI_FACE_ID / a default
  )

  pipeline = Pipeline(
      stt=DeepgramSTT(), llm=OpenAILLM(), tts=ElevenLabsTTS(),
      vad=SileroVAD(), turn_detector=TurnDetector(model="echo-large"),
      avatar=avatar,
      denoise=AICousticsDenoise(model_id="quail-vf-2.2-l-16khz"),
  )
  ```
</CodeGroup>

| Parameter    | Type   | Default   | Description                                             |
| :----------- | :----- | :-------- | :------------------------------------------------------ |
| `api_key`    | `str`  | `None`    | Simli API key. Falls back to `SIMLI_API_KEY`.           |
| `face_id`    | `str`  | a default | The face to render. Falls back to `SIMLI_FACE_ID`.      |
| `model`      | `str`  | `None`    | Optional Simli model override.                          |
| `is_trinity` | `bool` | `False`   | Set when the face ID is a Trinity avatar, to keep sync. |

## References

<Tabs>
  <Tab title="Python">
    #### SDK Reference

    <CardGroup cols={2}>
      <Card title="Anam" icon="book" href="/api-reference/python/avatar/anam">
        `Anam` avatar in the Python API reference.
      </Card>

      <Card title="Simli" icon="book" href="/api-reference/python/avatar/simli">
        `Simli` avatar in the Python API reference.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>