> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diffblue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Requirements

> System and project requirements for running Diffblue Agents

## System requirements

| Requirement      | Details                  |
| ---------------- | ------------------------ |
| Operating system | macOS, Linux, or Windows |
| Git              | 2.25+                    |

### Supported AI coding agent platforms

You need one of the following AI coding agent platforms installed and authenticated:

* Claude Code
* GitHub Copilot CLI

Run `diffblue-agents install` to select your agent platform or provide a custom path.

<Note>
  The Diffblue Agents archive includes bundled Java and Node.js runtimes. You only need to install Java and Node.js if needed for building and testing your target project.
</Note>

## Project requirements

Your project must be in a Git repository with a clean working tree.

### Java projects

| Requirement | Details                                                                                                         |
| ----------- | --------------------------------------------------------------------------------------------------------------- |
| Java        | JDK version(s) relevant for your particular project must be installed.                                          |
| Build tool  | Maven or Gradle. `mvn` or `gradle` must be on `PATH` or Maven/Gradle wrapper is present in your project's root. |

### Python projects

| Requirement    | Details                                                                                                                                                                                          |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Python         | A `python3`, `python`, or `py` interpreter must be installed. Diffblue Agents scans `PATH` and common installation locations (Homebrew, pyenv, asdf, Conda, system directories) automatically.   |
| venv           | The `venv` module must be available. On Debian/Ubuntu (including WSL), install `python3-venv` separately: `sudo apt install python3-venv`. On macOS and Windows, `venv` is included with Python. |
| Test framework | Dependencies such as `pytest` and `pytest-cov` are installed automatically by the [prepare project workflow](/workflows/regression-unit-tests-prepare-project) if not already installed.         |

## Network access

The Diffblue Agents server runs locally. Network access is required for:

* License activation and validation (`https://api.licensespring.com`, `https://licensing.diffblue.com`)
* A working [AI coding agent platform](#supported-ai-coding-agent-platforms)
* Dependency resolution (Maven Central, Gradle repositories, PyPI, etc.)