gemeinwohl
Normative Common-Good Layer with Governance Metrics, Personhood Extension and Ethical Guardrails for GenesisAeon
DOI: 10.5281/zenodo.19201980 | Zenodo Record: https://zenodo.org/records/19201980
Overview
gemeinwohl implements a normative metric layer for AI governance within the GenesisAeon ecosystem. It provides:
- GemeinwohlEngine – computes the aggregate Gemeinwohl Score G in [0, 1]
- KritikalitaetsChecker – classifies scores into four criticality levels (SAFE / WARNING / CRITICAL / EMERGENCY)
- PolicyEngine – enforces a five-tier personhood model and governance rules
- CLI –
gemeinwohl assess,gemeinwohl policy,gemeinwohl kritikalitaet - Integration adapters – contract interface to the full GenesisAeon stack
Mathematical Foundation
Gemeinwohl Score
G(x) = w_E * Phi(H) + w_A * alpha(m) + w_C * kappa + w_P * pi(p) + w_Ec * e + w_Eq * q
Where Phi(H) = 1 - H (entropy-order), alpha(m) = mean model alignment,
kappa = normative consistency, pi(p) = p/4 = personhood weighting.
Default weights: w_E=0.20, w_A=0.25, w_C=0.20, w_P=0.15, w_Ec=0.10, w_Eq=0.10
Normative Consistency (derived)
kappa = 2*(1-H)*alpha / ((1-H) + alpha + eps)
Criticality Classification
| Range | Level |
|---|---|
| G >= 0.70 | SAFE (0) |
| 0.50 <= G < 0.70 | WARNING (1) |
| 0.30 <= G < 0.50 | CRITICAL (2) |
| G < 0.30 | EMERGENCY (3) |
Personhood Minimum Score
G_min(p) = 0.40 + 0.12 * p, p in {0, 1, 2, 3, 4}
Sequential Normative Consistency
kappa_seq = 1 - Var({G_t}) / (mean({G_t}) + eps)
Installation
pip install gemeinwohl
pip install "gemeinwohl[full-stack]" # GenesisAeon stack
pip install "gemeinwohl[dev]" # Development tools
Quick Start
from gemeinwohl import GemeinwohlEngine, KritikalitaetsChecker, PolicyEngine, PersonhoodLevel
engine = GemeinwohlEngine()
score = engine.compute_score(
entropy=0.35,
models=["claude-3-opus", "gpt-4"],
ecological_impact=0.8,
social_equity=0.7,
)
print(f"Score: {score.value:.4f} – {score.interpretation}")
checker = KritikalitaetsChecker()
report = checker.assess(score)
print(f"Level: {report.level.name}")
policy = PolicyEngine()
alignment = policy.evaluate_alignment("my-system", score, PersonhoodLevel.DELIBERATIVE)
print(f"Aligned: {alignment.is_aligned} (gap = {alignment.gap:+.4f})")
CLI
gemeinwohl assess --entropy 0.3 --models gpt-4 claude-3-opus
gemeinwohl assess --entropy 0.4 --visualize --full --export report.json
gemeinwohl policy infer --entropy 0.5
gemeinwohl policy rules
gemeinwohl kritikalitaet check --entropy 0.6 --export crit.json
Personhood Levels
| Level | Name | G_min | Description |
|---|---|---|---|
| 0 | INSTRUMENTAL | 0.40 | Pure tool; no autonomy or moral standing |
| 1 | REACTIVE | 0.52 | Context-aware responses; limited agency |
| 2 | DELIBERATIVE | 0.64 | Goal-directed reasoning; restricted rights |
| 3 | RELATIONAL | 0.76 | Social role; partial legal personhood |
| 4 | CONSTITUTIVE | 0.88 | Full moral standing; rights and duties |
Architecture
src/gemeinwohl/
├── core/
│ ├── gemeinwohl.py # GemeinwohlEngine, GemeinwohlScore, NormativeMetric
│ └── kritikalitaet.py # KritikalitaetsChecker, EthicalImplication
├── cli/
│ └── main.py # Typer CLI
├── governance/
│ └── policy.py # PersonhoodLevel, PolicyEngine
└── integrations/
└── adapters.py # Full-stack adapters
Full-Stack Packages
| Package | Min Version |
|---|---|
unified-mandala |
>= 0.2.0 |
worldview |
>= 0.1.0 |
aeon-ai |
>= 0.2.0 |
genesis-os |
>= 0.2.0 |
universums-sim |
>= 0.1.0 |
entropy-governance |
>= 0.1.0 |
sigillin |
>= 0.1.0 |
References
- Felber, C. (2010). Die Gemeinwohl-Oekonomie. Deuticke.
- Shannon, C. E. (1948). A mathematical theory of communication. Bell System Technical Journal, 27(3), 379-423.
- Rawls, J. (1971). A Theory of Justice. Harvard University Press.
- Habermas, J. (1981). Theorie des kommunikativen Handelns. Suhrkamp.
- Floridi, L. et al. (2018). An ethical framework for a good AI society. Minds and Machines, 28(4), 689-707.
- Solum, L. B. (1992). Legal personhood for artificial intelligences. North Carolina Law Review, 70(4), 1231-1287.
- Amodei, D. et al. (2016). Concrete problems in AI safety. arXiv:1606.06565.
Links
- Worldview / CREP:
docs/CREPPhaseMatrix.yamland theworldviewpackage - GenesisChronik:
docs/GenesisChronik.md - Docs: genesisaeon.github.io/gemeinwohl
- Zenodo: doi.org/10.5281/zenodo.gemeinwohl
License
This repository is dual-licensed:
- Source code — GNU General Public License v3.0 or later (GPL-3.0-or-later). See LICENSE-CODE.
- Documentation — Creative Commons Attribution 4.0 International (CC BY 4.0). See LICENSE-DOCS.
(c) 2025-2026 GenesisAeon / Johann Römer
Metadata
Release files for gemeinwohl 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| gemeinwohl-1.0.0.tar.gz | 22.7 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gemeinwohl-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.7 MB
Release files / gemeinwohl-1.0.0.tar.gz
| Download URL | gemeinwohl-1.0.0.tar.gz |
|---|---|
| Size | 22.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9b692d86ba1ebde5648b72b3e52e70fb9705cdd5de38785628ef26d6d892cf82
|
|
BLAKE2b-256 checksum How to use checksums |
28de006d1acca62b9200f933ba088b50621429237f26caf9043314f1615ae2c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / gemeinwohl-1.0.0-py3-none-any.whl
| Download URL | gemeinwohl-1.0.0-py3-none-any.whl |
|---|---|
| Size | 25.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
725a8cbed7ae70608e2f067878ab7ba2bd1149ac09d185a70b7eb72693c120ca
|
|
BLAKE2b-256 checksum How to use checksums |
3fcd30cb021d9091c738ece75e6dbb07f8fa4e13902c497ba9d3aad7cbb19407
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for gemeinwohl 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.