Skip to content

Setting Up Characters

Vitor Lima edited this page Sep 7, 2025 · 4 revisions

The Characters page lists every character you’ve added to NarratrixAI. From here you can browse cards, search, and filter by tags. Characters are first-class citizens: the details you enter flow directly into Chat / Worlds via templates, avatars, and expressions.

image

  • Personality and name can be pulled into any Chat Template using placeholders.
  • Avatars appear on every message the character sends in Chat/World.
  • Expression Packs drive dynamic images in the Expressions panel during chats.

Top bar actions:

  • Search by name
  • Refresh avatars/images (useful after editing files on disk)
  • Import a character (SillyTavern, Character Card v2/v3, PNG)
  • Change cards per row and sort order
  • Add Character

Creating a Character

  1. Click Add Character and enter a Name.
  2. Optionally add Tags to help with filtering later.
  3. Write a Personality / Description.
  4. Click Save.

Tip: When adding tags, press enter to insert the tag.

image


Personality / Description

This text is available to your Prompt Format Template through placeholders like {{character.personality}}. Despite the field name, how you wire it into your template determines how the LLM uses it.

What to include for roleplay:

  • Physical description and notable traits
  • Voice and mannerisms
  • Psychological profile, motivations, and flaws
  • Abilities, limits, important relationships
  • Canon facts you want consistently enforced

Expression Pack

Expression Packs power the Expression panel in Chat / Worlds so the character’s image can change based on mood or context.

image

How it works:

  • Each image is an “expression.” The file name becomes the expression name.
  • The LLM uses those names to pick which image to show (e.g., “smile”, “angry”, “thinking”).

Add expressions:

  • Click the plus tile and select image files, or
  • Drag and drop images into NarratrixAI

Management tips:

  • You can rename an expression after import.
  • Images are copied into the app’s character folder. Use Open Folder to edit or replace files directly, then click Refresh.

Tip
Use clear, consistent names (e.g., neutral, happy, sad, angry, surprised). Short, lowercase names work best.


Custom System Prompt

Use this field to override the system prompt defined in your Prompt Format Template for this specific character.

  • Leave it blank to use the global/template system prompt.
  • When set, it replaces the entire system section for messages authored by this character.

Caution
Overrides apply broadly. If responses drift, compare this custom prompt with your Chat Template’s system instructions to avoid conflicts.


Character Lorebooks

Attach one Lorebook to a character to inject character-specific knowledge automatically whenever the character replies.

image

You can:

  • Select an existing Lorebook, or
  • Create a new one from this tab

When the character responds in Chat / Worlds, relevant Lorebook entries are injected according to your Chat Template and Lorebook settings.


Imports

From the Characters page, you can import:

  • SillyTavern characters
  • Character Card v2/v3
  • PNG cards with embedded metadata

Clone this wiki locally