Voxta docs

Characters

The persona, voice, memory and prompting settings behind an AI character.

A character is everything the AI needs to be a specific persona — who they are, how they sound, what they remember, and how their prompt is built.

Characters are independent of scenarios: a scenario assigns a character to a role, so the same character can appear in many scenarios.

Tabs

TabWhat's in it
OverviewName, notes, tags, explicit content, listing label, folder, avatar.
ConfigurationCulture, chat style, augmentations, time awareness, away notifications, forced service configuration.
AppsPer-app configuration for host apps that declare any.
CharacterThe persona itself — the card fields below.
VoiceTTS service and voice, plus thinking sounds.
MemoryLong-term memory settings and attached memory books.
ScenarioDefault scenario, greeting, user instructions, user overrides.
PromptingSystem prompt strategy, context, generation limits, image-gen overrides.
ScriptsScripts the character carries into any chat.
AssetsImages, audio, video and animations.
PackageThe content package this belongs to.

The character card

FieldWhat it does
NameWhat {{ char }} resolves to.
AppearanceWhat they look like, wear, carry.
PersonalityTraits, mannerisms, speech patterns.
ProfileBackground, history, motivations, relationships.
Message examplesSample exchanges that show the model how they talk.

These follow the character card v2 spec, so cards import from elsewhere.

Configuration

  • Culture — the character's language and locale. Drives date and time formatting, and the default voice.
  • Chat styleCompanion, Roleplay, Storytelling or Assistant. Also decides which actions and tools are offered, since a roleplay character has no business running shell commands.
  • Augmentations — which chat augmentations this character uses. Leave empty for all of them.
  • Time awareness — whether {{ now }} is populated. Off means the character has no sense of the date.
  • Notify when away — whether they react to you having been gone.

Scenario tab

  • Quick chat default scenario — the scenario used when you start a chat from this character with no scenario picked. It can differ per host app.
  • Default scenario text — the fallback scenario description when no scenario overrides it.
  • Greeting — the opening message. Add alternatives and one is picked at random.
  • User instructions — instructions injected as an instructions message when the chat opens.
  • User overrides — a name and description for the user, so the character can address you as someone else without a full scenario. The scenario's impersonation takes precedence when both are set.

Prompting

FieldWhat it does
System prompt strategyAddOn appends to the default, Intro places it ahead of it, System replaces it entirely.
System promptThe text that strategy applies.
ContextExtra standing text folded into the prompt for this character.
Post-history instructionsText placed after the conversation — the last thing the model reads.
Max tokens / max sentencesCaps on the character's replies.
Image generation overridesPrompt prefix, suffix, negative prefix and prompting instructions applied when generating images of this character.

Memory

Two mechanisms share the character's private memory book and are enabled separately:

  • Memories — events that happened and stay true, recalled when the conversation touches them.
  • Understanding — a standing model of the people in the chat, rewritten as it develops and always in the prompt.

Both are experimental and need a memory service. Authored lore books are attached here too. See Memory books.

Templating

Appearance, personality, profile, context and the greeting all accept Scriban templates:

A tall woman in her late twenties.
{{~ if has_flag "is_drenched" ~}}
Her clothes are completely soaked through.
{{~ end ~}}

Scripts

A character can carry its own scripts, which run in any chat it joins — not just in scenarios written for it.

Export

A character exports as a .png character card, or inside a .voxpak package. Assets only travel with a package.

What's next

On this page