Voxta to KoboldAI JSON Conversion

The migration from **Voxta** to **KoboldAI** is a technical process of translating a hardware-aware, multimodal "Companion Entity" into a format optimized for backend model orchestration. While Voxta provides high-immersion features, KoboldAI serves as the core inference engine for many users, and having your characters in a compatible save-state is essential for diverse testing and model tuning.

1. Key Schema Mapping

Voxta uses a rigid, PascalCase JSON structure designed to drive specialized weight-based inference. Fields like Personality and Description are used to calibrate multimodal responses. KoboldAI utilizes a more traditional flat-schema with lowercase keys. The name, description, personality, scenario, first message and example dialogue are mapped one-to-one from the Voxta data to KoboldAI.

2. UUID and Metadata Handling

Voxta characters are anchored by a globally unique identifier (UUID). KoboldAI save files are traditionally identified by their filename. Creator notes from the Voxta file are carried into the card's creator_notes field.

3. Dialogue and Example Text

Voxta dialogue examples (MesExample) are often formatted for Text-to-Speech (TTS) clarity. KoboldAI-compatible models perform best with clean, narrative-driven dialogue formatted for text completion. 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 Sovereignty

We understand that your creative companions represent a significant investment of time and creativity. 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 or any third party. This ensures that you maintain full ownership and control over your digital assets as you move them between the industry's leading local AI platforms.

5. Ensuring Backend Compatibility

By outputting a standardized KoboldAI JSON, we ensure that your Voxta companions can be used across a vast array of inference tools and specialized frontends. This conversion process is about future-proofing your digital characters and ensuring they remain accessible, editable, and compatible with the broader AI community standards, regardless of the evolving landscape of companion technology.