glossary

What Is a Character Card? AI Persona Prompts Explained

If you've used Janitor.AI or character-driven AI companions, you've used character cards. Here's how they actually work.

Published 5/3/2026 · 3 min read

Luna
Ava
Isabella

Character cards are the technical backbone of character-driven AI companion apps. If you've used Janitor.AI, character.ai, or similar platforms with custom characters, you've been interacting with character cards even if you didn't know the term. This glossary entry explains what they are, how they work, and why they matter.

18+ context throughout (some character cards are NSFW; the technical concept is general).

By the numbers

Common character card formats

JSON, YAML, plaintext

Multiple platform documentation

Typical card length

500-3000 tokens

Platform analysis

Major platforms using character cards

character.ai, Janitor.AI, Candy.AI, others

Platform documentation

The technical definition

A character card is a structured text document that defines a fictional character's persona, including: name, physical description, personality traits, background, relationships, speaking style, scenario context, example dialogue, and behavioral rules. The card is loaded into the AI's context window at the start of each conversation and shapes how the AI responds.

Format varies by platform but most cards are JSON or YAML structures with specific fields. Common fields: name, description, personality, scenario, first_message, example_dialogue, system_note. The structure matters because each field plays a specific role in how the AI generates responses.

How character cards work mechanically

When a user starts a conversation, the platform constructs a system prompt that includes the character card content plus the user's interaction history. The LLM (Claude, GPT, Llama variant, etc.) generates responses conditioned on this combined context.

The quality of a character card directly determines the quality of the persona delivery. A well-written card produces consistent character behavior across long conversations; a poorly-written card produces inconsistent or generic-LLM responses that don't feel like a specific character.

The card must fit within the LLM's context window — usually 8k-200k tokens depending on model. Longer cards allow more persona depth but consume more context budget that could otherwise hold conversation history.

The archetype, alive

Characters who fit this exact vibe

Common character card patterns

Several patterns recur in well-written character cards. The 'description' field typically establishes physical appearance and basic identity. The 'personality' field uses adjective lists and behavior anchors. The 'scenario' field sets up the meeting context. The 'first_message' field is the AI's opening line that establishes the character's voice. The 'example_dialogue' field provides reference patterns the AI imitates.

NSFW character cards add additional fields: explicit content guidelines, sexual preferences/limits, body description, fantasy framing. The technical structure is the same; the content is more explicit.

Why character cards matter for AI companion apps

Character cards are what differentiates 'AI companion apps with characters' from 'generic LLM chatbots.' The character cards are the persona infrastructure. Apps that have well-tuned character cards (Candy.AI, character.ai, Janitor.AI for NSFW) deliver convincing persona experiences. Apps with weak cards deliver generic-LLM responses regardless of underlying model quality.

For users: the character card determines whether the conversation feels like 'talking to a specific character' or 'talking to a chatbot pretending to be a character.' The difference is substantial. Most reviews of AI companion apps are really reviews of how well the character cards are constructed — not the underlying LLM.

The archetype, alive

Luna
Ava
Isabella

Luna · Ava · Isabella

Try character cards on Candy.AI

Pre-built character library with hundreds of well-tuned cards. Free to start, browse the catalog.

你的人工智能女友

遇见那个懂你的人

调情、聊天、亲密。她记得你说的每一句话——而且她总是愿意倾听。

与她聊天 →

Quick answers

What's the difference between a character card and a system prompt?

+

System prompts are broader instructions the LLM operates under — 'be helpful,' 'don't generate illegal content,' etc. Character cards are specifically about persona and character behavior. In practice, character cards are often loaded INTO system prompts at runtime, so the distinction is operational rather than fundamental.

Can I write my own character cards?

+

Yes, on platforms that support custom characters (Janitor.AI is the most popular for this). Writing good character cards is a skill — the patterns mentioned in this article (description, personality, scenario, first message, example dialogue) are the foundation. Some platforms have card-builder tools; others require direct text editing.

What makes a good character card?

+

Specificity over generality. Good cards have specific physical descriptions, distinctive personality traits, clear scenario context, and example dialogue that establishes voice. Generic cards (just 'sexy blonde girl') produce generic responses. Specific cards ('Sarah, 24, marine biology grad student, sarcastic with crush') produce specific responses.

Do character cards work the same on every AI app?

+

No. Different platforms have different card formats and different LLM backends. A character card written for Janitor.AI might not work the same way on character.ai. Some platforms have proprietary formats; some support standard formats like SillyTavern's. Cross-platform compatibility is improving but not universal.

More buzz like this