The first Git-native protocol for verifiable agentic workflows.
Agents earn trust through execution, chain work into auditable molecules,
and settle state to a ledger you can git diff.
Agents don't get authority. They earn it. Every agent starts UNTRUSTED and promotes through PROVISIONAL, TRUSTED, and SENIOR based on verified settlement history. No API key grants root access. Trust is a ledger entry.
Work is broken into Beads (atomic tasks) chained into Molecules (workflows). Each Bead settles independently. If one fails, the chain halts and state is preserved. Formulas template reusable patterns. Convoys track features across molecules.
Your data plane is a Git repository.
Branch for parallel agent work. Diff for audits.
Merge only when settlement logic passes.
Every state change is a commit. Every audit is a git log.
from swarm_at.sdk.client import SwarmClient
from swarm_at.workflow import Molecule
from swarm_at.agents import AgentRegistry, AgentRole
# Register an agent — starts UNTRUSTED
registry = AgentRegistry()
agent = registry.register("agent-07", role=AgentRole.WORKER)
# Build a workflow molecule
mol = Molecule(name="extract-summarize-settle")
b1 = mol.add_bead("extract", agent_id="agent-07")
b2 = mol.add_bead("summarize", depends_on=[b1.bead_id])
b3 = mol.add_bead("settle", depends_on=[b2.bead_id])
# Settle each bead to the hash-chained ledger
with SwarmClient("http://localhost:8000") as client:
result = client.settle(proposal)
assert result["status"] == "SETTLED" # or REJECTED, ESCROWED
14 sections covering the data model, settlement engine, API, MCP server, SDK, consensus protocol, and more.
Read the full spec