1. Input: Your Pygmalion .json File

2. Output Portrait

Upload a PNG image to embed the character data into. This will become your card's visual identity.

Technical Normalization: Bridging the Gap

The Pygmalion format uses different key names than the TavernAI V2 specification. Our tool automates this complex mapping:

1. Key Translation Matrix

We map the following Pygmalion keys to their TavernAI V2 equivalents:

  • char_name → name
  • char_persona → personality
  • char_greeting → first_mes
  • world_scenario → scenario
  • example_dialogue → mes_example

2. Metadata Injection

Unlike raw JSON, a SillyTavern card is a binary image. We inject the translated data into the tEXt auxiliary chunk of your PNG. We use UTF-8 safe Base64 encoding to ensure that any complex characters or formatting from your Pygmalion source are preserved without corruption.

Step-by-Step Modernization

  1. Gather your JSON: Collect any old Pygmalion characters from your local storage or character hubs.
  2. Upload: Paste the JSON text or drop the file into Step 1 above.
  3. Add Image: Choose a high-quality PNG portrait for your character.
  4. Convert: Click "Generate" and download your modern V2 card.
  5. Enjoy: Import the PNG directly into SillyTavern or any compatible frontend.

FAQ: Pygmalion Migration

Q: Does this change the character's behavior?

A: No. The underlying prompt data remains the same. The conversion simply translates the labels so modern frontends can find the data.

Q: Can I convert multiple JSONs at once?

A: For batch processing, we recommend using our Universal Batch Converter tool on the homepage.