CharaStudio Character Card Structure

CharaStudio uses an extended JSON format for storing character data. The basic structure is as follows:

{
  "name": "Character Name",
  "description": "Character description (used for AI understanding)",
  "personality": "Personality tags",
  "first_mes": "Opening line",
  "avatar": "Base64 encoded avatar image or URL",
  "chat_example": "Dialogue examples",
  "chara_version": "1.2",
  "spec_version": "CharaStudio-v1"
}

Extended Fields

CharaStudio adds the following extended fields to the standard TavernAI format:

{
  "chara_version": "1.2",
  "spec_version": "CharaStudio-v1",
  "world_setting": {
    "default_world": "Default world name",
    "allowed_scenes": ["Scene 1", "Scene 2"]
  },
  "emotion_config": {
    "emotion_nodes": ["Joy", "Anger", "Sadness", "Fear"],
    "default_emotion": "neutral"
  },
  "generation_params": {
    "temperature": 0.8,
    "max_tokens": 512,
    "top_p": 0.9
  }
}

Field Descriptions

description

The most important field. This field is sent directly to the AI model to understand the character's complete profile. Recommended content includes:

• Physical appearance description
• Personality traits
• Speech style
• World setting relationship
• Relationship network

personality

Comma-separated personality tag list, for example:

Calm, Reserved, Loyal, Observant, Somewhat aloof

first_mes

The character's first line at the start of a conversation. This line should:

• Match the character's personality
• Spark the user's interest in interaction
• Not contain story spoilers

chat_example

Dialogue examples (usually 2-3 pairs), used to help the AI learn the character's speaking style:

{{user}}: Who are you?
{{char}}: I am... (character's response)
{{user}}: Tell me about your past.
{{char}}: ...

Export Format Comparison