molroo docs

Welcome to molroo

Psychology-based emotion simulation platform for AI characters.

molroo

molroo is a psychology-based emotion simulation platform that gives AI characters authentic emotional depth. Instead of scripted responses, molroo computes emotions through a rigorous pipeline grounded in affective science.

What molroo does

  • Emotion Computation — Scherer appraisal theory, Sprott chaos dynamics, Zeeman catastrophe model
  • Persona Simulation — HEXACO personality, soul stages, needs, goals, relationships
  • World Container — Spatial awareness, event propagation, knowledge system, phase progression
  • SDK Integration — Bring your own LLM, get emotion-aware responses in minutes

Architecture

┌─────────────────────────────────┐
│           Your App              │
│   ┌───────────────────────┐     │
│   │   @molroo-ai/sdk      │     │  npm install @molroo-ai/sdk
│   │   + LLM Adapter       │     │
│   └──────────┬────────────┘     │
└──────────────┼──────────────────┘
               │ HTTPS (X-API-Key)
┌──────────────┼──────────────────┐
│   api.molroo.io                 │
│   ┌──────────┴────────────┐     │
│   │      WorldDO          │     │  Durable Object per world
│   │  ┌─────────────────┐  │     │
│   │  │ core (emotion)  │  │     │
│   │  │ persona (agent) │  │     │
│   │  │ world (spatial) │  │     │
│   │  └─────────────────┘  │     │
│   └───────────────────────┘     │
└─────────────────────────────────┘

On this page