1. Upload KoboldAI JSON
Technical Documentation: Mapping Kobold Saves to Backyard Entities
The transition from **KoboldAI** to **Backyard AI** (formerly Faraday) represents a shift from a backend-focused storage model to a sophisticated local roleplay application. KoboldAI's JSON format is primarily designed to save the state of a model's context, whereas Backyard AI's schema is optimized for managing a persistent library of characters with diverse behavioral instructions.
1. Field Mapping
KoboldAI JSON files typically use a flat structure with fields like description, scenario, and first_mes. Backyard AI thrives when these fields are precisely defined to drive its model orchestration engine.
2. World Info and Lorebooks
One of the most complex aspects of KoboldAI characters is their reliance on "World Info" (WI) entries. Backyard AI handles character knowledge through a distinct memory system. Because Backyard AI has no lorebook field here, any lorebook in the source card is written out as a "World Info:" list inside the scenario.
3. Dialogue and Greeting Migration
Backyard AI utilizes a specific dialogue format to maintain immersion. We map the Kobold first_mes directly to the Backyard first_mes field. This normalization is critical because different model frontends interpret dialogue cues differently. The converter maps fields only; apart from the small changes listed below, it does not edit, clean up or reformat the text inside them.
4. Privacy and Data Security
Because character development often involves personal creative effort, we prioritize security. Our tool utilizes a "Zero-Server" architecture, where all JSON processing is handled by your browser's local JavaScript. Your character files are never transmitted to our server, cached, or seen by any third party. This ensures that you maintain full ownership and control over your creative digital assets as you move them between platforms.
5. Identity and Metadata Fields
The Backyard AI file contains the core character fields only; the converter does not add tags or version information. This ensures that your character is not just a raw text file, but a "Ready-to-Play" digital asset that integrates perfectly with Backyard AI's library management and model orchestration features.
