Quick Start

Quick Start

Get up and running with Substr8 in 2 minutes.

Installation

pip install substr8

Initialize a Project

substr8 init my-agent
cd my-agent

This creates:

my-agent/
  examples/
    langgraph/
    autogen/
    pydantic-ai/
  runproofs/
  .env.example
  README.md

Run with Governance

substr8 run examples/langgraph/agent.py

Output:

Substr8 Governance: ACTIVE

Run ID: run-6c39af

ACC policy loaded
CIA integrity checks enabled
DCT ledger initialized

Running agent...

Run completed ✓
RunProof generated: ./runproofs/run-6c39af.runproof.tgz

Verify locally:  substr8 verify runproofs/run-6c39af.runproof.tgz
Verify online:   https://verify.substr8labs.com/?hash=7afc3e...

Verify the Run

substr8 verify runproofs/run-6c39af.runproof.tgz

Output:

RunProof Verified ✓

Run:     run-6c39af
Agent:   langgraph:researcher
Policy:  verified
Ledger:  chain valid ✓ (24 entries)
CIA receipts: present ✓
Memory provenance: verified ✓

What’s Next?

IntroductionCLI Reference