What is a Holon?

A five-minute introduction before diving into the rest of the docs

The word holon comes from Greek: holos (whole) + on (part). A holon is a thing that is simultaneously a whole and a part of something larger. Your body is a holon: it is a whole organism, and it is part of a family, a community, an ecosystem. A team is a holon: a whole working unit, and a part of an organization.

The Holons protocol takes this idea and makes it usable as a coordination tool. Every group—family, team, cooperative, neighborhood, region—can run as a holon: self-governing internally, and composable with other holons externally.

This page is the short version. For the full architecture see Funding Flow; for definitions of every recurring term see the Glossary.

The four ideas that make a holon work

A working holon needs to answer four questions. Each has a primitive in the protocol.

1. What holds it together? — the membrane

A holon has a membrane: a flexible boundary that defines who is in, what the holon is for, and what it values. Membranes are semi-permeable—people, resources, and information cross in and out under conditions the holon sets for itself. The membrane is what gives the holon an identity distinct from its surroundings.

2. What is valued inside? — the value equation

Each holon defines its own value equation: a formula that converts contributions (hours, outcomes, appreciations, relationship-building) into points, and points into shares of whatever the holon distributes. Two holons can run identical software and produce very different cultures, simply by tuning the weights.

A common starting equation:

Points = (Hours × Hour_Weight) +
         (Appreciations × Appreciation_Weight) +
         (Outcomes_Delivered × Outcome_Weight)

Share  = Points_Individual / Points_Total

3. How do resources move? — splitters and thresholds

When resources flow into a holon, they are routed by primitives:

• A Splitter divides incoming flow between destinations—often between internal contributors and external ecosystem partners, with a single dial controlling the balance.

• A Threshold Bucket accumulates resources until a minimum need is met, then sends overflow to a downstream holon or federation pool.

Together these primitives make it possible to say: "fund what we need first, then share the surplus with the people who help us thrive."

4. How does it connect to others? — federation

Holons federate by declaring trust relationships with other holons. A federation can be as light as "we share appreciation data" or as committed as "we share a mutual-aid treasury." Once federated, value can flow across holon boundaries under the rules each holon defines for itself. This is how a coffee co-op, a regional fund, and a bioregional alliance can act as one network without giving up their autonomy.

A concrete picture

Imagine a community garden running as a holon:

1. The garden is a Telegram group. Members add the HolonsBot and declare a purpose ("steward this land, feed the neighborhood").

2. Members use /appreciate to recognize each other's work—weeding, watering, hosting workshops. Appreciations accumulate as a public record.

3. The garden runs a value equation that weights appreciations heavily, hours moderately, and outcomes (harvests, workshops delivered) the most.

4. A small grant arrives. A splitter sends 70% to active contributors (proportional to points) and 30% into an ecosystem pool shared with three nearby gardens.

5. The four gardens have federated: when any one of them has surplus, it overflows into the shared pool, which redistributes to whichever garden currently needs it most.

Nothing here required a central authority. The rules are explicit, the record is public, and every holon retained its autonomy.

Where to go next

• Want the architectural depth? Read Funding Flow — the full whitepaper on contracts, distribution mechanisms, and federation.

• Want a specific shape of holon? See Holon types (flavor) for composable patterns: Splitter, Managed, Zoned, Appreciative.

• Want to set one up? Start with Setting up your holonic organization.

• Want a specific use case? Browse the Application Areas — non-profits, bioregional regeneration, mutual aid, family management, and more.

• Stuck on a term? The Glossary is the single source of truth for vocabulary.