Important

This repository is no longer maintained.

Active development has moved to markpollack/agent-sandbox. Current documentation is available at lab.pollack.ai.

This repository remains available for historical Spring AI Community releases. Its Apache 2.0 license and historical contents are unchanged. Please submit new issues and pull requests to the active repository.

Agent Sandbox

Unified API for isolated command execution across multiple backends. Same interface for local processes, Docker containers, and E2B cloud microVMs.

Modules

Module	Description
agent-sandbox-core	Core Sandbox API and LocalSandbox
agent-sandbox-docker	Docker container sandbox via Testcontainers
agent-sandbox-e2b	E2B cloud microVM sandbox

Maven Central

<dependency>
    <groupId>org.springaicommunity</groupId>
    <artifactId>agent-sandbox-core</artifactId>
    <version>0.9.1</version>
</dependency>

Quick Example

try (Sandbox sandbox = LocalSandbox.builder()
        .tempDirectory("test-")
        .build()) {

    ExecResult result = sandbox.exec(ExecSpec.of("mvn", "test"));

    if (result.success()) {
        System.out.println(result.stdout());
    }
}

Documentation

Full API reference, all backends, file operations, and customizers: https://springaicommunity.mintlify.app/projects/incubating/agent-sandbox

License

Apache License 2.0