RisuAI (CharX) → CharacterAI

1. Unpacking the CharX container

RisuAI exports characters as CharX (.charx) — a ZIP built on the V3 spec, with a risuai extensions block for emotions, scripts and lorebooks. The tool unpacks the ZIP and reads the underlying chara_card_v3 card; Risu-only extensions are set aside.

2. Mapping to the CharacterAI schema

CharacterAI uses a flat definition (name, description, greeting, definition); the persona is mapped onto those fields. The converter normalizes RisuAI'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 CharacterAI

The core persona always carries across: name, description, personality, scenario, greeting (first_mes), and example dialogue are mapped directly onto the CharacterAI fields, along with tags and creator credit where supported. The converted character is handed back as a CharacterAI JSON file, ready to import directly into CharacterAI. V3-only extras such as extra bundled assets or group-only greetings are omitted when CharacterAI 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 RisuAI archive is decompressed and read in your browser's memory using JavaScript, the persona is transformed locally, and the CharacterAI 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 RisuAI card to CharacterAI?

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

Is a RisuAI file the same as a .charx?

RisuAI exports characters as .charx (CharX) archives, which are ZIP files built on the V3 spec. This tool reads that archive directly.

Will the greeting and personality survive the conversion to CharacterAI?

Yes. The name, description, personality, scenario, greeting, and example dialogue are all preserved and written into the CharacterAI card. Only format-specific extras that CharacterAI 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 RisuAI card is never transmitted anywhere, which is why it works even with the network disconnected after the page loads.