Inspect Viz

Welcome to Inspect Viz, a data visualisation library for Inspect AI. Inspect Viz provides flexible tools for high quality interactive visualisations from Inspect evaluations.

To get started with Inspect Viz, please see the documentation at https://meridianlabs-ai.github.io/inspect_viz/.

Installation

Latest published version:

pip install inspect-viz

Latest development version:

pip install git+https://github.com/meridianlabs-ai/inspect_viz

Development

To work on development of Inspect Viz, clone the repository and install it with uv (0.13.4 or later) and the [dev] optional dependencies:

git clone https://github.com/meridianlabs-ai/inspect_viz
cd inspect_viz
uv sync --locked --extra dev

Run the Python commands below from the .venv that uv sync creates: uv run <command>, .venv/bin/<command>, or source .venv/bin/activate.

Run linting, formatting, and tests via

make check
make test

For JS / front-end development:

pnpm install --frozen-lockfile

While developing front end components, you can run the following in a separate terminal to automatically rebuild JavaScript as you make changes:

pnpm dev # or
pnpm dev-sourcemap

To build the docs locally and view them in your browser, install the optional doc dependencies and run quarto preview.

uv sync --locked --extra dev --extra doc
quarto preview inspect_viz/docs/index.qmd

If you use VS Code, you should be sure to have installed the recommended extensions (Python, Ruff, MyPy, Inspect AI, Quarto). Note that you'll be prompted to install these when you open the project in VS Code.