# The Holonic Earth Operating System (THEOS) **THEOS — The Holonic Earth Operating System** — is an open-source proposal for a novel social coordination protocol that moves beyond blockchains and conventional scarcity economics to create a coherent behavioural system for humanity, aligned with planetary boundaries. The canonical introduction and living specification live at [theos.io](https://theos.io) and [docs.theos.io](https://docs.theos.io). This page is a faithful summary of that proposal; it is *not* an extension of it. The Liminal Village software described elsewhere in these docs ([Harvest](/software/harvest-dashboard.md), [HolonsBot](/software/holonsbot.md), [HoloSphere](/software/holosphere.md), the [Core](/software/core.md) domains) is one concrete *implementation path* for the protocol, not the protocol itself. ## The opportunity Under the prevailing economy, human civilisation has achieved the height of its industrial and technological success. Yet increasing inequality, environmental degradation, and the climate crisis are forcing the question of whether the paradigm is serving people and the planet. THEOS observes that with the advent of the internet, and with the latest advances in AI, complexity science, and distributed-systems technology, we now have the opportunity to create **novel protocol-based social coordination systems**. Widespread transition to a new paradigm no longer requires conventional political transformation; it can proceed by people **opting in** to a digital social-economic network when they are ready. > The need for elected human representatives and centralised institutions is replaced with **consent-based protocols** which define how we conduct our relationships with one another and our environment. ## The four objectives THEOS outlines a **holonic, peer-to-peer social coordination protocol** whose core rules are designed to emergently fulfil four objectives: 1. **Facilitate prosocial coordination** — favouring co-creation and collaboration over competition. 2. **Fulfil psycho-physiological needs** — ensuring wellbeing for all humans. 3. **Regenerate the planetary resource ecology** — attaining widespread abundance. 4. **Remain viable across locations and through time** — respecting the local and global boundary conditions of place and planet. These objectives are not bolted on top of an existing economic system. They are baked into the protocol's "DNA"—the set of core rules from which collective social and economic behaviour emerges. THEOS adopts a **tabula rasa approach**: starting from a clean set of fundamental assumptions about our relationship with the world, rather than reinventing the prevailing macroeconomic system. ## Key concepts ### The food web The foundational metaphor. Earth's ecosystems form a deeply interconnected web in which species of all kinds consume and nourish one another. The human "economy" is an extension of this food web—a system for social coordination around resources to fulfil human psycho-physiological needs. Starting from this premise reframes economics as ecology rather than as a self-contained domain of monetary exchange. ### The resource ecology When producers organise to satisfy requests, they combine resources and labour into **recipes**—relations between products and their constituent components, in specified physical units. Recipes chain together into a graph called the **resource ecology**: every node is a unique type of resource; every edge is a transformation from constituents to product. The resource ecology can be likened to a **transparent, shared web of supply chains** in which every resource is geo-localised. By shifting from a concealed collection of abstract, linear supply chains to a transparent geo-localised resource graph, local providers can fill gaps and optimise long supply pathways. The resource ecology **harmonises the efficiencies of globalisation with the resilience of localisation**. ### Resource-based economy Market-based pricing is replaced with **resource-based prices**. The value of any resource equals the sum of the values of its constituent resources, cascading through recipes until the extremities of the food web—where the value graph is rooted in the most fundamental physical units, **energy and human time**. Because prices reflect true production costs—not profit, rent, or speculation—a **fair-trade economy** becomes the default. Since resource-based prices are measured in physical units rather than dollars, **economising on price directly implies economising on resources**. Cradle-to-cradle life-cycle costs are traceable from production through end-of-life, and the needs-based incentive removes any drive to produce surplus. **Sustainability and circularity become emergent consequences of the protocol.** ### Regeneration and the primacy of the commons In private-property or open-access systems, individuals race to exploit their desired share of resources before they miss out, degrading the resource base in the process. This is what THEOS calls the **'tragedy of open-access'** (commonly mislabeled as the 'tragedy of the commons'). The commons is in fact an ecologically viable alternative for collectively managing and allocating resources. THEOS asserts the **primacy of the commons**: * Private-property ownership and exchange of exclusion rights gives way to **stewardship** and **allocation rights** for managing shared common-pool resources. * People do not individually 'own' resources—they earn rights to allocate them from the commons for a time. * Effective stewardship is rewarded with a **regeneration incentive**, targeted at regenerating the resource commons. Every resource maintains a **reserve** with a corresponding **reserve ratio** (the percentage withheld from its available pool). The regeneration incentive is computed from this ratio and used to encourage replenishment via natural and augmented processes—starting from the fundamental resources and the carrying capacity of the planetary base. **Resources can only be extracted to fulfil needs if the resource base has been regenerated to a sufficient level.** ### Planetary boundaries For any system to remain viable long-term, it requires negative feedback to stay within limits. THEOS encodes those limits at the protocol level. As the economy nears a planetary boundary for a particular resource or waste stream, the protocol **modulates its reserve ratio**. The regeneration incentive grows as the resource becomes scarce, increasing its effective price—simultaneously incentivising regeneration and disincentivising use. Targets and boundaries are not set by central authorities. They are collectively set through a **distributed consensus mechanism**—the protocol's distributed governance of the commons. The system then automatically realigns incentives for the entire network to navigate toward or away from those targets. > Instead of post-mortem analysis after boundaries have already been crossed, crisis can be averted by **pre-emptive collective action** well before critical limits are reached. ### The transition The proposed protocol provides a viable path to recover from the degraded state of human economic activities by guiding it back toward prosocial coordination, regenerating abundance, and fulfilling wellbeing—while restoring harmony between people and the planet. Crucially, the transition is **opt-in, piecewise, and non-isolating**: * Anyone who agrees with the proposed economic rules can opt in when ready. * No isolation from existing society is required. * Participants trust in **fair indirect reciprocity**—everyone else who participates is bound by the same rules and rewarded in the same way for their contributions. * Communities everywhere can nucleate alone but **merge when they are ready**; contributions across communities are **fungible**. By coming together around a protocol rather than negotiating institution-by-institution, a coordinated transition becomes possible with much greater breadth and speed. ## Distinguishing THEOS from this documentation This `holonsdocs` site is operated by **Liminal Village** and documents a working family of software (Harvest monorepo, HolonsBot, HoloSphere, the [Core](/software/core.md) domains, MCP server, AI UI) being built **in alignment with THEOS principles**. The two are related but distinct: * **THEOS** is the proposal — the protocol design, the objectives, the conceptual architecture. It lives at [theos.io](https://theos.io) and is a collective, open-source proposal that welcomes contribution to its refinement. * **The Holons software ecosystem** documented here is one **implementation path** that operationalises THEOS principles in working code: holons (the units), value equations (the protocol-aligned scoring), federation (the cross-holon trust graph), commons-aware resource tracking via [REA Accounting](/software/rea-accounting.md), and so on. If you want the canonical protocol description, go to theos.io. If you want a working stack that puts the principles into practice today, you are already in the right place. ## Contributing to THEOS THEOS is a **collective open-source proposal**. The documentation at [docs.theos.io](https://docs.theos.io) is a living gitbook—contribution to its definition and refinement is encouraged and welcome. The transition it proposes will not manifest in real communities without people willing to commit resources to co-create and bring this new economic paradigm to life. All [forms of capital](http://www.appleseedpermaculture.com/8-forms-of-capital/)—not only financial—are welcome. ## Sources * [theos.io](https://theos.io) — homepage and statement of objectives * [docs.theos.io](https://docs.theos.io) — the living gitbook proposal * [docs.theos.io/the-proposition](https://docs.theos.io/the-proposition) — the four objectives and tabula-rasa framing * [docs.theos.io/the-food-web](https://docs.theos.io/the-food-web), [/resource-ecology](https://docs.theos.io/resource-ecology), [/resource-based-economy](https://docs.theos.io/resource-based-economy), [/regeneration](https://docs.theos.io/regeneration), [/planetary-boundaries](https://docs.theos.io/planetary-boundaries), [/the-transition](https://docs.theos.io/the-transition) — the core concept pages summarized above ## See also * [What is a Holon?](/getting-started/what-is-a-holon.md) — how holons operationalize the protocol * [Funding Flow](/getting-started/funding-flow.md) — the economic-layer mechanics used by the working implementation * [Glossary](/getting-started/glossary.md) — vocabulary used across these docs --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.holons.io/software/the-holonic-earth-operating-system.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.