Convert KoboldAI JSON to CharacterAI (c.ai)

The migration from **KoboldAI** to **CharacterAI** involves a transition from a backend-centric data model to a frontend-centric cloud service. KoboldAI save files are designed primarily to maintain the state of an inference model's context, whereas CharacterAI utilizes a proprietary, highly structured system designed to drive its "Advanced Definition" engine.

1. Analyzing the "Definition" Monolith

CharacterAI primarily relies on a single "Definition (Advanced)" field to store the character's core logic. This block often contains a mixture of W-style descriptions, roleplay cues, and dialogue examples. KoboldAI JSON files utilize a flat structure with specific field names like description and scenario.

2. Character Count and Tokens

CharacterAI enforces strict character limits on its "Short Description" and "Greeting" fields. KoboldAI files often contain sprawling introductory text. Your character is converted in full rather than shortened; trim it by hand if CharacterAI has a size limit. This ensures that your ported character remains coherent and manageable within the CharacterAI interface.

3. Dialogue and Greeting Fields

CharacterAI uses a simplified dialogue format to maintain model stickiness. We extract the "First Message" from your Kobold source and map it to the CharacterAI greeting field. This normalization prevents "token leaking" where the AI types out roleplay tokens or raw JSON keys, ensuring a smooth and immersive transition from local to cloud-based roleplay.

4. The Security of Local Browser Execution

Character development represents a significant creative investment. We honor this by performing all extractions and mapping locally. By running the conversion logic entirely in your browser's RAM using JavaScript, we ensure that your proprietary character definitions are never transmitted to our server or any third party. This provides a secure, private bridge for users who want to transition their legacy creations to the CharacterAI ecosystem while maintaining absolute control over their data during the process.

5. Identity Across Platforms

The name, description, personality, scenario, first message and example dialogue are mapped one-to-one from the KoboldAI data to CharacterAI. By meticulously mapping the behavioral instructions from your local Kobold saves into the cloud-native schema, we guarantee that your characters maintain their "soul" and unique personality traits. You aren't just moving a file; you are future-proofing your digital creations and ensuring they remain accessible and editable within the industry's largest character community.