Introduction
an open-source protocol for modular, purpose-aligned coordination
Holons provide a new way of organizing coordination in complex systems. Instead of relying on centralized platforms, rigid hierarchies, or loose networks with unclear responsibilities, holons enable autonomous units to collaborate through shared protocols for value flow, commitments, and accountability. Each holon acts as both a whole and a part, able to self-govern internally while participating in larger patterns of collaboration.
This architecture is designed for environments where relationships matter more than transactions, where resources are diverse (not only money), and where groups must act together without giving up their independence. Holons create a common language for commitments, contributions, and exchanges, allowing any group to coordinate with any otherβwhether they are families, cooperatives, nonprofits, DAOs, bioregional hubs, or global alliances.
At the core is a simple idea: make relationships economically meaningful. Instead of abstracting complexity away, holons reveal how value actually movesβtime, care, knowledge, tools, land, money, infrastructure, and social capital. By doing so, they enable more equitable collaboration, clearer agreements, and a shared understanding of who contributes what, to whom, and under which conditions.
Holons function through modular smart-contract templates that communities can easily deploy and compose. These templates include contribution agreements, funding buckets, flow splitters, threshold triggers, value equations, and federation structures. Combined, they form a lightweight but expressive operating system for decentralized coordination.
This approach does not replace existing toolsβit complements them. Holons can work alongside traditional accounting, governance, or project management systems, providing a missing layer: transparent, programmable economic relationships across organizational boundaries.
By adopting holons, groups gain:
Clarity: Explicit, trackable commitments and resource flows.
Autonomy: Each group maintains self-governance while participating in wider networks.
Interoperability: Holons can connect across sectors, regions, and technologies.
Resilience: Distributed value flow reduces dependency on central intermediaries.
Fairness: Contributions and responsibilities are recognized across the entire ecosystem.
Holons are a shift in how we collaborate. They enable a move from competitive silos to regenerative networksβwhere value circulates, relationships strengthen, and collective intelligence becomes visible.
This introduction serves as a doorway into the architecture, patterns, and use cases that follow. The pages ahead explore how holons can be applied to real-world coordination challenges: from funding regenerative projects, to running nonprofits, to enabling bioregional governance, mutual credit, disaster relief, and new forms of digital organizations.
Holons are a foundation for a future in which collaboration scales with trust, transparency, and shared purpose. Welcome.
Where to start
These docs cover three layers: the protocol (what holons are and how they coordinate), the software (the working implementation), and the applications (concrete use cases).
A recommended reading order:
What is a Holon? β the 5-minute conceptual frame.
Run Your First Holon β practical levels from a chat group to an MCP-callable federated holon.
Funding Flow β the economic layer (splitters, thresholds, value equations, federation).
Glossary β the single source of truth for vocabulary.
Harvest and The Shared Core β the software architecture.
Application Areas β concrete scenarios.
If you're returning after a while, see Migration Notes for what's moved. If you're stuck, the FAQ probably has the answer.
Last updated
Was this helpful?