User Guide

Settings

Seven tabs. Open Settings from the sidebar footer or the account menu.

Player

How personas refer to you during chats and scenarios. These values are sent into prompts, so they show up in the conversation. They don't change your account username, which lives under Profile.

Nicknameup to 50 charactersWhat personas call you in-game.

Pronounsup to 100 characters, free textshe/her, he/him, they/them, or whatever wording you prefer.

Body information used in playup to 100 charactersOnly appears when NSFW is on. Short detail used by intimate scenes.

Empty a field to clear it. The button at the bottom says Save Player Settings.

Appearance

Theme picker plus, for Supporter+, a builder for designing your own.

Built-in themes

Free accounts can use Velvet Tribute and Think Pink. Supporter unlocks six more. Supporter+ adds Obsidian Velvet, Honeyed Dusk, Cyber Bloom, and Sanguine Cathedral.

Custom themes (Supporter+)

Build a theme in the customiser, export it as JSON, import one someone shared with you.

AI Providers

Where the model that writes responses lives. Five tabs across the top.

Built-Inhosted by usNo API key. The panel shows your monthly token allowance and reset date. Free gets 300K tokens per month, Supporter 1.75M, Supporter+ 6M.

OpenRouteryour key, 100+ modelsPaste the key, save, wait for the model list to populate, then pick a primary and an optional fallback.

Ollamalocal serverDefault base URL http://localhost:11434. The test button confirms the server is reachable before saving.

LM Studiolocal serverDefault base URL http://localhost:1234. Same test-and-save pattern as Ollama.

Customlegacy pathParked. The tab points you at one of the four supported options above.

ℹ

Local Storage mode and the provider choice are independent. If Local mode is on but the provider is remote, the panel warns you that prompts still leave the device. Local mode controls where your chat history is stored, not where the model runs.

Image Generation

When images appear in chat and which backend draws them.

Photo Behavior

Three choices. Let the AI send pics is the default and lets the model decide when an image fits the scene. Send pics every few turns auto-sends on a cadence you set. Turn photos off disables generation but keeps the rest of the config around for later.

Image Backend

Cloud (Ethumia) is the hosted option and needs no setup. ComfyUI and Automatic1111 point at a local server — default URLs are http://localhost:8188 and http://localhost:7860 respectively. Automatic1111 needs to be started with --api.

Advanced Render Controls

Collapsed by default. They only show up for local backends. Width, height, steps, CFG scale, a seed policy (random or fixed), plus sampler and scheduler controls for the chosen backend. Automatic1111 also exposes Hires Fix and Restore Faces toggles.

Content

The NSFW toggle and any age check tied to it. Turning NSFW on may require a one-time check depending on the country your account is in.

Where required, the check is a local-only facial age estimate. The image stays on your device and is not uploaded. Cooldowns and remaining attempts are displayed on the panel when relevant.

Privacy

Storage mode, archive export and import, and a destructive Danger Zone at the bottom.

Storage Mode

Shows your current mode (Cloud or Local) and a button to switch to Local. Going the other direction needs a migration step, which the app walks you through.

Export and import

Export Data writes a ZIP of personas, conversations, memories, summaries, and (in Local mode) extensions and included settings. API keys, login state, and extension secrets are never in the archive.

Import Data previews the archive (counts of personas, sessions, messages, memories, summaries, plus the export date) before you commit. A checkbox controls whether the import merges with existing local data or replaces it.

Clear All Local Data sits in the Danger Zone at the bottom. It does what it sounds like, behind a confirmation step.

Advanced

Emergency stop, developer mode, and the local extension workspace.

The Toy Emergency Stop card lets you reveal the e-stop button in the top bar and lists which installed extensions support it — both the ones available and the ones currently armed.

Developer Mode grants one local-extension slot outside the normal install limit and is required to use the Dev Extensions page. The browser needs the File System Access API. Show developer features surfaces the Dev Extensions sidebar entry and the reload button in the top bar.

Local extension folder is the parent directory the app scans. Each extension lives in its own subfolder with a manifest.json and one JS module.

⚠

Developer Mode settings expire after 7 days. Reloading or installing a dev extension renews the window. If you stop using them, they switch off on their own.