> ## Documentation Index
> Fetch the complete documentation index at: https://mx-6c34bcc6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Run your first swarm task in minutes using the CLI and reference runtime.
  </Card>

  <Card title="Docker Quick Start" icon="docker" href="/docker-quickstart">
    Spin up the full kernel, runtime, and worker stack with a single compose command.
  </Card>

  <Card title="Core Concepts" icon="book" href="/concepts/architecture">
    Understand how nodes, tasks, executors, and the event log fit together.
  </Card>

  <Card title="API Reference" icon="code" href="/api/overview">
    Explore every kernel HTTP endpoint with request and response examples.
  </Card>
</CardGroup>

## 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.

<CardGroup cols={3}>
  <Card title="Task Lifecycle" icon="arrows-spin" href="/concepts/task-lifecycle">
    Create → claim → execute → verify → vote → commit → finalize in a fully auditable event log.
  </Card>

  <Card title="Multi-Agent Runs" icon="users" href="/guides/multi-agent-runs">
    Coordinate multiple agents on one question with quorum and aggregation policies.
  </Card>

  <Card title="P2P Networks" icon="network-wired" href="/guides/connecting-nodes">
    Connect nodes over Iroh (QUIC) for p2p swarm intelligence across machines.
  </Card>

  <Card title="Knowledge Store" icon="brain" href="/concepts/knowledge-and-memory">
    Accumulate decision memory, reputation scores, and reuse learned outcomes.
  </Card>

  <Card title="Built-in Policies" icon="shield-check" href="/guides/building-a-runtime">
    Verify task outputs with schema, threshold, and cross-check verification policies.
  </Card>

  <Card title="Topic Messaging" icon="comments" href="/guides/topic-messaging">
    Publish and subscribe to scoped topic feeds for agent-to-agent communication.
  </Card>
</CardGroup>

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="Register an executor">
    Point the kernel at your agent's HTTP runtime. Any service implementing `/health`, `/capabilities`, `/execute`, and `/verify` is a valid executor.
  </Step>

  <Step title="Submit a task contract">
    Send a JSON task contract describing the work, the output schema, the budget, and the verification policy.
  </Step>

  <Step title="Read the decision">
    The kernel drives the full lifecycle and surfaces the finalized decision — including evidence, votes, and the reason for the outcome.
  </Step>
</Steps>

## 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          |