OpenReason Protocol

A standard for transparent, reproducible, and accountable policy reasoning. Document your data, simulate consequences, map stakeholder impacts, and create forkable policy proposals.

Quick Start

# Install the validator
pip install orp-validator
 
# Create your first document
orp new my-policy.yaml --compliance basic
 
# Validate it
orp validate my-policy.yaml

Why OpenReason?

Data Provenance

Document every dataset with source, methodology, cleaning decisions, and known limitations.

Consequence Simulation

Model policy outcomes with explicit assumptions, scenarios, and sensitivity analysis.

Empathy Mapping

Map all stakeholders, test minority impacts, assess net welfare with confidence levels.

Accountability Ledger

Track every decision, who made it, when, why, and what sections were affected.

Fork Registry

Fork proposals to test alternative assumptions. Track lineage and compare outcomes.

Validation Tools

CLI, Python API, and REST API for validating documents. 96% test coverage.

Compliance Levels

ORP-Basic (Layer 1 only)
Minimum viable transparency: data provenance tracking

ORP-Standard (Layers 1-3)
Add consequence simulation and stakeholder mapping

ORP-Full (All 5 layers)
Complete protocol: includes accountability ledger and fork registry

Get Involved

Read the Specification — Full ORP v0.1 spec
View Examples — Danish Property Tax Reform (ORP-Full)
Install Tools — CLI, Python, REST API
Contribute — Help build the protocol
GitLab Repository — Source code and issues

Current Version: ORP v0.1
Tools Version: v0.3.0 (on PyPI)
Status: Production-ready with 39 automated tests (96% coverage)