Introduction
Tractum is a Python package (Python 3.11+) for verifiable multi-agent consensus. A swarm of specialist agents answers a question; the answers are aggregated through a consensus strategy; and the result ships as a k-of-n signed receipt — each agent signs its own stance, the operator signs the aggregate, and anyone can verify the artifact forever, without running Tractum.
Frameworks coordinate. Tractum agrees.
The problem
Every agent framework can make one agent answer. Most can run several in parallel. What none of them produce is a per-agent signed, quorum-verifiable artifact you can hand to an auditor, a regulator, or a future teammate. Coordination output is text; text has no provenance.
The receipt concept
A ConsensusReceipt is the core artifact:
- Each agent in a swarm holds a signing keypair (pinned via
AgentConfig.signing_key, or provisioned ephemerally per swarm). As each agent answers, it signs its own stance — answer, confidence, model, role, task id — producing a signed statement. - The swarm's responses are aggregated by a
ConsensusStrategy(WeightedVoteby default,Debatefor hard questions). Disagreement is surfaced in the result (agreement,disagreed), not averaged away. ConsensusReceipt.from_result(...)packs the result plus every per-agent statement into a canonical JSON payload with a quorum thresholdkbaked in. The operator signs the payload; the signature covers the agent signatures too.- The signed receipt renders over three transports: plain JSON, a W3C Verifiable Credential envelope, or a Nostr kind-30078 (NIP-78) event signed with BIP-340 Schnorr — publishable to any Nostr relay.
Because the quorum threshold is part of the signed payload, it cannot be downgraded post-hoc. Because each statement is individually signed, a verifier counts valid agent signatures against k instead of trusting the operator's word. This is what makes a v2 receipt a k-of-n attestation rather than one operator's claim.
What ships in the package
Swarm/SwarmConfig/Task— concurrent agent collection and consensus executionWeightedVoteandDebateconsensus strategies, plus theConsensusStrategyextension pointConsensusReceipt,SignatureBackend,Ed25519Backend(default),MLDSABackend(ML-DSA-65 post-quantum, opt-in)verify_receipt_detailed— full verification report: aggregate signature, per-statement signatures, key pinning, quorum count- Transports: JSON receipt, W3C VC, Nostr NIP-78 event (
tractum.transports) - An RFC 6962-style append-only transparency log anchored to Nostr (
tractum.transparency) - An MCP server (
tractum-mcp) exposingreach_consensusandverify_consensustools - Adapters for LangGraph, Microsoft Agent Framework, and CrewAI
Coordinator— hierarchical task decomposition with dependency-respecting parallel execution
License
Tractum is licensed under the Business Source License 1.1 (BUSL-1.1) — source-available, not open source. The license converts to MIT on 2030-10-12. See the LICENSE file in the repository.
Where to go next
- Quickstart — install and run a signed consensus in under 2 minutes
- Consensus model — how stances are collected and what k-of-n means here
- Receipts — receipt anatomy, signing, and Nostr publication
- API reference — the public surface
- Verification — verify a receipt without running Tractum