Skip to main content
Avaluma gives you two ways to run a photorealistic conversational avatar. The fastest is to create an Agent in the Avaluma dashboard at avaluma.ai: you configure the avatar, voice, and behavior in your browser, and Avaluma hosts everything for you. If you need full control over compute and data, you can instead run the pipeline yourself — see Self-Hosting.

Agents (hosted)

Create an agent in the dashboard, share a link, or embed it. Avaluma runs the avatar server and the voice pipeline for you.

Self-Hosting

Run the Avatar Server and LiveKit Agent on your own hardware for full control over data, models, and compute.

​
What is an Agent?

An Agent is a configured, hosted avatar that lives in your Avaluma account. Each agent bundles everything a live conversation needs:
  • A photorealistic avatar rendered from an Avaluma .hvia model
  • A voice for text-to-speech
  • An AI persona — the system prompt and behavior that shape its responses
  • Sharing settings — a public link and optional embedding on your own website
Once configured, an agent has a stable Agent ID (a UUID) that you use to share or embed it.

​
Create an agent

1

Sign in to the dashboard

Log in at avaluma.ai and open the Agents section of your dashboard.
2

Create a new agent

Click New agent, give it a name, and select the avatar you want it to use. Your available avatars come from the .hvia files issued with your license.
3

Configure voice and persona

Choose a voice for text-to-speech and write the agent’s instructions (system prompt). The instructions define the agent’s tone, knowledge, and behavior during a conversation. A default voice is already preselected — a voice must be selected for the agent to speak.
4

Save and test

Save the agent and start a test conversation from the dashboard to confirm the avatar speaks and responds as expected.

​
Configure an agent

Open an agent to adjust its configuration at any time. Common settings include:
Only shared agents can be opened via a public link or embedded on a website. Enable sharing before you distribute an agent link.

​
Manage agents

In the Agents overview, each agent has a menu (three dots) with additional actions:
Duplicating also carries over the embedding and kiosk settings (including the allowed origins). The copy is therefore immediately reachable under the same conditions as the original.

​
Per-agent usage statistics

In the Agents overview, each agent card shows how many conversation minutes that agent has been used in the current month. The statistics icon on the card opens a window with the key metrics: A trend additionally shows conversations over time, switchable between 1 day (by hour), 7 days, and 30 days. Use the date field to pick the end date of the period (default: today) and look back at past days or weeks.
The monthly total across all agents and your plan limit are shown in the bar at the top of the Agents page — see Pricing & Billing for details.

​
Share and embed

Each agent is reachable at a hosted URL based on its Agent ID:
To put the agent directly on your own site, embed it as an <iframe> and control it from your page.

Embedding

Embed an agent on your website with an <iframe> and customize its appearance and behavior via query parameters.

Messaging

Control the embedded avatar programmatically and receive events with the postMessage API.

Kiosk mode

Run the agent fullscreen on an unattended display — with a screen wake lock and idle auto-reset.