Skip to main content
An Avatar is a desktop character connected to an Agent. It presents voice conversations with speech-synchronized animation while the Agent uses its normal instructions and tools.
Avatar gallery showing Agent assignment, rendering quality, voice, and optional downloads

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

​
Set up a character

  1. Open Settings → Agents → Avatar.
  2. Choose a character in the gallery and download its base package.
  3. Assign an Agent when prompted. Each Agent has one Avatar assignment, and each character is assigned to one Agent.
  4. Choose the character’s Quality and Voice. Voice changes apply to the next voice conversation.
  5. Click Open to show the assigned Agent’s Avatar.
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 appropriate for your Mac.

​
Talk and interact

Set up Realtime Voice, then use the Avatar’s conversation controls to start talking. Right-click the character for available voice, history, settings, and character controls. The chat bubble shows conversation text and voice activity. You can move the character, use scroll to rotate it, and use Control-scroll or a pinch gesture to zoom. Transparent margins allow clicks to pass through to the desktop.

​
Character selection and Agent identity

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. Change permanent assignments in Settings. The Avatar switch in the menu bar or Dynamic Island opens the main Agent with its assigned character.

​
Troubleshooting

A Pet is a separate desktop companion with different controls.

​
Watch the steps

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.