MAXIM
Maxim Hivemind + Oasis
Federated Bio-Substrate Layer for Collective Cognition
Status
As of 1.3.3 (October 2026): the core of this design has shipped. 1.2.0 “Oasis” delivered the peer-to-peer substrate exchange end to end: ed25519-signed substrate bundles, authenticated exchange endpoints, the maxim oasis serve/publish/status and maxim hive add/list/pull/contribute/trust commands, and Queen-only default trust, where a pull refuses any release not signed by a key the operator has registered as a trusted publisher (a “Queen”). It builds on the merge path that 1.1.3 wired end to end after finding it unreachable (see Reachability). 1.3.1 froze the public bundle format as a compatibility promise and added a signed release format in which every member is signed and each key numbers its releases, so a receiver refuses a second payload under the same number or a downgrade to an older format. It also fixed a merge that overwrote a receiver’s own causal links when they differed only in context.
What it has shown: in a live Minecraft world with no LLM in the action path, a want taught to one agent transferred to an independent agent and changed what it did at first contact (1.2, earned); pooling partial learners let each agent reach criterion in fewer of its own trials but cost more total experience (1.2, partial); and a survival fear learned from drowning pain transferred to an agent that never felt it (1.3, now partial: a plain tabular learner matches the fear learning itself, see Floors). Not yet shipped: Queen-tier promotion (the gauntlet that would score a bundle does not exist yet, so contributions stay in the experimental tier) and Oasis discovery (the registry is static and operator-maintained). Shared wants are still keyed to the exact situation they were learned in. Details: the Oasis guide and the 1.2 and 1.3 release notes, which also record that the 1.3 fear-transfer bundles were exported unsigned.
Contents
What this is
The Maxim Hivemind is a peer-to-peer substrate-sharing layer that lets multiple Maxim instances exchange learned bio-substrate (NAc causal weights, EC concept centroids, reflex thresholds, Cerebellum forward models, ATL semantic concepts). It is not a service — nobody hosts "the Hivemind." It is a protocol + portable data format + exchange convention.
A Maxim Oasis is a persistent, substrate-primary Maxim instance that runs on operator hardware (a Mac Mini, a server, an old laptop, a Raspberry Pi 5 cluster), accepts substrate contributions from connected Maxims, processes those contributions as percepts through its own bio-stack, distills consensus patterns, and broadcasts to the Hivemind. Multiple Oases coexist; nobody is THE Oasis. Each Oasis is a full bio-agent in its own right, not a passive database.
Why this exists
The headline insight that motivated promoting the old Mother Maxim plan from deferred to active:
Every LLM-AUT run (an LLM acting as the agent-under-test's action selector) already trains a bio-substrate as a side effect. When a user runs maxim --sim "...some D&D campaign...", the bio-systems are running underneath: NAc forms causal links from tool outcomes, EC clusters concepts, ATL builds semantic structure, Hippocampus captures episodes. Ordinary use trains the substrate, just with an LLM-driven action selector instead of a substrate-driven one.
That changes the federated-learning calculus radically:
1. The Hivemind has rich seed data immediately
It doesn't have to wait for substrate-primary mode to mature. Day-1 contributions come from existing LLM-AUT users.
2. Substrate-primary Maxims bootstrap from accumulated experience
Once substrate-primary mode matures, new instances could pull a baseline substrate from the Hivemind rather than starting from zero, which should speed up substrate-primary development.
3. The privacy surface collapses
Distilled bio-substrate doesn't carry the same PII risk as raw episodes. The 700-LOC dual-pass deidentification pipeline from the old plan becomes optional polish rather than load-bearing safety.
4. LLM-AUT mode gets a permanent role
It's not transitional waiting to be replaced; it's the perpetual data-collection mechanism that feeds the Hivemind. Users running D&D campaigns today are inadvertently training tomorrow's substrate-primary cognition.
What's shareable — and what stays local
| Substrate component | Shareability | Privacy risk | Hivemind value |
|---|---|---|---|
| Reflex specs + thresholds | Trivial — pure config | Zero | High |
| NAc causal weights | High — Bayesian aggregation | Low | Very high |
| EC concept centroids | Medium — encoder-dependent | Low (after identity scrub) | High |
| Cerebellum forward models | Medium — parameter snapshots | Zero | Medium |
| ATL semantic concepts | Medium — cluster purity | Low | Medium |
| Hippocampus episodes | LOW — literal records | HIGH | Low |
| Working memory | None — ephemeral | High | Zero |
Default policy: ship everything in the top section. NEVER ship hippocampus episodes through the Hivemind. Episodes are local-only by construction. The single exception: an Oasis may receive hippocampus episodes from connected Maxims as private contributions to its own substrate (it processes them as percepts), but it never re-broadcasts them. Episodes feed the Oasis's substrate; only the Oasis's distilled substrate ever leaves.
The Oasis
What an Oasis does
- Accepts substrate contributions from connected LLM-AUT or substrate-primary Maxims
- Processes contributions as percepts through its own bio-stack (NAc/EC/ATL/Hippocampus all run continuously)
- Distills consensus patterns: aggregates NAc links across contributors via Bayesian confidence math
- Broadcasts its distilled substrate to the Hivemind on a configurable cadence
- Syncs substrate snapshots from peer Oases and from substrate-primary Maxim instances
Why "Oasis"?
A bio-coherent metaphor: an oasis is a sustaining gathering place that travelers approach to refresh themselves and that produces life from accumulated water/nutrients. Maxims approach an Oasis to contribute experience and to receive distilled patterns. Multiple oases coexist in a desert ecosystem; no single one is canonical; together they form a network.
Hardware footprint
A Mac Mini, an old laptop, or a Raspberry Pi 5 cluster is sufficient to run an Oasis IF substrate-primary mode is the operating mode (no LLM, just bio-systems running). While substrate-primary is still maturing, Oases may need a small LLM (e.g., qwen-7B) to process LLM-AUT contributions. Once substrate-primary mode is validated, Oases can run pure-substrate and Mac-Mini-class hardware suffices.
Multiple Oases, no central authority
There is no THE Oasis. Each operator runs their own. A natural evolution emerges:
Personal Oasis
Your Mac Mini, hosting substrate from your own Maxims and friends.
Community Oasis
A Discord server or research group running an Oasis their members contribute to.
Public Oasis
Eventual reference instances anyone can connect to.
The Hivemind
Substrate snapshot bundle
The unit of exchange. A versioned, signed archive containing:
maxim-substrate.zip
├── manifest.json # _format_version, schema_version, contributor_id, domain, signature slots
├── nac.json # causal links + confidence + provenance tags (v1.0)
└── ec.json # concept centroids + cluster metadata (v1.0)
ATL, reflexes, and Cerebellum payloads are reserved for a later format version (the migration-registry seam is already in place). Schema-stable, version-aware, scrubbable. Extends the existing _format_version contract per Maxim's v1.0 freeze.
Substrate domains
Bundles are tagged by substrate domain (combat, cooking, medical, fantasy, robotics, conversation, ...). Subscribers opt into specific domains. Two purposes: relevance (a medical-AI hobbyist doesn't want combat patterns polluting their substrate) and curation (domain maintainers can flag bad patterns).
Conflict resolution
Two Maxims learn opposite things ("X is good" vs "X is bad"). On merge, the Hivemind uses NAc's existing confidence math:
- Confidence aggregates Bayesian-style across contributors
- Multi-source confirmation weighted higher than single-source
- Outcome valence (positive vs negative) preserved as separate distributions
- Provenance preserved — receivers can selectively trust patterns from specific contributors
When real conflict persists (e.g., 50 Maxims learned each side), the Hivemind preserves both with full distributions. The local Maxim's behavior remains coherent because it weights its own learning above any single Hivemind pattern.
Poison resistance
Adversaries trying to corrupt the Hivemind by spreading bad learning are mitigated by:
- Multi-source consensus — patterns require N independent contributors before promotion
- Domain curation — domain maintainers can flag specific contributors as untrusted
- Local provenance tracking — every pattern carries source tags; receivers can blacklist sources
- Outcome correlation check — Hivemind patterns that hurt locally are weighted lower over time (the substrate naturally distrusts patterns that hurt it)
- Identity-bearing concept detection — patterns that map to specific named entities are quarantined automatically
This won't be perfect — pure peer-to-peer systems with open contribution always have an arms race with abuse. Mitigations are practical, not theoretical.
Phasing
This is the phasing as planned in May 2026. The version targets were a plan, not a record of what shipped; the status box at the top of this page is current as of 1.3.3.
| Version | Substrate-primary | Oasis | Hivemind |
|---|---|---|---|
| v1.0 | Feasibility prototype (Phase −1) + Phase 0 harness + shareability infrastructure | Format exists. No software runs. | None. |
| v1.1 | Substrate-primary AUT mode lands. Phase 0 validation. Phase 1 starts. | Oasis software ships (~800 LOC). Mac-Mini hostable. maxim oasis serve. |
Direct Oasis-to-Oasis sync only. |
| v1.2 | Phase 1 ships. Substrate-primary Maxims pull bootstrap. | Multi-Oasis federation. Curation tools. | Full Hivemind P2P protocol (~600 LOC). |
| v1.3+ | Phase 3 from-scratch sequence model. | Pure substrate-primary; no LLM needed. | Cross-version migration; domain ecosystem. |
What got dropped from the old Mother Maxim plan
The 2,224-line Mother Maxim plan was designed in the LLM-AUT-only world where memories (dialogue + episode traces) were the unit of value. The 2026-05-09 substrate-primary pivot reframed the architecture significantly.
Dropped
- Pecking Order Graph hierarchy → flat peer-to-peer mesh
- Database backend (SQL) → portable file-based snapshots
- Dual-pass deidentification (700 LOC) → ~80 LOC identity-bearing detection (no raw episodes shipped)
- Central Mother server → multiple peer Oases
- REST
/v1/contribute→ Hivemind P2P protocol - Tenant isolation → substrate domains + opt-in subscription
Preserved
- Mother-as-full-agent → Oasis is a substrate-primary Maxim instance
- Bio-system identity-bearing concept detection → ported into the 1.0 shareability work
- Substrate-stays-private invariant → hippocampus-episodes-never-leave
- Multi-tenant separation → substrate domains
Reference on pymaxim.bio
This page is the design story. Install steps, CLI flags, configuration, and the current evidence live in the docs: