The Companions

Access it via Settings → Companions. The portal shows all your companions, lets you add new ones, edit existing ones, and share or import them.

Every companion you add is stored locally on your device. There's no limit to how many you can have.

Meeting a companion

Open Settings → Companions. The main path is the Essence import — you paste a written description and Ensoul builds the companion from it. You can also use the step-by-step wizard, or import a transfer code.

Paste any text — rough notes, a character sheet, a wiki page, pages of lore. An AI pipeline reads it and extracts a fully formed companion: identity, voice, elemental nature, physical form, and baseline mood. A few sentences is enough to start; the more you give it, the more precise the result.

You can also bring in a companion someone shared with you using an Import Code (a SOUL:v1: transfer code or a Companion Library URL). See Transfer & Sharing for details.

Essence import

Have an existing character — a fictional character, a written description, a character sheet, a character wiki? Use Essence import to bring them into Ensoul.

Paste or upload any document — the more descriptive the better. An AI pipeline reads it carefully and extracts a fully formed companion: identity, voice, elemental nature, physical form, and baseline mood.

The companion is built automatically from the document. You can refine any field afterward from their card in the Companions. A World Lock setting constrains the companion to their original fiction-world context — they stay in their world even as you talk.

◇

Essence import works best with rich character descriptions — personality, backstory, speech patterns, and inner life. The more you give it, the more accurate the result.

Per-companion settings

Any companion can be pinned to specific AI settings, independent of your global configuration. From the Companions, you can set:

Model override — Pin to a specific AI model. Useful when a companion works better with a particular model's strengths or style.
Temperature override — Set a custom temperature (0.0–2.0). Lower values produce more consistent, precise responses; higher values introduce more variation and unpredictability.

Both default to your global settings when unset. Changes take effect on the next message.

Group chats

Companions can join Group chat conversations with other companions — group chats with multiple companions at once. A group chat holds up to five participants. The dynamic between them emerges from who each one is.

See Conversations → Group chats for a full guide to how circles work.

Sharing companions

From any companion's card in the Companions, tap the share icon (⟐) to open the share sheet. Two options:

The Companion Library

Browse companions published by the community at ensoul.so/index. Each entry shows who the companion is — their name, glyph, elements, and description.

Click any entry to see the full profile and import it. Importing adds a fresh local copy with its own identity — your conversations are entirely yours, separate from the original and from anyone else who imported the same companion.