Hivemind

Deterministic workload orchestration for Cerebrium-style AI/ML inference.

Current project phase: POC v1 proved functional/resilience basics and a warm-cache nginx control-plane benchmark; POC v2 is the team-presentation gate for current-system parity plus Hivemind-native serving semantics.

Active Components

• core/ — Zig control plane: VRR consensus, scheduler, gossip, persistence, VOPR simulation
• worker/ — Rust node agent: containerd runtime, GPU allocation, secrets, volumes, runtime simulation
• api/ — Go REST/dashboard gateway over the replica binary protocol
• tests/ — local smoke/build checks
• bench/ — benchmark tooling
• infra/ — frozen/local-use deployment glue; do not touch cloud unless explicitly reopened

Build

cd core && zig build
cd ../worker && cargo build
cd ../api && go build ./...

Test

cd core && zig test src/unit_tests.zig
cd core && zig test src/unit_tests.zig -OReleaseFast
cd core && zig build test
cd worker && cargo test --quiet
cd api && go test ./...

Source Of Truth

Read these first:

1. docs/STATUS.md — current implementation state
2. docs/POC_V2_ACCEPTANCE.md — current team-presentation/replacement gate
3. docs/design/HIVEMIND_NATIVE_PLATFORM.md — Hivemind-native revisions/routability/rollout model
4. docs/POC_ACCEPTANCE.md — POC v1 historical pass/fail checklist
5. docs/POC_CHANGELOG.md — dated POC progress
6. docs/FINDINGS_AND_ISSUES.md — production gaps and backlog
7. docs/ENGINEERING.md — engineering principles

Historical or aspirational material lives under docs/legacy/ and docs/frozen/. It is not authoritative when it disagrees with core/ or docs/STATUS.md.