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 Normalization

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. Our converter identifies these specialized Voxta keys and intelligently maps them into the standard Kobold fields, ensuring the character's internal logic remains consistent during the transition.

2. UUID and Metadata Handling

Voxta characters are anchored by a globally unique identifier (UUID). KoboldAI save files are traditionally identified by their filename. Our converter preserves the relevant identity metadata within the new JSON to ensure that your characters remain manageable and that any creator-specific notes are correctly placed in the description or scenario blocks, preventing the character from losing its "soul" when used outside the Voxta ecosystem.

3. Dialogue and Example Sanitization

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. Our engine scans the Voxta source, removes hardware-specific artifacts, and reformats the dialogue into the standardized patterns required by the models you run via KoboldCPP, maintaining the character's unique cadence and speaking style.

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.