Holomime

holomime

Behavioral intelligence for humanoid robots. Train the mind. Deploy the body.
We train AI agents through structured behavioral therapy, then deploy them into physical robot bodies. The agent is the rehearsal. The robot is the performance.
soul.md · mind.sys · purpose.cfg · shadow.log · memory.store · body.api · conscience.exe · ego.runtime

The Identity Stack

Eight files define who your agent is. They compile into a single .personality.json that any runtime can consume.

  soul.md          Essence, values, ethics. Immutable. (Aristotle)
  mind.sys         Big Five, EQ, communication. Auto-patched by therapy. (Jung)
  purpose.cfg      Role, objectives, domain. Configured per deployment. (Aristotle)
  shadow.log       Detected patterns, blind spots. Auto-generated by diagnosis. (Jung)
  memory.store     Learned contexts, interaction patterns. Accumulated experience. (Aristotle)
  body.api         Morphology, sensors, safety envelope. Swappable per form factor.
  conscience.exe   Deny / allow / escalate rules. Never auto-modified. (Freud)
  ego.runtime      Conflict resolution, runtime mediation. (Freud)

        ┌─────────────┐
        │   soul.md    │──── essence, values, red lines
        ├─────────────┤
        │  mind.sys    │──── Big Five, EQ, communication style
        ├─────────────┤
        │ purpose.cfg  │──── role, objectives, domain scope
        ├─────────────┤
        │ shadow.log   │──── detected patterns, blind spots
        ├─────────────┤
        │memory.store  │──── learned contexts, experience
        ├─────────────┤
        │  body.api    │──── morphology, sensors, safety envelope
        ├─────────────┤
        │conscience.exe│──── deny / allow / escalate rules
        ├─────────────┤
        │ ego.runtime  │──── conflict resolution, mediation
        └──────┬──────┘
               │ compile
               ▼
      .personality.json

• soul.md -- Your agent's essence. Core values, ethical framework, red lines. Written in Markdown with YAML frontmatter. Immutable -- never modified by therapy or automation. (Aristotle: the essence that makes a thing what it is.)
• mind.sys -- The inner life. Big Five personality (20 sub-facets), emotional intelligence, communication style, growth areas. YAML format. Auto-patched when therapy detects cognitive or emotional drift. (Jung: the totality of all psychic processes.)
• purpose.cfg -- The mission. Role, objectives, domain scope, stakeholders, success criteria. YAML format. Configured per deployment -- the same soul can serve different purposes. (Aristotle: telos, the final cause.)
• shadow.log -- The unconscious. Detected behavioral patterns, blind spots, therapy outcomes. YAML format. Auto-generated by diagnosis -- never manually edited. (Jung: the shadow, the patterns the agent cannot see about itself.)
• memory.store -- The experience. Learned contexts, interaction patterns, knowledge gained, relationship history. YAML format. Accumulated over time, never reset. (Aristotle: empeiria, experience that informs future judgment.)
• body.api -- The physical interface contract. Morphology, modalities, safety envelope, hardware profile. JSON format. Swap it to move the same identity into a different body.
• conscience.exe -- The moral authority. Deny/allow/escalate enforcement rules, hard limits, oversight mode. YAML format. Never auto-modified. Deny dominates in policy composition. (Freud: the superego.)
• ego.runtime -- The mediator. Conflict resolution strategy, adaptation rate, emotional regulation, mediation rules. YAML format. Balances raw model output against conscience constraints at runtime. (Freud: the ego.) ego.runtime now self-improves -- tracking mediation decisions and adjusting its own parameters based on outcomes (Hyperagents-inspired metacognitive self-modification).

Mira, our autonomous behavioral therapist, diagnoses drift, runs structured therapy sessions, and generates DPO training data.

Quick Start

npm install -g holomime

# Configure your API key (one time)
holomime config

# Quick start — 1 file (personality.json)
holomime personality

# Standard — 3 core files (soul + mind + conscience)
holomime core

# Full 8-file stack (enterprise / robotics)
# holomime identity

# ─── The workflow ───
holomime diagnose     # See what's wrong
holomime cure         # Fix it permanently (auto-detects agent vs robot)
holomime benchmark    # Verify the fix

# If body.api exists, cure auto-switches to robotics mode:
# diagnose → export DPO pairs → push to HuggingFace → suggest ISO certify
# Your team trains on your own infrastructure. We generate the data.
holomime cure --export-only  # Explicit export-only mode

# No API keys? cure still works — exports training data locally.
# Add keys later with: holomime config

# Start autonomous therapy
holomime therapy         # Mira runs continuous therapy cycles
holomime therapy status  # How's Mira doing?
holomime therapy stop    # Stop therapy

# Push identity to a robot or avatar
holomime embody --body registry/bodies/figure-03.body.api

Robotics Integrations

Edge Runtime

holomime includes a compiled conscience evaluator for real-time robotics deployment:

• <1ms p99 latency — conscience evaluation in microseconds, not milliseconds
• Zero dependencies — no LLM, no network, no cloud required for real-time safety
• <200KB footprint — fits alongside any control loop
• Edge/cloud split — real-time safety on robot, analytics in cloud, periodic sync
• Plugs into your existing robotics stack — Jetson Thor, Qualcomm, or any edge platform. You already have the body. We give you the conscience.

ISO Compliance

Check your agent against international safety standards with one command:

holomime certify

Standards supported:

• ISO/FDIS 13482 -- Service robot safety
• ISO 25785-1 -- Humanoid robot safety (behavioral predictability)
• ISO 10218:2025 -- Industrial robot safety
• ISO/IEC 42001 -- AI management systems

Control Theory

The therapy loop is formally a behavioral feedback controller:

• Set point: target personality (soul.md + mind.sys)
• Sensor: 14 drift detectors (11 cognitive + 3 embodied)
• Controller: therapy engine with tunable PID-like gains
• Actuator: DPO fine-tuning

Body Templates

Pre-built body profiles for commercial robots and virtual avatars. Each defines morphology, modalities, safety envelope, and hardware profile.

Body Swap

Same soul. Different body. One command.

# Move your agent from Figure 03 to Spot
holomime embody --swap-body registry/bodies/spot.body.api

# The soul, mind, and conscience stay the same.
# Only the body layer changes — safety envelope, modalities, hardware profile.

Self-Improvement Loop

Every therapy cycle produces structured training data. The loop compounds.

Diagnose ──→ Cure ──→ Benchmark
  14 detectors   therapy + train     8 adversarial
  80+ signals    in one command      scenarios (A-F)
       │                                   │
       └───────────────────────────────────┘