|
1 | 1 | --- |
2 | | -title: "Paracosm — AI Simulation Engine" |
| 2 | +title: "Paracosm: Structured World Model for AI Agents" |
3 | 3 | sidebar_position: 1 |
4 | 4 | --- |
5 | 5 |
|
6 | | -Paracosm is an AI agent swarm simulation engine built on AgentOS. Define a scenario as JSON, run it with AI commanders that have different [HEXACO](/features/cognitive-memory) personality profiles, and watch their decisions diverge into measurably different outcomes from the same seed. The reference scenario ships as Mars Genesis: a thirty-colonist Mars colony running from 2035 to 2067 across six turns. |
| 6 | +Paracosm is a **structured world model for AI agents**, built on AgentOS. Define a world as JSON, pick leaders with different [HEXACO](/features/cognitive-memory) personality profiles, and watch their decisions diverge into measurably different trajectories from an identical seed. The reference scenario ships as Mars Genesis: a 100-colonist Mars settlement running from 2035 to 2083 across six turns. |
7 | 7 |
|
8 | | -**[Live demo](https://paracosm.agentos.sh/sim)** · **[GitHub](https://github.com/framersai/paracosm)** · **[npm](https://www.npmjs.com/package/paracosm)** · **[API reference](/paracosm)** · **[Case study blog post](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation)** |
| 8 | +## Where paracosm sits in the world-model landscape |
| 9 | + |
| 10 | +Paracosm is a structured world model in the sense of [Xing 2025](https://arxiv.org/abs/2507.05169) and the [ACM CSUR 2025 world-model survey](https://dl.acm.org/doi/full/10.1145/3746449), and a counterfactual world simulation model in the sense of [Kirfel et al, Stanford 2025](https://cicl.stanford.edu/papers/kirfel2025when.pdf). It is **not** a generative visual or spatial world model (Sora, Genie 3, World Labs Marble), **not** a JEPA-style predictive-representation model (LeCun's AMI Labs), **not** a multi-agent task orchestration framework (LangGraph, AutoGen, CrewAI, OpenAI Agents SDK), **not** a bottom-up swarm intelligence simulator (MiroFish, OASIS), and **not** a generative-agents library (Stanford Generative Agents, Google DeepMind Concordia). It is a JSON-defined state space + deterministic seeded kernel + LLM-driven events and specialist analyses + HEXACO-personality leaders + universal Zod-validated run artifact spanning turn-loop civilization simulations, batch-trajectory digital twins, and batch-point forecasts. |
| 11 | + |
| 12 | +Full taxonomy mapping lives at [docs/positioning/world-model-mapping.md](https://github.com/framersai/paracosm/blob/master/docs/positioning/world-model-mapping.md). |
| 13 | + |
| 14 | +**[Live demo](https://paracosm.agentos.sh/sim)** · **[GitHub](https://github.com/framersai/paracosm)** · **[npm](https://www.npmjs.com/package/paracosm)** · **[API reference](/paracosm)** · **[Positioning map](https://github.com/framersai/paracosm/blob/master/docs/positioning/world-model-mapping.md)** · **[Case study blog post](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation)** |
9 | 15 |
|
10 | 16 | ## Quick Start |
11 | 17 |
|
@@ -121,12 +127,12 @@ Two runs on the same seed produce identical deterministic stages. The LLM stages |
121 | 127 |
|
122 | 128 | Paracosm uses the [HEXACO model](/features/cognitive-memory) (Ashton & Lee, 2007) across all six axes, with both poles producing concrete behavioral cues in the commander's decision-style block and the department analysis prompts: |
123 | 129 |
|
124 | | -- **Openness** — high: favor novel, untested approaches; low: trust proven protocols. |
125 | | -- **Conscientiousness** — high: demand evidence and contingency plans; low: move fast, accept ambiguity. |
126 | | -- **Extraversion** — high: lead from the front with public comms; low: work through technical channels. |
127 | | -- **Agreeableness** — high: seek consensus with departments and Earth; low: override consensus when you see a better path. |
128 | | -- **Emotionality** — high: weigh human cost heavily; low: accept casualties for strategic gain. |
129 | | -- **Honesty-Humility** — high: report failures transparently; low: leverage information asymmetries. |
| 130 | +- **Openness.** High: favor novel, untested approaches. Low: trust proven protocols. |
| 131 | +- **Conscientiousness.** High: demand evidence and contingency plans. Low: move fast, accept ambiguity. |
| 132 | +- **Extraversion.** High: lead from the front with public comms. Low: work through technical channels. |
| 133 | +- **Agreeableness.** High: seek consensus with departments and Earth. Low: override consensus when you see a better path. |
| 134 | +- **Emotionality.** High: weigh human cost heavily. Low: accept casualties for strategic gain. |
| 135 | +- **Honesty-Humility.** High: report failures transparently. Low: leverage information asymmetries. |
130 | 136 |
|
131 | 137 | Trait thresholds are 0.7 (high) and 0.3 (low); cues only fire when a trait is meaningfully expressed. Visible in action at [departments.ts:90](https://github.com/framersai/paracosm/blob/master/src/runtime/departments.ts#L90) and [commander-setup.ts:30](https://github.com/framersai/paracosm/blob/master/src/runtime/commander-setup.ts#L30). |
132 | 138 |
|
@@ -231,9 +237,9 @@ Narrow via `e.type` for per-event intellisense on `e.data`. Validate the envelop |
231 | 237 |
|
232 | 238 | ## Related |
233 | 239 |
|
234 | | -- [Emergent Capabilities](/features/emergent-capabilities) — the forge + judge machinery underlying `forge_tool` |
235 | | -- [HEXACO Personality](/features/cognitive-memory) — trait model, mutation system, persona overlays |
236 | | -- [Cognitive Memory Guide](/features/cognitive-memory-guide) — the memory pipeline colonists use as chat agents |
237 | | -- [Inside Mars Genesis (blog)](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation) — full case study |
238 | | -- [Emergent Tools and HEXACO Leaders (blog)](https://agentos.sh/blog/emergent-tools-hexaco-leaders) — two-leader-one-seed comparison |
239 | | -- [Build an AI Civilization in 5 Minutes (blog)](https://agentos.sh/blog/build-ai-civilization-simulation-paracosm) — tutorial |
| 240 | +- [Emergent Capabilities](/features/emergent-capabilities): the forge + judge machinery underlying `forge_tool` |
| 241 | +- [HEXACO Personality](/features/cognitive-memory): trait model, mutation system, persona overlays |
| 242 | +- [Cognitive Memory Guide](/features/cognitive-memory-guide): the memory pipeline colonists use as chat agents |
| 243 | +- [Inside Mars Genesis (blog)](https://agentos.sh/blog/inside-mars-genesis-ai-colony-simulation): full case study |
| 244 | +- [Emergent Tools and HEXACO Leaders (blog)](https://agentos.sh/blog/emergent-tools-hexaco-leaders): two-leader-one-seed comparison |
| 245 | +- [Build an AI Civilization in 5 Minutes (blog)](https://agentos.sh/blog/build-ai-civilization-simulation-paracosm): tutorial |
0 commit comments