Quickstart

1. Sign Up / Log In

Ensoul Studio uses Google OAuth for authentication. Click Sign In in the top navigation bar and authenticate with your Google account.

New accounts are automatically created on first sign-in — no separate registration step needed.

2. Take the Guided Tour

On first sign-in, Ensoul Studio offers an interactive guided tour that walks you through the entire interface. The tour covers 7 sections with 28 steps:

You can restart the tour at any time from Settings.

3. Explore the Demo Domain

Ensoul comes with a pre-seeded demo domain containing 100 personas across multiple archetypes. Navigate to Domains in the sidebar and select the demo domain to explore it.

Inside the domain view, you can:

• Browse all 100 personas with their trait profiles
• Filter by archetype, tier, or trait ranges
• View individual persona detail pages with full personality vectors
• See the domain's tier structure, archetypes, and configuration

4. Chat with a Persona

Select any persona and click Chat to start a 1:1 conversation. This is the chat query mode — a direct conversation with a single persona.

Try asking about their preferences, opinions, or how they'd handle a situation. Notice how responses reflect the persona's unique trait profile — a highly extraverted persona will respond differently than an introverted one, even to the same question.

5. Try Multi-Chat

Navigate to Multi-Chat to start a group conversation with multiple personas. Select 2-6 personas and pose a question or scenario.

Each persona responds in character, reacting not just to your prompt but to what other personas have said. This is useful for:

• Focus group simulations
• Exploring diverse perspectives on a topic
• Testing how different personality types interact

6. Run an Aggregate Query

Navigate to Aggregate to query your entire population at once. Ask a question and Ensoul will gather responses from multiple personas, then synthesize population-level insights.

Aggregate queries support two modes:

7. Create Your Own Domain

Ready to build your own personality space? Navigate to Domains and click Create Domain. Ensoul's AI-assisted wizard walks you through seven steps:

The AI wizard can suggest archetypes and trait distributions based on your domain description, or you can configure everything manually.

8. Connect via API

Everything you did in the UI is also available through the REST API and official SDKs. To get started programmatically:

Get an API key

Go to Settings → API Keys and click Create API Key. Give it a name and copy the key. You'll only see it once.

Install an SDK

pip install ensoul

npm install @ensoul-ai/sdk

Make your first call

from ensoul import Ensoul

client = Ensoul(api_key="your-api-key")

# List personas in a domain
personas = client.personas.list(domain_id="your-domain-id")
for persona in personas.auto_paging_iter():
    print(persona.name)

# Chat with a persona
response = client.chat.send(
    persona_id=personas.items[0].id,
    message="Tell me about yourself."
)
print(response.response)

What's Next?

You've explored the core workflows. Here's where to go from here:

Use Cases

See how Ensoul can be applied:

• Research — Synthetic populations for behavioral research
• Gaming — NPCs with consistent, evolving personalities
• Corporate Training — Realistic role-playing scenarios
• Healthcare — Patient simulations for medical education