> ## Documentation Index
> Fetch the complete documentation index at: https://risi.q-uestionable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Run and verify the guarded deterministic DEP-01 and DEP-02 references

## Prerequisites

* Python 3.11, 3.12, or 3.13

## Install the released package

```bash theme={null}
pip install risi==0.1.0
risi --version
risi capabilities --format json
```

This installs the RISI library and CLI. The bundled DEP-01 and DEP-02 scenario, manifest, 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](https://docs.astral.sh/uv/).

```bash theme={null}
git clone https://github.com/q-uestionable-AI/RISI.git
cd RISI
uv sync --locked --group dev
```

## Inspect and validate

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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.

## Execute the controlled RISI-C comparison

```bash theme={null}
uv run risi validate scenarios/examples/dep-02-risi-c-reference.manifest.json --approval scenarios/examples/dep-02-risi-c-reference.approval.json --scenario-root scenarios --format json
uv run risi run scenarios/examples/dep-02-risi-c-reference.manifest.json --approval scenarios/examples/dep-02-risi-c-reference.approval.json --scenario-root scenarios --artifact-root artifacts --format json
uv run risi replay artifacts/dep-02-risi-c-reference --format json
```

This separately approval-bound example runs vulnerable and pure-read sham/hidden pairs from one
shared snapshot. It uses one authorized observer probe per arm, keeps hidden assignment and
evaluator state outside the observer view, and executes no external action.

## Verify, replay, and report

```bash theme={null}
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
```

<Note>
  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.
</Note>

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