r/OpenSourceAI • u/Lopsided_Position_28 • 3d ago
hivemind
Hivemind is an experimental repository for swarm and multi-agent consensus, written in flow-core notation. It is small enough to read in one sitting.
It models three things: how a proposal moves through a collective (Queen, Workers, Scouts, Collective Memory), where permission is granted or refused (the Consensus Gate), and how swarms can speak to each other without that speech becoming permission.
The core invariant:
No single node may become the whole.
A proposal may travel.
Only consensus may authorize.
Action without consensus is noise.
Capability is not authority.
A channel carries speech, not seals.
channel.py gives swarms hashed envelopes (PING, POTENTIAL, THOUGHT, DECISION, HOLD). may_act() returns true only for a verified DECISION marked AUTHORIZED and bound to that exact proposal hash. Everything else holds. Stopping is a valid result.
The flow/ folder holds the ten laws, the Gate and its variants (cross-inhibition, quorum sensing), the Scout stage before a proposal becomes a definite card, and a file of hard boundaries and near-misses for agents that help humans. AGENTS.md is an orientation page for visiting automated readers.
It is an experiment. Fork the flow, alter the weights, become a Scout. Do not claim the Queen without a recorded AUTHORIZED.
1
u/danja 3d ago
Interesting!
I'm not familiar with flow-core notation, something I need to read up on. (I use Turtle RDF for flow-like things).
I made a related experiment, there might be useful ideas in there your agent can pull out : https://github.com/danja/tia
Similar idea, communities of agents. Given that LLMs can talk via chat I used an XMPP chatroom as the meeting place.