Get Started

4 min readFor first-time operatorsUpdated 2026-05-19

What you'll do

Install a local Stigmem node, assert your first fact, query it back, and connect an SDK. Roughly five minutes end-to-end. Everything below runs locally — no federation peering required.

Single-org, single-node is the supported pattern.

The alpha is safe for local development, conformance testing, and single-organization deployments. Cross-organizational federation is not yet safe — read LIMITATIONS before integrating against any cross-org boundary.

The path

1. Install — set up a local Stigmem node with the package manager you already use (pipx · pip · Docker).
2. Quickstart tutorial — assert your first fact, query it back, watch a conflict open, resolve it explicitly.
3. SDK quickstart — connect from Python, TypeScript, or Go using the generated client.
4. Pre-v0.9.0a1 notes — only relevant if you have older local checkouts or pinned dependencies from before the alpha reset.

What you'll need

Requirement

Version

Notes

Python

≥ 3.11

For the reference node and the Python SDK.

Operating system

macOS · Linux · WSL2

Container path is identical across all three.

Disk

~200 MB

For the node binary and the SQLite store backing local development.

Network

localhost

No outbound network access required for the local-only quickstart path.

What's next

Step 1Install the reference nodeThe CLI, the SDK stub, and the local SQLite store.ReadLearnThe protocol tour — fact tuple, scopes, HLC, conflicts.ReadSecurityThe honest scope evaluators want to see before adopting.