Skip to content

Get Started

Run the reference demo.

Prepare the supported local workspace once, then run a governed procurement scenario in under five minutes.

1 · Prepare once

Set up the local workspace.

The one-time setup creates a pinned release workspace and offline demo cache. It can take up to 15 minutes; the demonstration below is the short repeatable run.

Environment

Linux/amd64 with CPython 3.12

Use the supported host profile for the reference scenario.

Local services

Docker and Compose

The demo starts a disposable local stack and removes it automatically.

Workspace

About 8 GiB free

Keep the release checkout and one-time setup environment together.

In a clean release checkout, prepare once
test ! -e /tmp/masugate-reviewer-setup
python3 scripts/prepare-reference-demo.py \
  --outdir /tmp/masugate-reviewer-setup
What the one-time setup provides

It writes /tmp/masugate-reviewer-setup/reviewer.envwith a clean release workspace, offline npm cache, and reviewed Python environment. The demonstration below uses only those prepared inputs.

2 · Five-minute demonstration

Run one governed procurement action.

From the prepared release workspace, run this command exactly once. It writes evidence to a disposable directory under /tmp.

Run the scenario
. /tmp/masugate-reviewer-setup/reviewer.env
cd "$MASUGATE_CANDIDATE_DIR"
test ! -e /tmp/masugate-five-minute-demo
"$MASUGATE_REVIEWER_PYTHON" scripts/run_reference_demos.py procurement \
  --release-dir "$MASUGATE_RELEASE_VERIFICATION_RELEASE_DIR" \
  --offline-npm-cache "$MASUGATE_OFFLINE_NPM_CACHE" \
  --source-revision "$MASUGATE_SOURCE_REVISION" \
  --source-date-epoch "$MASUGATE_SOURCE_DATE_EPOCH" \
  --outdir /tmp/masugate-five-minute-demo

Verify

Check the generated evidence.

The verifier checks the expected observations and the demonstration duration without rerunning the scenario.

Verify the result
"$MASUGATE_REVIEWER_PYTHON" scripts/verify-flagship-demo.py \
  --outdir /tmp/masugate-five-minute-demo

Next

See the same path in the OpenClaw walkthrough.

The interactive demo shows the request, policy, decision, effect, and receipt as the scenario grows.