Get Started with RIO

Runtime Governance and Execution Control Plane for AI Systems

Explore RIO through interactive demos, then install it locally. Each demo builds on the previous one, walking you through the complete Three-Loop Architecture.

The Three-Loop Architecture

IntakeGoal → IntentGovernancePolicy → Approval → Execution → VerificationLearningLedger → Policy Improvement

Guided Walkthrough

Follow these demos in order to experience the full RIO protocol. Each one demonstrates a different aspect of governed execution.

1

Demo 1 — Human Approval Required

Submit a high-risk action (e.g., transfer funds) and see how RIO requires human approval before execution. Approve or deny the request and watch the full pipeline execute with v2 cryptographic receipts.

Intent creation with structured parametersRisk evaluation and policy checkHuman approval gatev2 receipt with intent_hash, action_hash, and verification_hash
2

Demo 2 — How RIO Enforces Approval

Compare what happens when you approve vs. deny a request. See how RIO generates different receipts for each outcome and how denial receipts are cryptographically signed just like approvals.

Side-by-side approve vs. deny flowDenial receipts with BLOCKED execution statusLedger entries for both outcomesHash chain linking between entries
3

Demo 3 — Audit & Runtime Log

Run multiple actions and explore the full audit trail. Each action produces a receipt and ledger entry. View the complete runtime log showing every pipeline stage.

Full audit trail with timestampsReceipt details with v2 cryptographic fieldsRuntime log of all pipeline stagesExport receipts as JSON or TXT
4

Demo 4 — Full Pipeline Walkthrough

Watch the complete governed execution pipeline run step by step. See every stage from intent creation through verification, receipt generation, and ledger append.

All 10 pipeline stages in sequencePost-execution verification stepv2 receipt with RSA-PSS signatureHash-chain ledger entry
5

Demo 5 — Learning Loop

See how execution outcomes feed back into policy refinement. RIO analyzes patterns across multiple executions and proposes policy updates to improve future governance.

8 scenarios run through the pipelinePattern analysis across executionsRisk distribution and approval trendsAutomated policy improvement proposals
6

Verify Receipt Tool

Paste any receipt JSON and independently verify its cryptographic integrity. Check hash validity, signature verification, and look up receipts by ID.

Hash recomputation and comparisonRSA-PSS signature verificationReceipt lookup by IDTamper detection on modified receipts
7

Ledger Chain Explorer

Browse the full hash-chain ledger. See how each entry links to the previous one via previous_ledger_hash, creating a tamper-evident chain of custody.

Visual hash chain with linked indicatorsEntry details with all v2 fieldsChain integrity verificationChronological audit trail
8

Tamper Demo

See what happens when someone tries to tamper with a receipt. Choose from 5 attack types and watch RIO detect the modification through cryptographic verification failure.

5 tamper attack optionsBefore vs. after comparisonCryptographic verification failureProof that receipts are tamper-evident

Install Locally

1

Clone the Repository

$git clone https://github.com/bkr1297-RIO/rio-protocol.git
$cd rio-protocol
2

Create a Virtual Environment

Mac / Linux
$python -m venv venv
$source venv/bin/activate
Windows
$python -m venv venv
$venv\Scripts\activate
3

Install Dependencies

$pip install -r requirements.txt
4

Run the Pipeline

Run a sample governed request through the full pipeline with v2 cryptographic receipts.

$python -m runtime.pipeline

Expected Output

  • Intent created with structured parameters
  • Risk evaluated and policy checked
  • Approval required or auto-approved
  • Execution simulated
  • Post-execution verification
  • v2 receipt generated with cryptographic signature
  • Hash-chain ledger entry written
5

Run the Test Suite

$python -m runtime.test_harness

Runs all 57 tests including 10 v2 receipt/ledger tests.

6

Run the Dashboard

$python -m dashboard.app

Then open your browser to http://localhost:8050

Repository Structure

/specProtocol and architecture documentation
/runtimeExecution pipeline and v2 receipt system
/runtime/receiptsv2 receipt generation, signing, verification
/runtime/ledger_v2Hash-chain ledger writer and verifier
/dashboardAdmin and audit dashboard
/tests57 security and pipeline tests
/securityThreat model and controls
/auditVerification and replay tools

Quick Start (Copy & Paste)

$git clone https://github.com/bkr1297-RIO/rio-protocol.git
$cd rio-protocol
$pip install -r requirements.txt
$python -m runtime.pipeline
$python -m dashboard.app

Then open http://localhost:8050

RIO is a governed execution system that sits between AI, humans, and real-world actions. It translates goals into structured intent, evaluates risk and policy, requires approval when necessary, controls execution, verifies outcomes, and generates cryptographically signed receipts recorded in a tamper-evident ledger. The system enforces the rules, not the AI.

How It WorksArchitectureStart Demo 1View on GitHub