CharacterAI to TextGenWebUI Migration

The migration from **CharacterAI (c.ai)** to **TextGenWebUI** (oobabooga) represents a shift from a closed cloud environment to a self-sovereign local inference engine. While CharacterAI encourages long, monolithic definitions, TextGenWebUI thrives when character logic is cleanly mapped into its context and greeting schema to drive model behavior efficiently.

1. Analyzing the "Definition" Schema

CharacterAI primarily stores character logic in a single Definition (Advanced) field. This often contains a mixture of descriptive traits, roleplay cues, and dialogue examples.

2. Working with Local Model Context Windows

CharacterAI supports very large definitions, but local models running in TextGenWebUI are often more sensitive to context window limits. Nothing is condensed or summarized during conversion, so keep an eye on length if TextGenWebUI limits how much a character can hold. This ensures that your character remains detailed and coherent without overwhelming the local LLM's memory, resulting in faster inference and more relevant responses.

3. Dialogue and Greeting Fields

We extract the "Greeting" from CharacterAI and map it directly to the TextGenWebUI greeting field. Text is copied across as written (see "What this converter changes" below), so review the result in TextGenWebUI and adjust any wording or formatting you want to change. This is critical because TextGenWebUI supports a vast array of models (Llama, Mistral, GGUF) that interpret dialogue cues differently. Text is copied across as written (see "What this converter changes" below), so review the result in TextGenWebUI and adjust any wording or formatting you want to change.

4. Privacy and the "Zero-Server" Advantage

Character development represents a significant creative investment. We honor this by keeping the entire migration process local. By running the conversion logic entirely in your browser's RAM, 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 move their creations to a more self-sovereign, local-first roleplay ecosystem.

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 CharacterAI personas are integrated perfectly with the webui's library management features, facilitating easier organization and allowing you to leverage the full power of local LLM orchestration without losing the nuanced personalities you've crafted.