Function createParacosmClient

Example

import { createParacosmClient } from 'paracosm';

const client = createParacosmClient({
  provider: 'openai',
  costPreset: 'economy',
  models: { departments: 'gpt-5.4' },  // pin only departments to flagship
});

const scenario = await client.compileScenario(worldJson);
const out = await client.runSimulation(leader, [], { maxTurns: 6, seed: 42 });

// Per-call override wins over client defaults:
const quality = await client.runSimulation(leader, [], {
  maxTurns: 8, seed: 42,
  costPreset: 'quality',  // promote this one run to flagship
});
Copy

Example: Env-driven (zero-code config for hosting / CI):

PARACOSM_PROVIDER=anthropic \
PARACOSM_COST_PRESET=economy \
PARACOSM_MODEL_DEPARTMENTS=claude-sonnet-4-6 \
  node my-runner.js
Copy

const client = createParacosmClient();  // no args — reads from env
Copy