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 — Cognitive appraisal, emotion dynamics, and state transition models grounded in affective science
  • Persona Simulation — Personality-driven emotion processing, mood dynamics, and embodied responses
  • Server-Side Prompt Assembly — System prompt built from live emotional state, no client-side prompt engineering
  • SDK Integration — Bring your own LLM, get emotion-aware responses in minutes

Architecture

┌─────────────────────────────────┐
│           Your App              │
│   ┌───────────────────────┐     │  npm install @molroo-io/sdk
│   │   @molroo-io/sdk      │     │
│   │   + LLM Adapter       │     │
│   └──────────┬────────────┘     │
└──────────────┼──────────────────┘
               │ HTTPS (X-API-Key)
┌──────────────┼──────────────────┐
│   api.molroo.io                 │
│   ┌──────────┴────────────┐     │
│   │   Emotion Engine      │     │  Stateful per persona
│   └───────────────────────┘     │
└─────────────────────────────────┘

On this page