Avatars

Avatars are the visual face of your AI. They're 3D characters that speak, gesture, and express emotion in real-time.

Built-in Avatars

Avatarium includes several ready-to-use avatars:

Scarlett

• Gender: Female
• Style: Professional
• Best for: Business, customer support, corporate
• Model ID: scarlett

Maya

• Gender: Female
• Style: Warm, friendly
• Best for: Companions, coaching, education
• Model ID: maya

Lily

• Gender: Female
• Style: Casual, energetic
• Best for: Content creation, entertainment
• Model ID: lily

James

• Gender: Male
• Style: Professional
• Best for: Business, sales, formal contexts
• Model ID: james

Using an Avatar

<Avatar model="scarlett" />

Or with full configuration:

<Avatar
  model="scarlett"
  personality="You are a helpful assistant..."
  greeting="Hello! How can I help?"
  voice="en-US-female-1"
/>

Custom Avatars

Bring your own 3D characters:

From Ready Player Me

1. Create an avatar at readyplayer.me (opens in a new tab)
2. Copy the GLB URL
3. Use it in Avatarium:

<Avatar
  model={{
    type: 'ready-player-me',
    url: 'https://models.readyplayer.me/YOUR_ID.glb'
  }}
/>

From GLB File

Upload any compatible 3D model:

<Avatar
  model={{
    type: 'custom',
    url: 'https://your-cdn.com/avatar.glb'
  }}
/>

Requirements for Custom Models

• Format: GLB (GLTF Binary)
• Rigging: Standard humanoid skeleton
• Blend shapes: 15 ARKit-compatible visemes for lip sync
• File size: Under 10MB recommended

Custom Avatar Setup Guide →

Avatar Animations

Avatars automatically animate:

• Lip Sync – Lips match the spoken audio
• Idle Motion – Subtle breathing and micro-movements
• Gestures – Hand and body movements during speech
• Emotions – Facial expressions based on conversation context

Avatar Properties

Full Avatar API Reference →