Getting Started

These instructions track current main. Use a matching release tag for released behavior.

SynthWorld requires Python 3.12 or newer. The distribution is idcognito-synthworld; the import package and command are synthworld.

Install

pip install idcognito-synthworld
synthworld --help

For repository development, use the locked environment:

uv sync --locked --all-groups

Create a deterministic world

synthworld generate \
  --seed 20260719 \
  --persona-count 10 \
  --output world.json

Repeat the command with the same explicit inputs to reproduce the artifact. Do not replace the seed with wall-clock time when reproducibility matters.

Run the foundational walkthrough

From a repository checkout:

uv run python examples/evaluate_all.py --predictions-dir predictions

This demonstrates five foundational public-input adapters. It is not an exhaustive list of every contract-specific evaluator.

Choose the next guide

• Identity worlds
• Identity resolution
• Privacy exposure
• Agent authority
• Enterprise agentic identity experiment
• Enterprise access
• Enterprise Identity Planning
• Development pipelines
• Evaluating a system

The legacy user guide remains only as a compatibility index for historical repository anchors. These canonical pages own the detailed guidance.