KoboldAI to TextGenWebUI JSON Conversion

The migration from **KoboldAI** to **TextGenWebUI** (oobabooga) represents a move from a backend-focused session save to a modern local inference application. While KoboldAI's format is primarily designed to preserve the state of an inference model's context window, TextGenWebUI requires character data to be structured into specific context and greeting fields to drive model behavior efficiently.

1. Overcoming Session Fragmentation

KoboldAI JSON files (typically used in legacy backends or Lite frontends) use a relatively flat structure with keys like description and scenario. TextGenWebUI thrives when character logic is synthesized into its specific context blocks. The name, description, personality, scenario, first message and example dialogue are mapped one-to-one from the KoboldAI data to TextGenWebUI.

2. Working with Oobabooga's Model Loader Ecosystem

TextGenWebUI is designed for the absolute depth of model orchestration, often running high-performance GGUF or EXL2 models. Standard KoboldAI saves are often optimized for smaller models with more limited context sensitivities. Your character is converted in full rather than shortened; trim it by hand if TextGenWebUI has a size limit.

3. Dialogue and Greeting Fields

We extract the KoboldAI first_mes and map it directly to the TextGenWebUI greeting field. 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 is critical because Oobabooga's models interpret dialogue cues differently depending on the selected loader. 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 the "Zero-Server" Advantage

Because character development represents a significant creative investment, we prioritize security. Our tool utilizes a "Zero-Server" architecture, where all JSON processing is handled by your browser's local JavaScript. Your character saves are never transmitted to our server or any third party. This provides a secure, private bridge for users who want to transition their creative assets to a more modern, local-first inference environment.

5. Identity and Metadata Fields

When you export to TextGenWebUI, our tool generates a standardized JSON file that is ready for instant use in your characters folder. This ensures that your legacy Kobold digital assets are integrated perfectly with the webui's library management features, facilitating easier organization and allowing you to leverage the full power of local model orchestration without losing the nuanced personalities you originally crafted.