Welcome to Abolitus

Welcome to the Abolitus documentation.

Abolitus is a local-first AI roleplay workspace built around one simple rule: your stories should belong to you. Chats, characters, personas, lorebooks, prompt presets, and most day-to-day work happen in your browser first. Premium features can add encrypted cloud convenience, but the trust boundary does not move. Your provider keys and your unlocked vault state stay on your device.

This documentation is written from the user point of view. It focuses on what Abolitus does, when to use each feature, what stays local, what can sync, and where the important limits are.

What Abolitus Is Good At

• Long-form roleplay with strong character consistency.
• Private local storage with optional encrypted cloud sync.
• Bring-your-own-provider workflows instead of a forced house model.
• Deep worldbuilding through lorebooks, personas, summaries, and local retrieval.
• Fast switching between cloud, local, and desktop-tunnel model routes.
• Power-user controls for prompts, samplers, commands, quick replies, and diagnostics.

What Abolitus Is Not

• It is not a hosted AI model service. You connect your own provider route.
• It is not a plain chat frontend with one global model. Character, room, and device choices can all matter.
• It is not a custody service for your secrets. If you lose local recovery material, Abolitus cannot recover it for you.

Free vs Premium

You can use Abolitus without Premium for local chat, local providers, OpenRouter routing, NanoGPT routing, characters, personas, lorebooks, commands, quick replies, samplers, and most day-to-day roleplay workflows.

Premium pays for encrypted cloud convenience features:

• Background E2EE cloud sync.
• Desktop-hosted local model tunnel.
• Related premium control-plane flows used to move encrypted state between devices.

Premium does not replace your provider bill. If you use OpenRouter, NanoGPT, or another compatible route, you still pay that provider separately.

Supported AI Routes

Abolitus currently supports these main connection types:

• OpenRouter for browser-safe cloud access to a large model catalog.
• NanoGPT for crypto-friendly cloud access.
• Local OpenAI-compatible endpoints such as Ollama, LM Studio, and similar compatible servers.
• Desktop Tunnel for securely using a desktop-hosted local model from another device.

Depending on what your chosen route exposes today, you may see current model families such as Claude Opus 4.7, GPT-5.5, Gemini 3.1 Pro, and Gemma 4. Availability is controlled by your provider route, not bundled by Abolitus.

How Your Data Is Split

This is one of the most important concepts in the whole product.

Stays on this device

• API keys and provider endpoints.
• Active provider selection for this device.
• Theme and wallpaper.
• Password-based local unlock settings.
• Recovery-confirmation state.
• Diagnostics toggles.
• TTS provider credentials.

Can sync across devices

• Default persona.
• Prompt wrappers and wrapper presets.
• Sampler presets.
• Group-chat defaults.
• Quick replies and custom slash commands.
• Author's Note and related creative settings.
• Prompt-pruning choices and other creative behavior settings.

If you remember only one rule, remember this one: your creative workflow can sync, but your provider secrets do not.

Recommended Reading Order

1. Getting Started

Read Getting Started if you are new. This section explains setup order, provider selection, API key handling, first-chat flow, and the most common mistakes.

2. Core Features

Read Core Features next if you want to understand how Abolitus actually feels in day-to-day use: personas, lorebooks, group chat, TTS, routing, appearance, tunnel access, and device handoff.

3. Advanced Configuration

Open Advanced Configuration when you want more control over model behavior, context pressure, routing fallback, prompt wrappers, quick replies, slash commands, and sampler tuning.

4. Settings

Use Settings when you want a practical reference for what each setting does, what it affects, and whether it stays local or syncs.

5. Migration Guides

Read Migration Guides if you are importing character cards, old chats, or worldbuilding material from another tool.

6. Security

Read Security if you want the trust-boundary details: what Abolitus can and cannot see, how vault protection works, and how the privacy model is enforced.

7. Billing

Read Billing if you need a clear breakdown of what Premium unlocks and what stays free.

8. FAQ

Use FAQ for quick answers about forgetting, recovery, sync, refusals, and support.

Good First Goals

If you want the smoothest first experience, aim for this order:

1. Connect one provider route.
2. Import or create one character.
3. Set a default persona.
4. Add one lorebook entry.
5. Check your token budget while chatting.
6. Save one sampler preset and one prompt preset.
7. Decide whether you want local-only use or Premium sync convenience.