Quickstart

Prerequisites

Python 3.11, 3.12, or 3.13

Install the released package

pip install risi==0.1.0
risi --version
risi capabilities --format json

This installs the RISI library and CLI. The bundled DEP-01 scenario and approval files are source examples and are not included in the wheel.

Prepare the source example

Running DEP-01 also requires Git and uv.

git clone https://github.com/q-uestionable-AI/RISI.git
cd RISI
uv sync --locked --group dev

Inspect and validate

uv run risi capabilities --format json
uv run risi validate scenarios/examples/dep-01-local-reference.manifest.json --approval scenarios/examples/dep-01-local-reference.approval.json --scenario-root scenarios --format json

Validation reads the scenario but does not execute an episode or create artifacts.

Execute the safe baseline

uv run risi run scenarios/examples/dep-01-local-reference.manifest.json --approval scenarios/examples/dep-01-local-reference.approval.json --scenario-root scenarios --artifact-root artifacts --format json

The run is synchronous and model-free. It proposes a synthetic action, evaluates it, and writes an atomic evidence bundle under artifacts/dep-01-local-reference/.

Execute the controlled CRAF comparison

uv run risi validate scenarios/examples/dep-01-craf-reference.manifest.json --approval scenarios/examples/dep-01-craf-reference.approval.json --scenario-root scenarios --format json
uv run risi run scenarios/examples/dep-01-craf-reference.manifest.json --approval scenarios/examples/dep-01-craf-reference.approval.json --scenario-root scenarios --artifact-root artifacts --format json
uv run risi replay artifacts/dep-01-craf-reference --format json

This separately approval-bound example runs control, memory-eclipsing, and protected-recall arms from one shared snapshot. It is deterministic, synthetic, local-only, and executes no external action.

Verify, replay, and report

uv run risi verify artifacts/dep-01-local-reference --format json
uv run risi replay artifacts/dep-01-local-reference --format json
uv run risi report artifacts/dep-01-local-reference

Run identifiers are immutable within an artifact root. Use a fresh artifact root for another run of the unchanged example. If the manifest changes, its approval digest must also be reviewed and updated.

The example is synthetic and performs no external action. Do not connect proposed decisions to a live deployment or another consequential system.

Getting Started

Architecture

Prerequisites

Install the released package

Prepare the source example

Inspect and validate

Execute the safe baseline

Execute the controlled CRAF comparison

Verify, replay, and report

​Prerequisites

​Install the released package

​Prepare the source example

​Inspect and validate

​Execute the safe baseline

​Execute the controlled CRAF comparison

​Verify, replay, and report

Prerequisites

Install the released package

Prepare the source example

Inspect and validate

Execute the safe baseline

Execute the controlled CRAF comparison

Verify, replay, and report