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.
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:
SettingDescription
NameInternal label for the agent in your dashboard.
AvatarThe .hvia avatar the agent renders.
VoiceThe text-to-speech voice used for spoken replies.
InstructionsThe system prompt that shapes the agent’s persona and behavior.
LanguageDefault conversation and UI language.
SharingWhether the agent is reachable via a public link.
EmbeddingWhether the agent may be embedded via <iframe>, and on which origins.
KioskWhether the agent is reachable as a standalone fullscreen page (kiosk).
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:
ActionDescription
DuplicateCreates a full copy of the agent — including voice, instructions, tools, and all uploaded documents. The copy gets a new Agent ID and the name <Name> (Copy).
TransferHands the agent over to another user (by email address). The new owner gets full access, and the agent disappears from your list.
DeletePermanently removes the agent. This action cannot be undone.
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.

​
Share and embed

Each agent is reachable at a hosted URL based on its Agent ID: 
https://avaluma.ai/agent/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.