Voxta Characters
Build the personality, voice, and profile of an AI persona that scenarios assign to roles.
A character in Voxta is everything the AI needs to be a specific persona — name, description, personality, voice, default scenario, attached lore.
You build characters in Studio. Scenarios then assign them to roles so the same character can be reused across multiple scenarios.
The pieces of a character
| Field | What it does |
|---|---|
| Name | What the AI calls themselves. Also what {{ char }} resolves to. |
| Description | The visual / physical description. What the character looks like, wears, carries. |
| Personality | Traits, voice patterns, mannerisms. The "vibe" of the character. |
| Profile | Background, history, motivation, relationships. The deep biography. |
| First message | The character's opening greeting in a fresh chat. |
| Tags | Searchable labels you can filter on or template against (char_has_tag "tag_name"). |
| Explicit | Marks the character as adult content. Affects prompts and UI surfaces. |
| Voice | Which TTS service + voice the character uses to speak. |
| Default Scenario | The scenario this character runs in if no scenario is explicitly picked. |
| Assets | Images, audio files, animations attached to the character — referenced from scripts and app triggers. |
Tabs
Studio's character editor splits these across tabs:
- General — name, description, personality, profile, first message.
- Voice — pick the TTS service and voice (see Services / Text-to-Speech).
- Tags — tag the character for search and filtering.
- Memory Book — attach a memory book for long-form lore.
- Assets — upload images, audio, video referenced from scenario scripts.
Templating in character fields
The Description, Personality, Profile, and first message can all use Scriban templates. Common patterns:
{{ user }}— the user's name. Lets the character know who they're addressing.{{ has_flag "some_flag" }}— conditional description that changes when the chat is in a particular state.
Example Description:
A tall woman in her late twenties.
{{~ if has_flag "is_drenched" ~}}
Her clothes are completely soaked through.
{{~ end ~}}Where characters live
Characters are stored in your Voxta server's database (Data/Voxta.db). Exporting a character produces a .png (Voxta-format character card) or a .voxpkg if bundled in a package.