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
| Tab | What's in it |
|---|---|
| Overview | Name, notes, tags, explicit content, listing label, folder, avatar. |
| Configuration | Culture, chat style, augmentations, time awareness, away notifications, forced service configuration. |
| Apps | Per-app configuration for host apps that declare any. |
| Character | The persona itself — the card fields below. |
| Voice | TTS service and voice, plus thinking sounds. |
| Memory | Long-term memory settings and attached memory books. |
| Scenario | Default scenario, greeting, user instructions, user overrides. |
| Prompting | System prompt strategy, context, generation limits, image-gen overrides. |
| Scripts | Scripts the character carries into any chat. |
| Assets | Images, audio, video and animations. |
| Package | The content package this belongs to. |
The character card
| Field | What it does |
|---|---|
| Name | What {{ char }} resolves to. |
| Appearance | What they look like, wear, carry. |
| Personality | Traits, mannerisms, speech patterns. |
| Profile | Background, history, motivations, relationships. |
| Message examples | Sample 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 style —
Companion,Roleplay,StorytellingorAssistant. 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
| Field | What it does |
|---|---|
| System prompt strategy | AddOn appends to the default, Intro places it ahead of it, System replaces it entirely. |
| System prompt | The text that strategy applies. |
| Context | Extra standing text folded into the prompt for this character. |
| Post-history instructions | Text placed after the conversation — the last thing the model reads. |
| Max tokens / max sentences | Caps on the character's replies. |
| Image generation overrides | Prompt 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.