Inspect Swe

0.2.50 verified Fri May 01 auth: no python

Inspect Swe is a library for software engineering agents, built on top of Inspect AI. It provides tools and workflows for creating AI agents that can interact with code, run tests, and perform software engineering tasks. Version 0.2.50 is current, with active development.

pip install inspect-swe

Common errors

error ImportError: cannot import name 'SweAgent' from 'inspect_swe' ↓

cause Older version of inspect-swe (<0.1.0) did not expose SweAgent at package level.

fix

Upgrade to latest: pip install --upgrade inspect-swe

error RuntimeError: Docker is not running. Please start Docker. ↓

cause SweEnvironment requires Docker for local sandbox; Docker daemon not active.

fix

Start Docker Desktop or run 'dockerd' on Linux.

error ValueError: Model 'gpt-4-32k' is not supported by Inspect AI. ↓

cause The model name passed to SweConfig is invalid. Inspect AI may not support that model.

fix

Check supported models: https://inspect.ai/docs/models

error TypeError: solve() got an unexpected keyword argument 'timeout' ↓

cause The 'timeout' parameter was removed in v0.2.45. Use SweConfig(timeout=...) instead.

fix

Set timeout in SweConfig: SweConfig(timeout=120).then agent.solve(task)

Warnings

breaking Breaking change in v0.2.0: SweAgent no longer accepts 'model' as a constructor argument. Use 'config.model' instead. ↓

fix Change SweAgent(model='gpt-4') to SweAgent(config=SweConfig(model='gpt-4'))

deprecated The 'run' method is deprecated since v0.2.40. Use 'solve' or 'execute' instead. ↓

fix Replace agent.run(task) with agent.solve(task) or agent.execute(task)

gotcha SweEnvironment requires a running Docker daemon when using local Docker backend. Failure to start Docker will raise RuntimeError. ↓

fix Ensure Docker Desktop or daemon is running before creating SweEnvironment.

gotcha When using SweEnvironment with 'sandbox' backend, the environment is reset after each task. State is not persisted. ↓

fix Use 'persistent' backend if state across tasks is needed.

Imports

SweAgent
wrong
```
from inspect_swe.agent import SweAgent
```
correct
```
from inspect_swe import SweAgent
```
SweAgent is exposed at top-level package, not a submodule

SweEnvironment

wrong

import inspect_swe.environment

correct

from inspect_swe import SweEnvironment

Use top-level import for SweEnvironment

Quickstart

Basic usage: create a SweAgent and run it on a simple coding task.

from inspect_swe import SweAgent
from inspect_ai import Task
task = Task("Write a function that adds two numbers")