-
-
Notifications
You must be signed in to change notification settings - Fork 0
Disambiguation
Three projects share the Greek root οἶκος ("household", "habitat"). They are otherwise unrelated, and confusing them wastes real time.
| Name | What it is | Where it lives |
|---|---|---|
| OikosBot | This project. A code-analysis bot adding an ecological & economic lens to pull requests and to whole estates. Crates: oikosbot-*
|
hyperpolymath/oikosbot |
| oikos | A DSL — a typed surface language for stock-flow-consistent macroeconomic models (Godley & Lavoie). Crates: oikos-*
|
hyperpolymath/oikos-economics-accounting-dsl |
| sustainabot | A reserved, empty member slot in the gitbot fleet |
hyperpolymath/gitbot-fleet → bots/sustainabot/
|
-
oikosbot-*→ this repository -
oikos-*→ the DSL repository
Do not add oikos-* crates here, and do not reintroduce the sustainabot name. An implementation that briefly lived in the fleet's sustainabot/ slot was a misfiled copy of OikosBot; it was moved here and renamed.
The same rule governs the data repository: it is oikosbot-estate, not oikos-estate.
The published image is ghcr.io/hyperpolymath/oikos — no bot.
The image name says oikos; the image contains OikosBot. The two projects were one repository until mid-2026, and the image name predates the split. Do not "correct" it, and do not assume it holds the DSL.
They answer genuinely different questions. OikosBot measures what software costs and what repositories produce. The DSL models economies — sectors, accounts, balance sheets, transaction-flow matrices — with the intended guarantee that a model violating an accounting identity does not compile.
There is one real point of contact: the estate ledger OikosBot builds is stock-flow-consistent by construction (every flow debits one account and credits another; stocks reconcile against accumulated flows). If the DSL's compiler backend is ever completed, that ledger is a live, numerically-real model waiting to be its proving ground. The dependency points forward — OikosBot is not blocked on the DSL.
Eclexia (hyperpolymath/eclexia) is a general-purpose, Turing-complete language implementing the "Economics-as-Code" paradigm, with dimensional types where money, carbon and information are first-class base dimensions alongside SI units. OikosBot uses .ecl files as a policy surface, but Eclexia's scope is far broader than this bot, and the intended long-run direction is that OikosBot is implemented in Eclexia — not the reverse.
Authoritative source: DISAMBIGUATION.adoc.