How justinv200/hivemind works
HiveMind is a super-agent orchestrator: a human submits a goal, the Queen selects real or virtual compute, and supervised Workers act on Cells while the system manages tools, memory, and resources. The repository also includes the device-side Pollen gateway, Waggle messaging, a browser dashboard, and supporting stores. README statements establish the broad product relationships; sampled source confirms selected runtime details, but many domain modules were not inspected, so uncertain implementation-level links are omitted.
Main entry points: run.py Queen orchestrator · wardens Worker agents · swarm Swarm devices · cell Cell runtime
Components 20
Control and access
- Hive CLI
packages/hivemind/src/hivemind/cli/app.py - Queen orchestrator
packages/hivemind/src/hivemind/cli/run.py - Hive Entrance
packages/hivemind/src/hivemind/entrance/app.py - Observation dashboard
packages/observation-web/src/app.tsx - Logging layer
packages/hivemind/src/hivemind/common/logging.py
Cells and workers
- Cell runtime
packages/hivemind/src/hivemind/cell - Virtual Cell fleet
packages/hivemind/src/hivemind/cli/compose/virtual_cells.py - Swarm devices
packages/hivemind/src/hivemind/swarm - Cell Warden
packages/hivemind/src/hivemind/wardens/warden.py - Worker agents
packages/hivemind/src/hivemind/wardens - Virtual peripherals
packages/hivemind/src/hivemind/exoskeleton
Tools and knowledge
- Royal Jelly Lab
packages/hivemind/src/hivemind/royal_jelly - Comb Registry
packages/hivemind/src/hivemind/royal_jelly - Honey Store
packages/hivemind/src/hivemind/honey_store/ripening/pipeline.py - Basket artifact store
packages/hivemind/src/hivemind/basket
Device protocol
- Waggle protocol
packages/waggle/src/waggle/envelope.py - WebSocket transport
packages/waggle/src/waggle/transport/websocket_client.py - Pollen Packet
packages/pollen/src/pollen/bootstrap/service.py - Clock abstraction
packages/waggle/src/waggle/clock.py
Other components
- Human operator
Connections 21
- Human operator → Hive CLI: submits goals
README.md - Hive CLI → Queen orchestrator: runs orchestration
README.md - Queen orchestrator → Virtual Cell fleet: provisions on demand
README.md - Queen orchestrator → Cell runtime: dispatches work
README.md - Queen orchestrator → Swarm devices: dispatches remotely
README.md - Swarm devices → Cell runtime: provides real cells
README.md - Cell runtime → Cell Warden: hosts supervisor
README.md - Cell Warden → Worker agents: spawns and supervises
README.md - Worker agents → Virtual peripherals: uses peripherals
README.md - Queen orchestrator → Royal Jelly Lab: authors tools
README.md - Royal Jelly Lab → Comb Registry: promotes tools
README.md - Worker agents → Honey Store: uses stored knowledge
README.md - Worker agents → Basket artifact store: keeps artifacts
README.md - Swarm devices → Pollen Packet: connects through
README.md - Pollen Packet → Waggle protocol: serves messages
packages/pollen/src/pollen/bootstrap/service.py - WebSocket transport → Waggle protocol: carries frames
packages/waggle/src/waggle/transport/websocket_client.py - Queen orchestrator → Hive Entrance: exposes services
README.md - Human operator → Observation dashboard: views hive state
README.md - Observation dashboard → Hive Entrance: connects to hive
- Queen orchestrator → Logging layer: configures logging
packages/hivemind/src/hivemind/common/logging.py - WebSocket transport → Clock abstraction: waits through
packages/waggle/src/waggle/transport/websocket_client.py