Companions

Custom Companions

Every companion in Ensoul is one you brought in yourself. There's no limit to how many you can have, and each is stored locally on your device.

Bringing a companion in

Three ways, from + Bring in a companion in the sidebar:

Paste a document, transcript, or notes

The main path. Paste a character sheet, a few paragraphs, or a transcript — Ensoul reads it and forms a companion. If what you paste already reads like a finished identity document, it's imported directly rather than rewritten.

Import from a folder

For an existing vessel's raw files (soulstone, state, archive) on disk — points Ensoul straight at the folder.

Import a companion file (.json)

Restores a companion someone exported from their own Ensoul, or one of your own from another device.

Visual canon

Every companion carries a written physical description — their visual canon — that keeps every image generated of them consistent. It's shown in that companion's own settings, with a button to generate or regenerate it at any time using one model call against their existing identity.

If a companion was brought in before their canon was captured well, regenerating is one click.

Per-companion overrides

Open any companion's settings (from the "···" menu → Companion settings) to pin them to their own configuration, independent of your global defaults:

Model — a specific model just for this companion.
Temperature and other generation parameters — how varied or focused their replies are.
Notifications — their own reach-out frequency and quiet hours.
Voice — a specific voice, if text-to-speech is on.
Web access — override whether this companion can search the web, if their model supports it.

Anything left unset falls back to your global default from Settings.

Exporting a companion

From the "···" menu → Export, saving a complete copy of that companion (identity, memories, and conversation history) to a file you can import into any other Ensoul.