Calibration

Every molroo persona has a body budget — an energy resource that represents physiological capacity. Intense emotions deplete it; rest and positive interactions restore it. When the budget runs low, the persona becomes more emotionally reactive and harder to regulate, just like a tired person.

Calibration lets you tune the parameters that control this system, matching the emotional pacing to your application.

Parameters

All fields are optional with sensible defaults.

Usage

SDK

Pass simConfig.calibration when creating a persona:

const molroo = new Molroo({ apiKey: 'mk_live_xxx' });

const persona = await molroo.createPersona(
  {
    identity: { name: 'Kira', role: 'knight' },
    personality: { O: 0.5, C: 0.7, E: 0.6, A: 0.4, N: 0.6, H: 0.7 },
    simConfig: {
      calibration: {
        budgetRecoveryPerHour: 0.3,   // slow recovery — grueling quest
        turnScale: 1.5,               // amplified per-turn reactions
      },
    },
  },
  { llm },
);

REST API

Include simConfig in the POST /personas request body:

{
  "identity": { "name": "Kira", "role": "knight" },
  "personality": { "O": 0.5, "C": 0.7, "E": 0.6, "A": 0.4, "N": 0.6, "H": 0.7 },
  "simConfig": {
    "calibration": {
      "budgetRecoveryPerHour": 0.3,
      "turnScale": 1.5
    }
  }
}

Tuning tips

• Fast-paced apps (action games, rapid chat): increase budgetRecoveryPerHour and turnScale.
• Slow-paced apps (drama, narrative RPGs): decrease budgetRecoveryPerHour.

Next steps