Skip to content
Sumway

Quick start

Boot the kernel, dispatch governed traffic, and inspect the ledger in a few minutes.

Prerequisites

Section titled “Prerequisites”
  • Go 1.23+
  • PostgreSQL 14+ (or use the embedded bbolt fallback — no Postgres needed)
  • An LLM endpoint: local Ollama, or an OpenAI-compatible key (OpenRouter, OpenAI)

Run the kernel

Section titled “Run the kernel”
Terminal window
make build
Terminal window
./build/stratusos

Configuration comes from stratus.toml. Profiles switch the LLM stack in one line — [profile] active = "local" uses Ollama, "cloud" uses OpenRouter via OPENROUTER_API_KEY.

On boot the kernel brings up the dispatcher, ledger, VFS, gateway (fail-closed), the NATS broker, the S3 and Bedrock bridges, and — when configured — snapshots, the payment evaluator, swarm, planner, and subprocess isolation with the Landlock + seccomp-BPF sandbox (Linux).

One-command demos

Section titled “One-command demos”
Terminal window
scripts/portal-up.sh

Kernel + Postgres + Governance Console at :3001 (dev login: operator / operator).

Terminal window
scripts/x402-demo-up.sh

Kernel + offline x402 seller/facilitator, ready for try-allowed / try-blocked.

Terminal window
scripts/matrix-setup.sh

Dendrite homeserver + Element + WhatsApp/Telegram bridges.

Or run the full stack (kernel, portal, Cognis, Matrix) with Docker:

Terminal window
make up

Seed demo data

Section titled “Seed demo data”
Terminal window
go run ./cmd/seed/

Registers ~25 agents across 4 organisations with realistic ACTIVE / SUSPENDED / REVOKED lifecycles. Then fire governed agent-to-agent traffic for the Mesh view:

Terminal window
go run ./cmd/mesh-seed/ --count 500

Run the end-to-end governance test

Section titled “Run the end-to-end governance test”
Terminal window
go run ./cmd/broker-test/

Expected output:

✅ ACTIVE agent connect      — CapitalPay Orchestrator authenticated
✅ REVOKED agent rejected     — Authorization Violation at CONNECT
✅ Intent delivery            — message delivered through governance interceptor
✅ Ledger record              — ACTION_AGENT_MESSAGE session=ba90727e… status=SUCCESS

Next steps

Section titled “Next steps”