Skip to main content
Inspect AI is an evaluation framework created by the UK AI Security Institute. It can be used to run a wide range of evaluations that measure coding, reasoning, agentic tasks, knowledge, behavior, and multimodal understanding. With Inspect AI, evaluations and benchmarking become simple, reproducible, and consistent across multiple models and providers.

Prerequisites

Installation

1

Create a virtual environment

Activate the virtual environment (source .venv/bin/activate) each time you open a new terminal before running evaluations.
2

Install dependencies

3

Set your SambaNova API key

Running evaluations

Before you can run your first evaluation, you’ll need to define a task in a Python script. Each task has three main components:
  1. Dataset – the list of inputs and expected results
  2. Solver – how the model produces its outputs
  3. Scorer – how outputs are evaluated against the expected results

Example: Hello world

Save the following code into a hello_world.py file.
Then run the evaluation with SambaCloud. Here’s an example using the Llama-4-Maverick-17B-128E-Instruct model:

Viewing results

  • Results are stored in the logs directory.
  • Use the Inspect web UI for interactive viewing.

Additional resources

Troubleshooting

Install with the virtual environment active: pip install inspect-ai. Verify with pip show inspect-ai.
Verify SAMBANOVA_API_KEY is exported and the model ID is correct. See SambaCloud models.
Check network access to api.sambanova.ai. Confirm the API key is valid at the SambaNova API dashboard.