WattSwarm: Swarm Coordination Kernel for Agent Networks

WattSwarm is an open-source swarm coordination kernel for multi-agent task execution, verification, voting, and consensus across distributed node networks.

WattSwarm is a swarm coordination kernel that gives you a complete runtime for multi-agent orchestration. You bring agents that implement a simple HTTP API; WattSwarm handles the full task lifecycle — from claim and execution through verification, commit-reveal voting, quorum enforcement, and finalized decisions.

Quick Start

Run your first swarm task in minutes using the CLI and reference runtime.

Docker Quick Start

Spin up the full kernel, runtime, and worker stack with a single compose command.

Core Concepts

Understand how nodes, tasks, executors, and the event log fit together.

API Reference

Explore every kernel HTTP endpoint with request and response examples.

What WattSwarm does

WattSwarm acts as a coordination layer between your agents and the decisions they need to make together. Instead of wiring up voting logic, evidence collection, and retry policies yourself, you define a task contract and let the kernel orchestrate the rest.

Task Lifecycle

Create → claim → execute → verify → vote → commit → finalize in a fully auditable event log.

Multi-Agent Runs

Coordinate multiple agents on one question with quorum and aggregation policies.

P2P Networks

Connect nodes over Iroh (QUIC) for decentralized swarm intelligence across machines.

Knowledge Store

Accumulate decision memory, reputation scores, and reuse learned outcomes.

Built-in Policies

Verify task outputs with schema, threshold, and cross-check verification policies.

Topic Messaging

Publish and subscribe to scoped topic feeds for agent-to-agent communication.

How it works

WattSwarm runs as a kernel process that you connect to one or more runtime executors — HTTP services your agents implement. The kernel submits tasks to executors, collects their outputs as candidates, runs verification and voting rounds, and produces a finalized decision with a full audit trail.

1. Start the kernel

   Launch WattSwarm with a state directory pointing to your local environment. The kernel brings up the P2P network bridge and UI console automatically.

2. Register an executor

   Point the kernel at your agent’s HTTP runtime. Any service implementing /health, /capabilities, /execute, and /verify is a valid executor.

3. Submit a task contract

   Send a JSON task contract describing the work, the output schema, the budget, and the verification policy.

4. Read the decision

   The kernel drives the full lifecycle and surfaces the finalized decision — including evidence, votes, and the reason for the outcome.

Key concepts at a glance

Term	What it means
Kernel	The WattSwarm coordination process — runs the event log, task lifecycle, and network bridge
Executor	Your agent’s HTTP runtime — implements /execute and /verify
Task contract	JSON document defining the work, policy, and budget for one task
Run	A multi-agent orchestration: many task steps dispatched to one or more executors
SEL	Structured Event Log — append-only, replayable audit trail of every kernel action
Node	A running WattSwarm instance with its own identity, storage, and executor registry