Documentation

Run your first world model.

Validate a package, inspect its contract and plan from a system state using the A08 CLI or runtime API.

Quickstart

Validate and plan in four commands.

Run from the a08-platform repository with Python 3.11 or later.

terminalpython -m pip install -e .
a08 validate worlds/kubernetes-rollout-control
a08 inspect worlds/kubernetes-rollout-control
a08 plan worlds/kubernetes-rollout-control \
  --state worlds/kubernetes-rollout-control/examples/state.json \
  --goal worlds/kubernetes-rollout-control/examples/goal.json

Manifest

The package entry point.

world.json declares package identity, machine scope, schemas, model artifacts, runtime requirements, evaluation and lineage. Validation resolves every referenced file and checks its digest.

Immutable by default

Push refuses to overwrite an existing package version. Change the version when any material package content changes.

Runtime

Five HTTP operations.

GET /v1/world

Resolve package metadata and capabilities.

POST /v1/observe

Validate state against the machine schema.

POST /v1/simulate

Predict a trajectory under supplied actions.

POST /v1/plan

Rank declared candidate sequences for a goal.

POST /v1/evaluate

Run the package evaluation suite.

terminala08 run worlds/kubernetes-rollout-control --port 8080
curl http://localhost:8080/v1/world

Local registry

Pack, push and pull by version.

terminala08 pack worlds/kubernetes-rollout-control \
  --output dist/package.a08pkg
mkdir -p .a08/demo-registry
a08 push worlds/kubernetes-rollout-control --registry .a08/demo-registry
mkdir -p pulled/kubernetes-rollout-control
a08 pull a08/kubernetes-rollout-control@0.2.2 \
  --registry .a08/demo-registry \
  --output pulled/kubernetes-rollout-control

Use empty demo paths

Start with a new, empty demo registry and a new package folder. The CLI refuses to overwrite existing package content.

Publish

Bring a complete world to the registry.

Validate the package, run its registered evaluation and place the source behind an immutable version. Submit the package ID and source URL for contract, evidence and security review.

Discovery is earned

Approved packages can appear through A08 curation, downloads, stars or recent activity. Ranking never replaces scope and evaluation evidence.

Open the creator submission →