# Creating Animations for AI Avatars

## **Overview**

Using the **Convai XR Animation Capture** app on your Meta Quest headset, you can create custom animations for your AI characters by simply acting them out in VR. These animations help your avatars express themselves naturally during conversations—whether in Unity, Unreal, Avatar Studio, or Convai Sim.

{% hint style="warning" %}
 ***Haven’t set up the app yet?***\
Head over to the [Convai XR Animation Capture App Setup Guide](/api-docs/no-code-experiences/convai-xr-animation-capture-app/convai-xr-animation-capture-app-setup.md) before continuing.
{% endhint %}

***

## **Recording Animations in VR**

### **Step 1: Review Existing Animations (Optional)**

When you launch the app, you’ll see your **animation dashboard**. From here, you can:

* View previously recorded animations
* **Replay** them to see how they look
* **Delete** any that you no longer need

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdeV2U8qhR1oXLcsQtZ_ub9vc0PUVz9smmnFFWxFB7y1P4vnhCdbq_xUmvA6dpA5RdNC1dbM9hmF2Zg3LrhKl0W8B_45JTzkROALb_5buc1K2GCcav2gDIXHxrKWxE-Pvv3nzkz?key=fHPO8I8f-LT0qsfmTXmKpQ" alt=""><figcaption></figcaption></figure>

***

### **Step 2: Start Recording**

1. In the app, click **“Start Recording”**.
2. A five-second countdown will start.
3. Begin **performing your animation.**
   * Examples: wave, point, gesture, etc.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdxfyAn02JjXB7I4kAQ_wfDsPve7fqi3zuip5X8AwPhd2iS8l82nQx1oMXH720iThbg0C1r496WwfCO8gCjZ4-ywbjO1lwF2LMAAjbbI-OcqoaZ2jcLDGptZdMrOl3Dp2DieiNvlw?key=fHPO8I8f-LT0qsfmTXmKpQ" alt=""><figcaption></figcaption></figure>

***

### **Step 3: Stop & Review**

1. Once you're done, click **“Stop”**.
2. You can review the recorded animation by pressing the **"Replay Animation"** button.
   * This helps you decide whether to save, redo, or discard.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcPdnEXTN5mCYICBWGOIjdljVTJsTQZYqQC2WuokXXfv4nauC2Nf6n1h2Q_no2lO61G-ajwhqU-Tf2EFjhV5F5_otXWLVKHJqDNglDvrypYD-iV54lOc-eWbHp7lB8MsadlYnmw7g?key=fHPO8I8f-LT0qsfmTXmKpQ" alt=""><figcaption></figcaption></figure>

***

### **Step 4: Name & Save**

1. Enter a **clear and descriptive name** (e.g., *Wave Greeting*, *Points Left*).
2. Click **“Save & Upload”**.

The animation is now uploaded to your **Convai dashboard**, ready to be:

* Assigned to AI avatars
* Used across **Unity**, **Unreal**, **Avatar Studio**, or **Convai Sim**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcDFw3AjkgglpSp66Ml08sNIPq5G7nEYLaPZ7CCMwX4Vi8wKol2_3GX23fPuOBJF7xlsIsQT9ADSZuZeogu-Hp29Atcre2q9Xz6eD_oSIlE1TZIevI4SCOqZ3mpIbVYDRY80jo4eQ?key=fHPO8I8f-LT0qsfmTXmKpQ" alt=""><figcaption></figcaption></figure>

***

### **Keep Building Your Animation Library**

Record and save multiple animations to populate your library. These can be reused across projects, allowing your avatars to **intelligently perform gestures** during conversations—making your virtual experiences more engaging and realistic.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/no-code-experiences/convai-xr-animation-capture-app/creating-animations-for-ai-avatars.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.