Skip to content

Characters & personas

A character is who you talk to. A persona is who you are in the scene. Pyre keeps both as local, portable cards.

Character cards

Characters use the chara_card_v2 field set used by the wider Tavern ecosystem.

Field What it holds
description Core appearance, background, traits, and roleplay facts.
personality Disposition summary.
scenario The starting situation.
first_mes The opening message.
mes_example Example dialogue for voice.
system_prompt Per-character system instruction.
post_history_instructions Instructions injected after chat history.
alternate_greetings Extra swipeable openings.
tags Free-form labels for filtering.
creator, character_version, creator_notes Authorship and notes.
talkativeness How readily the character speaks, especially in groups.
Depth prompt A note inserted at a fixed depth in the conversation.
character_book Embedded lorebook / World Info.
extensions Opaque data from other apps, preserved on round trip.

Personas

A persona is a reusable profile for your side of the scene. A persona can have:

  • name,
  • description,
  • avatar,
  • dialogue examples,
  • bound lorebooks.

Dialogue examples are first-person voice samples. They help normal replies understand your persona, and they also feed Impersonate me and Guide my message so drafted turns sound like that persona.

You can set a global default persona, ask Pyre to choose on every new chat, or pick No persona for a chat.

Persona party

A chat can use more than one persona on your side. Pick a roster of personas and Pyre treats your messages as coming from the group: each persona's description, dialogue examples, and bound lorebooks participate in the prompt, your bubble shows a stacked avatar cluster, and {{user}} resolves to the joined names.

Use persona party when you want to play a duo, a crew, or multiple point-of-view characters without flattening them into one oversized persona.

Add as persona

Any character can become a persona with Add as persona. Pyre auto-swaps {{char}} and {{user}} in example dialogue so the speech rhythm reads as yours. The character's mini-gallery images are copied to the new persona too.

Organizing your library

As your collection grows, Pyre gives you:

  • Favorites to float important cards.
  • Folders so one card can live in multiple user-created groups.
  • Tags from card metadata.
  • Search by name and text.
  • Sorting for common library views.
  • Duplicate for characters and personas, so you can fork an edit without re-importing.

Group chat entry points

You can start a group chat from the Chats tab, from a character menu/details sheet, or by opening a chat title's member sheet and adding people. Pyre offers Party Mode when a chat becomes a group, but you can keep the responder-chip flow if you prefer single-speaker turns.

Per-chat snapshots

Each chat freezes a snapshot of the character or characters it uses. Editing a card later does not rewrite old conversations. In group chats, snapshots keep per-message attribution correct even if a character is later edited or removed.

Deletions that sync

Deleting a character, persona, chat, lorebook, or folder leaves a short-lived deletion record for sync. That lets paired devices learn that the item was deleted instead of bringing it back the next time they connect.

The details sheet shows the full card, chat count, mini-gallery, and quick actions: start chat, edit, Edit with AI, duplicate, or export.

Mini-gallery images are extra images beyond the avatar. They can come from imported cards or be added in Pyre, and they copy across when you use Add as persona.

Avatar framing and recrop

Pyre biases circular thumbnails toward the face so portrait art reads well in lists.

Recrop is non-destructive. The thumbnail uses your crop, but the full original stays stored for chat backdrops, lightbox viewing, later recrops, export, backup, and sync.

Tap an avatar in supported places to view the full image.

See also