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

# Avatars

> Give an Agent a character on your desktop that talks with you in voice calls.

An Avatar is a desktop character that stands for one of your Agents. In voice calls it speaks with animation synced to its voice, while the Agent keeps its usual instructions and tools.

This video covers Avatar first, then IM Channels and Credential Management.

![How to Use Avatars, IM Channels and Credentials in Enconvo | Step-by-Step Tutorial](https://img.youtube.com/vi/O5rNJwqlisg/maxresdefault.jpg)

![Avatar gallery showing Agent assignment, rendering quality, voice, and optional downloads](https://mintcdn.com/thegreatlionheartpteltd/hQPNJJatkK6kD6HF/images/guides/avatar-gallery.jpg?fit=max\&auto=format\&n=hQPNJJatkK6kD6HF\&q=85\&s=07255868417aeb7780f6c2bde1bc13a6)

Avatar gallery showing Agent assignment, rendering quality, voice, and optional downloads.

## Set up a character

1. Open **Settings → Avatar**.
2. Find a character in **Gallery** and click **Download** to get its base package.
3. When the download finishes, choose the Agent it stands for and click **Bind Avatar**. Each Agent has one Avatar, and each Avatar belongs to one Agent.
4. Choose the character's **Quality**.
5. Click **Open** to show the Agent's Avatar on your desktop.

An Avatar's calls speak with the voice set in **Settings → Live Talk → Speak**, and a voice change applies to the next call.

**Optional downloads** lists additional packages for that character, such as higher-resolution textures or motions when available. Start with the base package and choose a quality that suits your Mac.

To make your own character, click **Create a character** and pick its face, fur, and name, or click **Import file…** to add an OpenAvatar character file.

## Talk and interact

Set up [Live Talk](https://docs.enconvo.ai/features/live-voice.md), then use the Avatar's conversation controls to start talking. Right-click the character for voice, history, settings, and character controls. The chat bubble shows conversation text and voice activity.

You can move the character, scroll to rotate it, and Control-scroll or pinch to zoom. Clicks on the transparent margins pass through to the desktop.

## Switch characters

The desktop **Character** menu does not reassign Agents. Selecting a character assigned to another Agent opens that Agent's Avatar. An unassigned character is shown through the main Agent. To change which Agent a character belongs to, use **Settings → Avatar**.

The Avatar switch in the menu bar or the Dynamic Island opens the main Agent with its assigned character.

## Settings

Each downloaded character's card in **Settings → Avatar** has these controls:

| Setting | What it changes |
| - | - |
| **Agent** | The Agent the character stands for. Assigning a new pair replaces their previous bindings; voice, appearance, and chat history are kept. |
| **Quality** | The rendering quality. **Minimal**, the default, uses the least GPU, CPU, and battery. **Balanced** and **Best quality** add lighting, shading, and larger textures, and use more GPU. |
| **Optional downloads** | Extra packages for the character, and package updates. |

**Natural lip sync**, above the gallery, downloads an on-device model that shapes every Avatar's lips from the voice it speaks with. It needs a Mac with Apple silicon.

**Live Desktop**, below it, puts a board behind your windows that shows what your Agents, coding sessions, and automations are doing, with a character that reacts when something needs you or goes wrong.

## Troubleshooting

| Problem | What to do |
| - | - |
| **Quality** can't be changed | Download the character and assign an Agent first. |
| A download fails | Read the error on the card, check your connection and free disk space, and click **Retry**. |
| The character is blurry when enlarged | Choose a higher **Quality**, and check **Optional downloads** for textures. |
| A call won't start | Check your [Live Talk](https://docs.enconvo.ai/features/live-voice.md) settings and macOS Microphone access. |
| The wrong Agent answers | Check the character's **Agent** in **Settings → Avatar**. |

## Watch the steps

<video controls playsInline preload="none" poster="/images/guides/avatar-gallery.jpg" aria-label="Browse the Avatar gallery">
  <source src="https://mintcdn.com/thegreatlionheartpteltd/hQPNJJatkK6kD6HF/videos/guides/avatar-gallery.mp4?fit=max&auto=format&n=hQPNJJatkK6kD6HF&q=85&s=f0b3cb2088e0a462a1f3aef1a7c912d1" type="video/mp4" />

  [Download the walkthrough](https://docs.enconvo.ai/videos/guides/avatar-gallery.mp4).
</video>

Switch to Downloaded, search for Tia, inspect Optional downloads, then return to Gallery. No package is downloaded and no assignment is changed. This silent walkthrough uses real interface captures with pauses added for reading. The written steps above provide the same instructions.

## Related

> [card] [Live Talk](https://docs.enconvo.ai/features/live-voice.md)
>
> Start a voice call with the Agent.

> [card] [Agents](https://docs.enconvo.ai/ai/agents.md)
>
> Set up the Agent an Avatar stands for.

> [card] [Pet](https://docs.enconvo.ai/features/pet.md)
>
> A separate desktop companion with its own controls.

> [card] [Dynamic Island](https://docs.enconvo.ai/features/dynamic-island.md)
>
> Open your Avatar from the notch.


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