Skip to content

The Open Data Governance Standard (ODGS). A sovereign protocol for the cryptographic enforcement of Semantic Integrity. Prevents AI hallucinations by binding data to immutable definitions (EU AI Act Art. 10).

License

Notifications You must be signed in to change notification settings

MetricProvenance/odgs-protocol

📢 Sovereign Node Notice (16 Feb 2026)

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.

⚠️ OPERATIONAL ADVISORY: To prevent "Definition Drift" in your critical paths, please click the Watch button (top right) $\rightarrow$ select Releases Only.

  • 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.

ODGS: Open Data Governance Standard

The Runtime Enforcement Standard for EU AI Act Article 10 & 12.

DOI Regulation License


1. The Standard

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).


2. Regulatory Alignment

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.

3. The 5-Plane Architecture

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

Loading

> Read the Full Architecture Specification


4. Technical Implementation: A Polyglot Protocol

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:

1. Python (The Data Plane)

  • Role: Heavy-duty Data Engineering, Airflow/dbt integration, and Runtime Enforcement.
  • Location: src/odgs/executive/interceptor.py
  • Install: pip install odgs

2. Node.js (The Developer Experience)

  • Role: CLI tools, VS Code integrations, and Frontend Visualizers.
  • Location: lib/
  • Install: npm install odgs

Quick Start

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

5. Documentation & Contribution

This is a Coalition of the Willing. We invite Legal Scholars and Public Administrators to contribute to the Standard definitions.

License

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

About

The Open Data Governance Standard (ODGS). A sovereign protocol for the cryptographic enforcement of Semantic Integrity. Prevents AI hallucinations by binding data to immutable definitions (EU AI Act Art. 10).

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published