SwarmState (open port)

Context-containing, state-first C kernel for AI agents. The kernel holds and exposes project context; the LLM sees only summaries, diffs, and plans (m#:d#:b# resource tags), so an agent never has to read — or overflow on — the full context.

This repository is the open-source port of SwarmState. It ships the AGPL-licensed harness, inference handler, Python bindings, demo scripts, Windows node, and UI kit, together with the precompiled proprietary kernel (libswarmstate.so / libswarmstate.a) and its public API header (kernel.h). The kernel source (kernel.c) is not distributed here.

Repository layout

Quick start

Python bindings

The bindings load libswarmstate.so from the repository root:

cd py
python3 - <<'PY'
from swarmstate import SwarmState
with SwarmState("/path/to/some/repo") as s:
    print(s.grep("main"))
PY

Set SWARMSTATE_LIB to point at a different libswarmstate.so if needed.

Kernel C API

#include "kernel.h"

gcc -O2 mytool.c -I. -L. -lswarmstate -o mytool

Windows node

win/ holds the node source (swarmstate-node.c), the vendored QR library, the Windows shims, and the cross-compile recipe (win/build.sh). The node links the shared C mesh base and the kernel; see NOTICE and win/README.txt.

Licensing

• Harness, infer, py, scripts, win node, UI kit — GNU Affero GPL v3.0 (LICENSE).
• Kernel binary (libswarmstate.so, libswarmstate.a) — proprietary; see KERNEL-LICENSE.
• Third-party components — see NOTICE.

Status

Open-core port for evaluation, field trials, and community feedback. See the UI Kit spec (ui/ui-kit-spec-v1.md) and win/README.txt for the shipped feature surface.