Development Status
- 4 - Beta
Environment
- Console
Intended Audience
- Science/Research
- Developers
License
- OSI Approved :: MIT License
Natural Language
- English
Programming Language
- Python :: 3
Topic
- Scientific/Engineering :: Artificial Intelligence
Typing
- Typed
Operating System
- OS Independent
Welcome to Inspect, a framework for large language model evaluations created by the UK AI Security Institute.
Inspect provides many built-in components, including facilities for prompt engineering, tool usage, multi-turn dialog, and model graded evaluations. Extensions to Inspect (e.g. to support new elicitation and scoring techniques) can be provided by other Python packages.
To get started with Inspect, please see the documentation at https://inspect.aisi.org.uk/.
Inspect also includes a collection of over 200 pre-built evaluations ready to run on any model (learn more at https://inspect.aisi.org.uk/evals/).
Coding agents: a structured index of the docs is published at https://inspect.aisi.org.uk/llms.txt. The user guide is concatenated as Markdown at https://inspect.aisi.org.uk/llms-guide.txt, and https://inspect.aisi.org.uk/llms-full.txt additionally bundles the API and CLI reference. Individual pages are available as Markdown by appending
.mdto the.htmlpath (e.g./extensions/index.html.md).
To work on development of Inspect, clone the repository and install with the -e flag and [dev] optional dependencies:
git clone https://github.com/UKGovernmentBEIS/inspect_ai.git
cd inspect_ai
pip install -e ".[dev]"
Alternatively, if you use uv, sync the development environment from the checked-in lockfile:
uv sync --extra dev
The uv workflow is supported but not required. The uv.lock file records a reproducible development resolution; project dependencies are still declared in requirements*.txt and exposed through pyproject.toml. When changing dependencies, update the appropriate requirements file and refresh the lockfile rather than relying on uv add.
Optionally install pre-commit hooks via
make hooks
Run linting, formatting, and tests via
make check
make test
When working in a uv-managed environment, prefix those commands with uv run (for example, uv run make check).
If you use VS Code, you should be sure to have installed the recommended extensions (Python, Ruff, and MyPy). Note that you'll be prompted to install these when you open the project in VS Code.
Frontend development (TypeScript)
The web UI lives in a git submodule at src/inspect_ai/_view/ts-mono/. These steps are only needed if you plan to work on the TypeScript/React frontend — Python-only contributors can skip this entirely.
Initialize the submodule and install dependencies — see the one-time setup guide.
Documentation
To work on the Inspect documentation, install the optional [doc] dependencies with the -e flag and build the docs:
pip install -e ".[doc]"
cd docs
quarto render # or 'quarto preview'
If you intend to work on the docs iteratively, you'll want to install the Quarto extension in VS Code.
Wheel compatibility matrix
Files in release
agent-client-protocol
(>=0.10.1)
aioboto3
(>=13.0.0)
anyio
(>=4.14.0)
beautifulsoup4
(>=4.10.0)
boto3
click
(!=8.2.0,<8.2.2,>=8.1.3)
debugpy
docstring-parser
(>=0.16)
exceptiongroup
(>=1.0.2)
fastapi
(>=0.119.0)
fsspec
(<=2025.9.0,>=2023.1.0)
httpx
ijson
(>=3.2.0)
jsonlines
(>=3.0.0)
jsonpatch
(>=1.32)
jsonpath-ng
(>=1.8.0)
jsonref
(>=1.1.0)
jsonschema
(>3.1.1)
mmh3
(>3.1.0)
nest_asyncio2
(>=1.7.2)
numpy
platformdirs
(>=2.3.0)
psutil
pydantic
(>=2.13.0)
python-dotenv
(>=0.16.0)
pyyaml
rich
(!=14.0.0,>=13.3.3)
s3fs
(>=2023)
semver
(>=3.0.0)
shortuuid
sniffio
tenacity
textual
(>=6.2.0)
tiktoken
(>=0.12.0)
typing_extensions
(>=4.14.0)
universal-pathlib
(>=0.2.6)
uvicorn
zipfile-zstd
(>=0.0.4)
zipp
(>=3.19.1)
zstandard
(>=0.20.0)