CharacterAI to TavernAI (V2 PNG) Conversion

The process of moving a character from **CharacterAI (c.ai)** to **TavernAI (V2 PNG)** involves a paradigm shift in data handling. On CharacterAI, your character is a collection of fields managed by a central database. In the TavernAI ecosystem, your character is a self-contained, portable binary object (a PNG file) carrying its own "DNA" in its metadata chunks.

1. Overcoming Format Asymmetry

CharacterAI utilizes a relatively flat schema, where the core logic is hidden within the Definition (Advanced) field. This field often contains a mix of descriptive traits, world-building, and example dialogues. The name, description, personality, scenario, first message and example dialogue are mapped one-to-one from the CharacterAI data to TavernAI.

This asymmetry is the primary reason why simple "copy-pasting" often results in poor character performance.

2. The Binary Injection Process

Unlike CharacterAI, where the image is just a decorative asset, a TavernAI V2 card is a functional data container. Our tool uses a specialized binary injector written in browser-based JavaScript. When you provide a PNG image (or use our default template), the converter performs the following steps:

• Metadata Chunk Creation: We encode the character JSON as UTF-8 Base64 and write it into a standard PNG tEXt chunk with the chara key, plus a compressed zTXt copy.
• Binary Splicing: We locate the IEND (end of file) chunk of your image and splice our new metadata chunks just before it, ensuring the image remains valid and viewable by any standard viewer while carrying the hidden data payload.
• V2 Specification Adherence: We strictly follow the TavernAI V2 spec, ensuring that the spec and spec_version fields are correctly defined so that frontends like SillyTavern can instantly recognize and parse the card upon import.

3. The Definition Field

CharacterAI users often use specialized formatting such as {{char}}: "Dialogue" or specific brackets like (persona: ...). TavernAI and local frontends prefer a cleaner, token-agnostic format. The converter maps fields only; apart from the small changes listed below, it does not edit, clean up or reformat the text inside them. This prevents "token leaking" where the AI literally types out its own metadata during a chat.

4. Privacy and Data Sovereignty

The most crucial aspect of this conversion is that it happens entirely within your browser's RAM. CharacterAI's terms of service and data collection policies are often a concern for privacy-minded creators. By moving your characters to the TavernAI format, you are physically holding the data on your hard drive. Our tool facilitates this "Reclamation of Identity" without ever seeing or storing the data you are porting.

5. Ensuring Cross-Platform Compatibility

While the goal is to target TavernAI, our generated V2 cards are intentionally designed to be "Universal." Because we adhere to the standard chara key mapping, the PNG card you generate here will also be compatible with **SillyTavern**, **Faraday (Backyard AI)**, **Agnai**, and even newer companion apps like **Voxta**. You are not just converting to one tool; you are upgrading your character to a globally recognized digital persona standard.