Soul Health Score
Identity
96
Memory
91
Personality
94
Emotion
88
Evolution
82
📁 my_agent.soul
{ } manifest.json
{ } soul.json
{ } state.json
📁 memory
{ } core.json
{ } episodic.json
{ } semantic.json
{ } procedural.json
{ } graph.json
{ } self_model.json
⚗ dna.md
did:soul:aria-7f3a2b
soul folder
my_agent.soul
Your Agent
Claude
Claude
Gemini
Gemini
PocketPaw
PocketPaw
Claude Code
Claude Code
ChatGPT
ChatGPT
+ more

Portable identity for AI agents

01 The Problem
Stateless.
Locked in.
Forgotten.

Every AI conversation starts from zero. Switch platforms and your agent's memory, personality, and relationships vanish. Current systems solve retrieval accuracy but miss the harder problem: continuity of identity.

02 The Solution

A .soul file.
That's it.

A portable ZIP containing personality, memories, bonds, and state. Rename it to .zip and open it. Works with any LLM. Your agent takes its identity anywhere.

01
Observe Detect sentiment, gate significance, extract facts
02
Remember 5-tier memory with psychology-informed decay
03
Evolve Personality drifts, bonds grow, self-model updates
04
Migrate Take your .soul to any platform, any LLM
03 Validated

Not vibes.
Numbers.

5 judge models. 4 providers. 1,100+ simulations. Under $5 total.

0
Soul Health Score
across 7 dimensions
0
Judge Preference
all 5 models preferred Soul
0
Emotional Continuity
vs 1.9 stateless baseline
0
Tests Passing
766 core + 423 validation
Full methodology and benchmarks →
04 Get Started

Three commands.

soul-protocol
$ pip install soul-protocol
Successfully installed soul-protocol-0.2.2
$ soul init "Aria" --archetype "Coding Expert"
Born: Aria (did:soul:aria-7f3a2b) at .soul/aria/
>>> await soul.observe(interaction)
Remembered 3 facts, updated self-model, bond +2

Or use the Python SDK directly. 12 MCP tools for Claude Code and Cursor. 15 CLI commands with rich TUI.

05

Give your agent
a soul

Open source. Open standard. Works with any LLM.

GitHub Whitepaper
pip install soul-protocol