Function: createParacosmClient()

createParacosmClient(options?): ParacosmClient

Defined in: apps/paracosm/src/runtime/client.ts:186

Create a Paracosm client with pinned defaults. Env vars are read once at construction; subsequent process.env mutations won't retrigger.

Parameters

options?

ParacosmClientOptions = {}

Returns

ParacosmClient

Examples

import { createParacosmClient } from 'paracosm/runtime';

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
});

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

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