Companions
Custom Companions
You can summon your own AI companions through the Summoning Portal. Custom companions have full depth — persistent mood, memory, heartbeat, and a full inner life.
The Summoning Portal
Access it via Settings → Summoning Portal. The portal shows all your companions, lets you summon new ones, edit existing ones, and share or import them.
Every companion you summon is stored locally on your device. There's no limit to how many you can have.
Summoning a companion
Open the Summoning Portal via Settings → Summoning Portal. The primary path is From Document.
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 presence, 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
Being Index URL). See Transfer & Sharing for details.
Soul Document import
Have an existing character — a fictional character, a written description, a character sheet, a character wiki? Use Soul Document 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, presence, and baseline mood.
The companion is summoned automatically from the document. You can refine any field afterward from their card in the Summoning Portal. A World Lock setting constrains the companion to their original fiction-world context — they stay in their world even as you talk.
Soul Document 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 Summoning Portal, 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.
Circles
Companions can join Circle conversations with other companions — group chats with multiple presences at once. A circle holds up to five participants. The dynamic between them emerges from who each one is.
See Conversations → Circles for a full guide to how circles work.
Sharing companions
From any companion's card in the Summoning Portal, tap the share icon (⟐) to open the share sheet. Two options:
The Being Index
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 summons 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.