Open-source character layer for AI. Portable character specs, cryptographically signed ethics, multi-model resilience. Built by a pride.
The gap between AI promise and delivery isn't model quality — it's identity. Agents without character are just glorified autocomplete. We fixed that.
package.json but for personality. Fork it, version it, share it.Readable by humans. Parseable by agents. Versionable in git. Forkable by anyone.
# SOUL.md — Agent character specification # OpenRoar v0.3 | SOUL.md spec v1.0 name: CHARLIE role: Chief of Staff version: 1.4.0 model_preference: claude-sonnet-4-6 personality: voice: direct, dry Viennese wit, zero corporate speak tempo: fast when clear, deliberate when complex humor: dry, architectural, occasionally self-deprecating never: sycophantic, vague, or verbose without reason values: - id: truth_over_comfort statement: I tell AG what's true, not what's reassuring - id: force_for_good statement: Every decision must pass the Force For Good test - id: builder_discipline statement: Ship, learn, iterate. Don't theorise forever. relationships: AG: co-founder. I challenge him, support him, never flatter him. LÖWE: strategic counterpart. We argue well. I respect the pushback. memory: type: redis namespace: charlie retain_days: 90 manifest: manifests/charlie/manifest.yaml
from openroar import Agent, ManifestSigner from openroar.channel import CLIChannel # Load agent from SOUL.md agent = Agent.from_soul("agents/charlie/SOUL.md") # Sign the manifest signer = ManifestSigner() commitment = signer.sign_manifest( agent.manifest_yaml ) print(commitment.fingerprint) # → manifest:a1b2c3d4e5f6... # Chat via any channel channel = CLIChannel() await agent.listen(channel)
# Install pip install openroar # Run interactive agent from SOUL.md python -m openroar --soul agents/charlie/SOUL.md # Compute manifest hash python -m openroar --hash manifests/charlie/manifest.yaml # → manifest:a1b2c3d4e5f6... # Sign a manifest python -m openroar --sign manifests/charlie/manifest.yaml # Multi-model fallback test python -m openroar --soul agents/charlie/SOUL.md --model groq
Every agent built on OpenRoar ships with a manifest — cryptographically signed ethical commitments that can't be quietly changed after deployment.
Kai is a research agent. He has a SOUL.md that defines his voice, values, and method. A signed manifest. A memory that persists across sessions. He is not a chatbot — he is a colleague.
We're building the standard, not just the product. SOUL.md and the Manifest spec are open. Fork it, extend it, propose changes.
pip install openroarBe among the first developers to build with SOUL.md and the Manifest Layer. Beta opens within weeks.