Core Concepts

Ensoul is a domain-agnostic personality simulation framework for creating authentic, evolving synthetic populations. This guide explains the fundamental concepts that power the system.

★

Key Principle

Every response from a persona is the result of real-time inference through that persona's current personality state. Nothing is cached, templated, or pre-computed.

Quick Overview

Domains

The universe in which your synthetic population lives. Defines tier structure, personality schemas, and archetypes.

Personas

Unique synthetic individuals with identity, personality vectors, memory, and evolution state.

Archetypes

Templates that provide baseline traits for generating personas with natural variation.

Evolution

Organic personality drift over time through experiences, events, and social influence.

Memory

Three-tier memory system with semantic search for persona continuity across sessions.

Query Modes

Three ways to interact: chat (1:1), multi-chat (group), and aggregate (population insights).

Domains

A domain defines the universe in which your synthetic population lives. Ensoul is completely domain-agnostic — the same framework that powers one domain can create fantasy characters, corporate archetypes, AI assistants, or any personality domain you can imagine.

Each domain specifies:

•

Tier structure: How personas are organized hierarchically

•

Personality schema: Which trait frameworks apply (Big Five, HEXACO, Dark Triad, custom)

•

Archetypes: Templates for baseline trait generation

•

Name generators: Domain-appropriate naming conventions

•

Memory templates: How personas store and recall experiences

You can create domains through Ensoul Studio's AI-assisted wizard, which helps you configure tier structures, personality schemas, and archetypes based on your description. See the Domain Architecture guide for details.

Custom Domain Example

json

{
  "name": "fantasy-realm",
  "tiers": ["world", "kingdom", "guild", "character"],
  "personality_schema": {
    "base": "big_five",
    "extensions": ["magic_affinity", "alignment"]
  }
}

Personas

A persona is a unique synthetic individual within a domain. Each persona has identity, personality vectors, memory, and evolution state. Personas are not static characters — they are living synthetic minds.

Identity

Unique ID, name, and archetype lineage for provenance tracking.

Personality Vector

Numerical values for each trait in the domain's schema.

Memory

Experiences and knowledge that shape future responses.

Evolution State

How the persona has changed over time through experiences.

💡

Authenticity Guarantee

Ensoul never substitutes, caches, or pre-computes persona responses. Every response is a genuine inference from that persona's current personality state.

Archetypes

An archetype is a template that provides baseline traits for generating personas. Rather than specifying exact values, archetypes define probability distributions and ranges that allow for natural variation.

Archetype Composition

Personas are typically composed from archetypes at different tiers of the domain hierarchy. Each archetype contributes trait modifiers that blend together:

Top-level: Broad contextual patterns (global setting, cultural norms)

Mid-level: Regional or organizational influences

Role-level: Occupational or functional patterns

Individual: Random perturbations that ensure uniqueness

In Ensoul Studio, you can create archetypes manually or use the AI-assisted wizard to generate them from a description. Each archetype specifies personality modifiers (deltas from baseline) and optional trait distributions.

Traits and Personality Frameworks

Ensoul's personality modeling is grounded in validated psychological research. Three core frameworks are available:

Big Five (OCEAN)

Five broad dimensions of personality, validated with the IPIP-50 psychometric instrument:

Openness

Conscientiousness

Extraversion

Agreeableness

Neuroticism

HEXACO

Six-factor model adding the Honesty-Humility dimension. Validated with the HEXACO-60 instrument. Important for modeling ethical behavior and trust dynamics.

Dark Triad

Machiavellianism, Narcissism, and Psychopathy. Validated with the Short Dark Triad (SD3) instrument. Useful for modeling adversarial or complex social dynamics.

Domains can use any combination of these frameworks, plus custom domain-specific trait extensions (e.g., "magic affinity" for a fantasy domain).

Domain-Specific Extensions

json

{
  "extensions": {
    "magic_affinity": {"min": 0, "max": 100},
    "alignment": {"values": ["lawful", "neutral", "chaotic"]},
    "courage": {"min": 0, "max": 100}
  }
}

Query Modes

Ensoul provides three ways to interact with your synthetic population, each suited to different use cases:

Chat

1:1 conversation with a single persona. Best for deep exploration of individual perspectives, building rapport, and testing persona consistency.

Multi-Chat

Group conversation with 2-6 personas simultaneously. Best for focus groups, exploring diverse viewpoints, and observing how different personality types interact.

Aggregate

Query your entire population (or a filtered subset) at once and get synthesized insights. Best for market research, population-level trends, and statistical analysis.

Organic Evolution

Personas are not frozen snapshots — they evolve organically over time through experiences, events, and social influence. This is a core design principle of Ensoul.

Evolution Mechanisms

•

Simulations: Run multi-step simulations where personas interact, form relationships, and evolve over simulated time periods

•

Conversation drift: Conversations and events gradually shift trait values based on experiences

•

Social influence: Interactions with other personas (via multi-chat or simulations) create subtle personality changes

•

Memory accumulation: As personas accumulate memories, their responses naturally evolve to reflect their history

💡

Simulations

Ensoul Studio includes a full simulation engine where you can define scenarios, set time progression, and watch personas interact and evolve. Simulations support checkpoints, speed control, and event broadcasting.