Quickstart

Before running the demo, read The PanSphaira Canon, The Operating Field Guide, Architecture and Known Limitations.

Requirements

Install Docker Engine with Docker Compose v2 and the local command-line tools jq, curl, OpenSSL and sha256sum. The demo targets Linux x86_64 and uses only loopback service bindings.

Get the source

Verified Latest release archive

The current Latest release has a release-bound archive and SHA-256 sidecar. Download both exact public assets and verify the sidecar before extraction:

Its increment claim is closed adaptive-evidence gates plus a separate operator-invoked controller. The controller remains default-off, persists atomic digest-bound state, uses a bounded lease/deadman and preserves WAITING_EXTERNAL honestly. It does not claim a scheduler, default activation, adaptive test-depth reduction, external completion truth, production readiness or customer evidence.

release=v0.2.0-poc.20260821.1
archive=cm-product-increment-rc-20260821-adaptive-evidence-controller.tar.gz
base=https://github.com/JoFe2/PANSPHAIRA/releases/download/$release
curl -fLO "$base/$archive"
curl -fLO "$base/$archive.sha256"
sha256sum -c "$archive.sha256"
tar -xzf "$archive"
cd cm-product-increment-rc-20260821-adaptive-evidence-controller

The sidecar owns the expected digest; do not substitute a checksum copied from unverified prose. Check Latest before using these release-bound names.

Contributor checkout

For development against public main, keep that source identity distinct from released evidence:

git clone https://github.com/JoFe2/PANSPHAIRA.git
cd PANSPHAIRA
git switch main

Verify the source candidate

With Node.js 24 and npm 11, dependencies can be prepared from a populated local cache:

npm ci --offline --ignore-scripts --no-audit --no-fund
npm run lint
npm test

The external video boundary has a lightweight contract check that does not build a GPU image or download a model:

npm run external-video-service:test

Run the playable demo

./demo/install.sh

The installer creates random local demo credentials, builds the PanSphaira runtime image, starts the pinned CRM/ERP stack, loads fictional fixtures and performs semantic readback. Initial installation can download the pinned container images.

Success prints READY_VERIFIED and three loopback URLs. Keep the generated credentials local. The guided demo also exercises the deterministic Admin-AI preview path for permitted, denied and escalation outcomes.

Optional external BI service

BI is no longer embedded in the CM demo stack. To use the standalone BI subsystem, run the supported KaleidoSphere v0.8.0 compatibility release, then point CM only at its SBA loopback URL with BI_AGENT_BASE_URL. Direct Superset URLs are rejected. See External BI service contract.

Stop and remove owned state

./demo/uninstall.sh --purge

The cleanup command is ownership-scoped. Never substitute broad Docker prune or filesystem deletion commands.

Cleanup is not provider Rollback or authority Revoke. The distinction is defined by CM-CAN-13.