System requirements
| Requirement | Details |
|---|
| Operating system | macOS, Linux, or Windows |
| Git | 2.25+ |
- Claude Code
- GitHub Copilot CLI
Run diffblue-agents install to select your agent platform or provide a custom path.
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.
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. |
| Test framework | Dependencies such as pytest and pytest-cov are installed automatically by the prepare project workflow 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
- Dependency resolution (Maven Central, Gradle repositories, PyPI, etc.)
