Hive AI

A swarm of tiny ESP32 ‘biologics’ that self-organize under a ruler, hot-swap roles over the air, and share memory — built on an embedded Forth.

Concepts & Vocabulary

The biology metaphor, the engineering reality it maps to, and the words used throughout the Hive AI …

Architecture & Topology

How a ruler and its nodes fit together, the shared component stack, and the load-bearing bring-up …

The 12 Roles

The jobs a node can hold in the hive — from Ruler to Boombox — and how each is implemented today.

Hive Protocol v1

Ruler discovery, length-prefixed JSON transport, HMAC-SHA256 authentication, the message types, and …

Generations & the Lineage Gate

The three version axes, the mycology-themed lineages, and the CHALLENGE/RESPONSE puzzle that decides …

Signed Role Bundles

How the hive teaches nodes new behavior at runtime — the envelope format, signing, install pipeline, …

The Cast: Devices & Boards

The physical hardware that makes up a MagNET hive — what each board is, its chip, and the role it …

Controlling the Hive from Forth

The ESPIDFORTH REPL vocabulary that drives the hive — display, provisioning, ruler, shared memory, …

Scribe & the Redis Sidecar

The Scribe role's NVS-backed key-value store, and the RESP2-compatible Redis server that exposes it …

Boombox: Audio Notifications

The Role 12 audio node — software-synth I2S engine, tone/sweep/AM primitives, canned recipes, the …

Bench Bring-Up & Verification

A sequential walkthrough to flash, provision, and verify a multi-node hive on the bench — including …