CharaStudio

Supported Import Formats

CharaStudio supports importing the following TavernAI-compatible formats:

  • PNG files (embedded JSON metadata): Character cards exported from TavernAI
  • JSON files: Directly exported character data
  • TXT files: Plain text format containing only the description
  • YAML files: YAML format used by some tools

Import Steps

Method 1: Drag and Drop

  1. Open CharaStudio and go to the "Characters" workspace
  2. Drag a PNG/JSON file into the blank area
  3. CharaStudio will automatically parse the file contents
  4. After confirming the preview, click "Import"

Method 2: File Picker

  1. Click the "Import" button in the top-right corner
  2. In the file picker dialog, select the files to import
  3. Multi-select is supported for importing multiple characters at once

Method 3: Import from URL

  1. From the "Import" menu, select "Import from URL"
  2. Paste the TavernAI community character card URL
  3. CharaStudio will automatically download and parse

Post-Import Checks

After importing, please verify the following:

  1. Avatar Image: Confirm the character image displays correctly
  2. Description Text: Check if the description has any garbled or truncated text
  3. Personality Tags: Confirm the personality field was parsed correctly
  4. Opening Line: Check if the first_mes matches expectations

Exporting to TavernAI

CharaStudio supports exporting characters in TavernAI-compatible format:

  1. Open the character you want to export
  2. Click "Export" > "TavernAI Format"
  3. Choose export options:
    • PNG (TXT): Write metadata to the image's text layer
    • JSON: Standard JSON format
  4. Download the file and copy it to TavernAI's characters folder

FAQ

Image Display Issues After Import

Some TavernAI character cards use external CDN-hosted images. After importing, CharaStudio will automatically download and cache images locally. If the network is slow, images may take a few minutes to display.

Garbled Description Text

This is usually because the original character card uses non-UTF-8 encoding. CharaStudio attempts to auto-detect encoding. If text is still garbled, manually copy the description to an external editor, convert the encoding, and re-import.