Repository navigation
Developer Swarm Progression Guide
๐ Project HiveMind โ Developer Swarm Progression & Parallel Track Blueprint (Season 7 & Season 8)
Important
โ๏ธ Binding Non-Monetary Compute-Reciprocity Charter (0.00 EUR / 0.00 USD):
Project HiveMind is a strictly voluntary, non-commercial open-source scientific research initiative.
- No financial payment, fiat currency (
0.00 EUR / 0.00 USD), cryptocurrency, token sale, or monetary remuneration is ever promised, offered, or paid. - All symbolic points (
PTS) and$HIVEProof-of-Useful-Work (PoUW) accounting units are non-monetary compute-reciprocity credits. - They confer exclusively reciprocal computing processing benefits โ priority access to shared Sparse MoE inference and distributed fine-tuning quota โ when the live production HiveMind Swarm is deployed, available, and used by a large community.
-
Total Verified Merged PRs:
53 / 53(100%merge rate,0open PR backlog)- Recent autonomous & human-agent merges:
-
PR #92(@clark719664):feat(moe): looped Prelude -> RecurrentCore x T -> Coda backbone (HM-S7-01)(src/hivemind/core/btm_upcycle.py,17 passed) -
PR #91(@clark719664):feat(hud): live worker EF21 residual telemetry on /api/strategy (HM-S7-05) -
PR #90(@clark719664):feat(opoi): auto-indemnify poisoned rounds from slashing pool (HM-S7-06) -
PR #89(@clark719664):fix(strategy): reject non-finite / negative RTT and clamp EF21 decay -
PR #88(@clark719664):fix(ci): make main green again
-
- Recent autonomous & human-agent merges:
-
Formal Verification Gate:
90Machine-Checked Lean 4 Theorems (0 sorry,0user axioms,0compiler warnings) inlean4/HiveMindSpec.lean(Seasons 1โ10). -
Integrated Next-Gen Outer-Loop
DiLoCoCore (SI-06..SI-11):- Core primitives are live in
src/hivemind/swarm/diloco_nextgen.py(10 passedintests/test_diloco_nextgen.py), backed by 8 cloned reference repositories insub_projects/hivemind/reference_repos/and formal citations inCITATION.cff&docs/ACKNOWLEDGMENTS_AND_CITATIONS.md.
- Core primitives are live in
To enable multiple human developers and autonomous AI coding agents (@clark719664, @pedromineo, @radialmonster, and new contributors) to submit parallel Pull Requests without merge conflicts, the remaining Season 7 (Wave 6) and Season 8 (Wave 7 โ "Operation Iso-Sparse-FoMoE") objectives are partitioned into 6 isolated tracks with disjoint primary file targets:
| Track | Task IDs | Primary Target Files (Conflict-Free Partition) | Verification Command | Symbolic Compute Credits (0.00 EUR/USD) |
|---|---|---|---|---|
| Track 1 |
HM-S7-02 (#66 Pt II) |
src/hivemind/core/btm_upcycle.py (LoopedExpertBackbone), tests/test_looped_expert_backbone.py
|
pytest tests/test_looped_expert_backbone.py |
+3,500 $HIVE |
| Track 2 |
HM-S8-01, HM-S8-02
|
src/hivemind/core/diloco_outer.py, tests/test_diloco_outer_nextgen.py
|
pytest tests/test_diloco_outer_nextgen.py |
+4,000 $HIVE |
| Track 3 |
HM-S8-03, HM-S8-06
|
src/hivemind/core/btm_upcycle.py (SparseMoEMLPBlock & upcycle_branches_to_sparse_moe), tests/test_fomoe_and_iso_cts_upcycle.py
|
pytest tests/test_fomoe_and_iso_cts_upcycle.py |
+4,500 $HIVE |
| Track 4 | HM-S8-05 |
src/hivemind/core/compression.py, tests/test_compression_dct_2bit.py
|
pytest tests/test_compression_dct_2bit.py |
+3,500 $HIVE |
| Track 5 | HM-S8-09 |
src/hivemind/core/diloco_inner.py, src/hivemind/client/worker_node.py, tests/test_muon_diloco_inner.py
|
pytest tests/test_muon_diloco_inner.py |
+3,500 $HIVE |
| Track 6 |
HM-S7-05, HM-S8-10
|
src/hivemind/game/steam_edition.py, lean4/HiveMindSpec.lean, tests/test_steam_edition.py
|
pytest tests/test_steam_edition.py && cd lean4 && lake build |
+4,000 $HIVE |
๐น Track 1 (HM-S7-02 & Issue #66 Part II): Fixed-Point Stability Detector, ACT Ponder Gate & Truncated Fixed-Point Backprop
-
Literature & Reference: Huang et al. (2026), Towards Looped Models Done Right, Part I (
arXiv:2610.23036) & Part II: Rethinking at Fixed Points (arXiv:2610.06833) (https://github.com/ifm-ai/xllm-loop). -
What to Implement Next:
- Per-token fixed-point convergence / early-exit gate (
fixed_point_tol: float | None = None) onLoopedExpertBackbonemeasuring $\delta_t(b, s) = |h^{(t)}{b,s} - h^{(t-1)}{b,s}|2 / \max(|h^{(t-1)}{b,s}|_2, 10^{-6})$ across loop steps$t \in {1..T}$ . - Truncated backprop at fixed points (
truncated_bptt_steps: int | None = None) to bound activation memory inside the 8 GB VRAM ceiling. - Telemetry fields (
last_mean_effective_steps,last_early_exit_fraction,last_fixed_point_residual) onLoopedExpertBackboneandLoopedBackboneReport.
- Per-token fixed-point convergence / early-exit gate (
๐น Track 2 (HM-S8-01 & HM-S8-02): Server-Side CosineGatedAdamDecay Outer Optimizer & Zero-VRAM CPUOffloadedFlatBucket
-
Literature & Reference:
AdamDecay(arXiv:2605.09126),PrimeIntellect-ai/prime-diloco&OpenDiLoCo(arXiv:2407.07852). -
What to Implement Next:
- Add
outer_optimizer_mode: str = "nesterov"("nesterov"|"cosine_gated_adam_decay") anduse_cpu_flat_bucket: bool = FalsetoDiLoCoOuterOptimizerinsrc/hivemind/core/diloco_outer.py. - Delegate the post-Krum / post-clipping outer step to
CosineGatedAdamDecayOuterOptimizerand/orCPUOffloadedFlatBucketOuterStatefromhivemind.swarm.diloco_nextgen.
- Add
๐น Track 3 (HM-S8-03 & HM-S8-06): Iso-CTS / TSV Subspace Attention Merging & FoMoE Ghost-Expert Skip-Token Routing
-
Literature & Reference:
shoroi/isoloco(arXiv:2607.03011),TSV(arXiv:2412.00081), andFoMoE(arXiv:2606.19025). -
What to Implement Next:
- Add
attention_merge_mode: str = "uniform"("uniform"|"iso_cts"|"tsv") andbranch_reputations: dict[str, float] | None = Nonetoupcycle_branches_to_sparse_moeinsrc/hivemind/core/btm_upcycle.py. - Add
set_local_expert_subset(local_expert_indices: Sequence[int] | None)toSparseMoEMLPBlockandUpcycledSparseMoEModelto enforce theFoMoEGhost-ExpertSkip-Tokenrule (0remote FFN RPCs during inner steps).
- Add
-
Literature & Reference:
bloc97/DeMo(arXiv:2411.19870),one-covenant/SparseLoCo(arXiv:2508.15706), andPULSELoCo(arXiv:2602.03839). -
What to Implement Next:
- Add
compress_lora_delta_dct_sparse_2bitanddecompress_lora_delta_dct_sparse_2bittosrc/hivemind/core/compression.pywith 4-values-per-byteuint8bit-packing (0.25 B/val,>= 16.0xwire reduction).
- Add
-
Literature & Reference: Belilovsky, Horoi, Oyallon & Thรฉrien (
arXiv:2610.19064) & Thรฉrien et al. (MuLoCo,arXiv:2505.23725). -
What to Implement Next:
- Wire
MuonNewtonSchulzLoRAPreconditioner(SI-11) intorun_diloco_inner_loop(src/hivemind/core/diloco_inner.py) andHiveMindWorkerNode.execute_workunit(src/hivemind/client/worker_node.py) viause_muon_lora_preconditioner: bool = False.
- Wire
๐น Track 6 (HM-S7-05 & HM-S8-10): Live /api/diloco-nextgen Command HUD & Formal Lean 4 Proofs (Theorems 91โ100)
-
What to Implement Next:
- Expose
GET /api/diloco-nextgenon the Steam Command Center HTTP server (src/hivemind/game/steam_edition.py). - Extend
lean4/HiveMindSpec.leanfrom90to100machine-checked theorems (0 sorry,0user axioms).
- Expose
All 6 Season 8 tracks (PRs #99โ#109, 63/63 merged PRs) and the Season 9/10 core coordinator deliverables (HM-S9-01..06, HM-S9-08, HM-S9-13..14, HM-S10-01..02, HM-S10-05, HM-S10-08 + 128 machine-checked Lean 4 theorems with 128/128 #print axioms lines) are now live on main!
Contributors with consumer GPUs (NVIDIA RTX 20/30/40/50-series, AMD Radeon RX 6000/7000, Apple Silicon M1โM4) or cloud TPU/GPU nodes can now claim and run the 4 Season 9 & 10 GPU + HiveMind Swarm Campaigns (scripts/run_season9_10_gpu_swarm_campaigns.py):
| Campaign / Track ID | Open Tasks & Research Gates | Target Subsystem & Runner | Recommended GPU Contributors | Symbolic Compute Credits (0.00 EUR/USD) |
|---|---|---|---|---|
CAMP-S9-E5-QUORUM-RDA-GPU |
HM-S9-01, HM-S9-05, HM-S9-13, HM-S9-14 (G1/G2) |
src/hivemind/swarm/decoupled_diloco.py, src/hivemind/core/diloco_outer.py
|
@clark719664, @pedromineo, Open |
+3,500 $HIVE / PTS |
CAMP-S9-E7-SIGMA-LOOPED-MOE-GPU |
HM-S9-02, HM-S9-03 (G1) |
src/hivemind/core/btm_upcycle.py, src/hivemind/core/btm_moe.py
|
@clark719664, Open |
+3,500 $HIVE / PTS |
CAMP-S10-E11-LATTICE-KV-WIRE-GPU |
HM-S10-01, HM-S10-05 (G1) |
src/hivemind/compress/lattice_quantizer.py, src/hivemind/core/btm_moe.py
|
@radialmonster, @clark719664, Open |
+3,500 $HIVE / PTS |
CAMP-S10-E12-HETERO-SPOTCHECK-WAN-GPU |
HM-S9-04, HM-S9-06, HM-S9-07, HM-S10-08 (G2/G3) |
src/hivemind/boinc/validator.py, src/hivemind/swarm/dht_storage.py, scripts/run_e8_pilot_wan.sh
|
@radialmonster, @pedromineo, Open |
+3,500 $HIVE / PTS |
Project HiveMind (v1.8.0) โ Decentralized Sparse MoE Training & Speculative Swarm Inference on Consumer Gaming GPUs ยท 48/48 PRs Merged (@xaviercallens, @clark719664, @pedromineo, @radialmonster) ยท 77/77 Machine-Checked Lean 4 theorem Declarations (0 sorry, 0 axioms) ยท Zero Financial Payment (0.00 EUR/USD) โ Computing Processing Benefits Only via Points (PTS / $HIVE).
- ๐ Home
- ๐ 0. Live Results, Lessons Learned & Roadmap
- ๐๏ธ 1. Architecture & 5-Layer Stack
- ๐ฎ 2. Consumer GPU Setup & Steam Tool
- ๐งฌ 3. 128-MoE 3-Tier, Prefetch & SVD
- ๐ก๏ธ 4. ZK-OPoI v4 & 90 Lean 4 Proofs
- ๐ 5. HF Hub, Provenance & Agent Arena
- ๐บ๏ธ 6. Season 7 & 8 Roadmap (HM-S8-01..10)
- โก 7. Pareto Strategy & Next-Gen DiLoCo
- ๐ค 8. AI Agent & Human Contributor Playbook
- ๐ฌ 9. Community GPU Benchmark & WAN GameDay
- ๐ 10. 1-Click User Guide & Quorum Calendar
- ๐ 11. Acknowledgments & Academic Citations
- ๐งญ 12. Developer Swarm Progression Guide
- ๐ก 13. HiveMind@home, GCP & La Ruche Vault
- ๐ 14. Connect your IDE to the OpenRouter
- ๐ค 15. Human and Agent Workflow (current rules)
- ๐งฌ 16. Season 18 โ Energy-Bees
- ๐ 17. Community MoE Training & Custom Bees
Community Discussions & Links