Settings
Settings & Tools
Settings is the control room for Ensoul — reachable from the sidebar. Everything here is stored locally on your device.
Profile
Write a short "About You" note — your name, how you like to be addressed, anything worth every companion knowing. It's shared across every companion so you never have to re-introduce yourself.
Models & API keys
Ensoul is bring-your-own-key. OpenRouter is the one fully active provider today — one key, most models. Direct keys for other providers (Anthropic, OpenAI, Google, DeepSeek, and more) are already fully wired up under the hood and unlock here one at a time as each is tested.
Set your default model here too — the model every conversation uses unless a companion has its own override (see Custom Companions).
Generation defaults
Temperature, Top P, and max reply length — the shared defaults every companion uses unless it sets its own override. Higher temperature is more varied and surprising; lower is more consistent and focused.
Notifications
Controls unprompted reach-outs — both the between-session heartbeat and mid-conversation drift (see Mood & Presence). Choose a frequency (Frequent, Normal, Rare, or Off) and a quiet-hours window where reach-outs are held back. "Off" disables unprompted messages entirely, not just the between-session ones.
Web access
Lets a companion search the web for anything current or outside its own knowledge, citing what it finds. Only takes effect for a model that actually supports it — currently Anthropic, Google, and some OpenRouter-routed models. The provider may bill separately for each search, on top of normal token costs, so this defaults off.
Voice
Text-to-speech (off by default — turn it on and choose a provider if you want replies read aloud) and voice dictation, which needs no configuration at all. See Voice Input.
Image generation
Set the OpenRouter model used for images, a preferred aspect ratio, and whether Ensoul should auto-detect when a message is asking for an image (versus only generating when you tap Generate explicitly). See Image Generation.
Appearance
Set a custom accent color, or reset to the default. Text size applies to message text and what you type, not buttons or labels. Theme (system, light, or dark) is set from the small icon at the bottom of the sidebar.
Data — backup & restore
Every companion, group, and moment, bundled into one file. API keys are never included in a backup — they live in Models & API keys and stay wherever you configured them.
