V3 (CharX) → Pygmalion

1. Unpacking the CharX container

A V3 card ships as a .charx file — a ZIP archive containing card.json plus optional assets. The tool parses the ZIP directory, locates the card JSON, decompresses it (store or deflate), and reads the chara_card_v3 object entirely in your browser.

2. Mapping to the Pygmalion schema

Pygmalion uses prefixed keys (char_name, char_persona, char_greeting, world_scenario, example_dialogue); the persona is down-converted to that legacy shape. The converter normalizes Character Card V3's field names onto a common persona model first, so the mapping is consistent regardless of how the source card was authored.

3. What transfers to Pygmalion

The core persona always carries across: name, description, personality, scenario, greeting (first_mes), and example dialogue are mapped directly onto the Pygmalion fields, along with tags and creator credit where supported. The converted character is handed back as a Pygmalion JSON file, ready to import directly into Pygmalion. V3-only extras such as extra bundled assets or group-only greetings are omitted when Pygmalion has no equivalent slot, but nothing in the core character is lost.

4. Private, client-side conversion

No servers, no accounts, no sign-up. The Character Card V3 archive is decompressed and read in your browser's memory using JavaScript, the persona is transformed locally, and the Pygmalion result is returned as a download. Because character cards often contain hours of personal writing, this zero-upload model keeps your work on your own device — you can confirm it in your browser's network tab.

How do I convert a Character Card V3 card to Pygmalion?

Upload your Character Card V3 .charx file above and click “Convert to Pygmalion”. The tool unpacks the archive, reads the card, maps it onto the Pygmalion schema, and gives you the converted card to download — all in your browser.

Is a Character Card V3 file the same as a .charx?

Character Card V3 characters are distributed as .charx files, which are ZIP archives containing the card JSON plus assets. This tool reads that archive directly.

Will the greeting and personality survive the conversion to Pygmalion?

Yes. The name, description, personality, scenario, greeting, and example dialogue are all preserved and written into the Pygmalion card. Only format-specific extras that Pygmalion cannot store are omitted.

Do I need to upload my card to a server?

No. The entire conversion runs client-side in your browser. Your Character Card V3 card is never transmitted anywhere, which is why it works even with the network disconnected after the page loads.