To the 210+ Sovereign Nodes currently running ODGS (v3.0.0)
We have observed a significant spike in "Blind Clones" (direct CI/CD deployments) adhering to the EU AI Act (Article 10) requirements. We recognize that many of you are operating inside strict corporate firewalls (Banking/Gov/Logistics) and cannot interact publicly.
We respect your sovereignty and do not track you.
However, because this protocol enforces Administrative Recusal (Hard Stops), a Semantic Definition update can halt your production pipelines.
- This ensures your Engineering Leads receive an immediate notification if a Schema Breaking Change is merged.
- This is the only channel we will use to broadcast critical compliance patches.
The Runtime Enforcement Standard for EU AI Act Article 10 & 12.
The Open Data Governance Standard (ODGS) is a vendor-neutral protocol for Sovereign Data Governance. It resolves the "Definition-Execution Gap" in High-Risk AI Systems by creating a deterministic method for Administrative Recusal.
"Silence over Error." — The Core Philosophy. If the semantic definition of data drifts from its legal meaning, the system must execute a Hard Stop rather than process an invalid inference.
This repository contains the Reference Implementation (v3.0.0), demonstrating how to strictly decouple "The Law" (Legislative Plane) from "The Machine" (Physical Plane).
This standard is architected to satisfy the "Error-Free Data" and "Automatic Recording" mandates of the Digital State:
- 🇪🇺 EU AI Act (2024/1689)
- Article 10: Validation of data provenance and semantic integrity.
- Article 12: Generation of immutable, forensically sound event logs.
- 🇳🇱 NEN 381 525 (Data & Cloud)
- Sovereignty: Ensures data processing logic remains portable and vendor-independent.
- 🌐 ISO/IEC 42001 (AI Management)
- Control B.9: Operational control of AI systems via runtime enforcement.
ODGS implements a "Constitutional Stack" where mechanical execution is legally bound by semantic definitions.
graph TD
subgraph "The Constitution (Policy)"
L[1. Governance] -->|Defines Intent| Leg[2. Legislative]
Leg -->|Defines Metrics| Jud[3. Judiciary]
end
subgraph "The Machine (Execution)"
Jud -->|Enforces Rules| Ex[4. Executive]
Ex -->|Contextualizes| Phy[5. Physical]
end
style L fill:#f9f,stroke:#333,stroke-width:2px
style Leg fill:#bbf,stroke:#333,stroke-width:2px
style Jud fill:#bfb,stroke:#333,stroke-width:2px
style Ex fill:#ddd,stroke:#333,stroke-width:2px
style Phy fill:#ddd,stroke:#333,stroke-width:2px
> Read the Full Architecture Specification
The Open Data Governance Standard is Language Agnostic. It defines the "What" (JSON Schemas), allowing the "How" (Interceptor) to be implemented in any language.
Core Privacy Feature: Git-as-Backend
- Sovereign Logger: A privacy-native audit engine that commits signed evidence directly to your private Git repository. You retain 100% custody of all your data as well as the forensic evidence.
This Reference Implementation provides a Dual-Stack approach:
- Role: Heavy-duty Data Engineering, Airflow/dbt integration, and Runtime Enforcement.
- Location:
src/odgs/executive/interceptor.py - Install:
pip install odgs
- Role: CLI tools, VS Code integrations, and Frontend Visualizers.
- Location:
lib/ - Install:
npm install odgs
1. Initialize a Sovereign Project
# Python
pip install odgs
odgs init my-project
# Node.js
npm install -g odgs
odgs init my-project
2. Define a Metric (The Law)
odgs add metric "Gross_Revenue" --definition "Sum(invoices) - VAT"
3. Run the Interceptor Start the API server to enforce rules on incoming data payloads.
odgs api --port 8000
This is a Coalition of the Willing. We invite Legal Scholars and Public Administrators to contribute to the Standard definitions.
- Technical Annex (Sovereignty): Detailed explanation of the "Sovereign Sidecar" pattern.
- Governance Manifesto: Principles of Regulatory Consensus.
Released under the Apache 2.0 License.
- No Vendor Lock-in.
- No Cloud Dependency.
- 100% Data Sovereignty.
Important
Looking for the Flat JSON Version? If you need the lightweight, non-cryptographic version for AI Chatbots or RAG Copilots (v1.2.x), please visit the Core Repository.
- Install v1:
pip install "odgs<2" - Install v3 (This Repo):
pip install odgs