E2B SDK for Java and Go

Availability and installation

The Java SDK is currently available as source code. Version 2.1.0 has not been published to Maven Central or another public Maven repository. Clone the repository and install the SDK in your local Maven repository:

git clone https://github.com/aliyun-fc/e2b-java-sdk.git
cd e2b-java-sdk
mvn clean install -DskipTests

For a Maven project, add the dependency:

<dependency>
    <groupId>com.alibaba.serverless</groupId>
    <artifactId>e2b-java-sdk</artifactId>
    <version>2.1.0</version>
</dependency>

For a Gradle project, enable the local Maven repository before adding the dependency:

repositories {
    mavenLocal()
    mavenCentral()
}

dependencies {
    implementation 'com.alibaba.serverless:e2b-java-sdk:2.1.0'
}

The SDK requires Java 8 or later. Its main packages are:

Create and run a sandbox

import dev.e2b.sdk.Sandbox;
import dev.e2b.sdk.client.ConnectionConfig;
import dev.e2b.sdk.model.CommandResult;

public class Quickstart {
    public static void main(String[] args) throws Exception {
        ConnectionConfig config = ConnectionConfig.builder()
                .apiKey(System.getenv("E2B_API_KEY"))
                .apiUrl(System.getenv("E2B_API_URL"))
                .domain(System.getenv("E2B_DOMAIN"))
                .build();

        try (Sandbox sandbox = Sandbox.create("code-interpreter-v1", config)) {
            CommandResult result = sandbox.getCommands().run(
                    "python3 -c \"print('hello from sandbox')\""
            );
            System.out.println(result.getStdout().trim());
        }
    }
}

Sandbox implements AutoCloseable. Leaving the try block calls kill() and releases the sandbox. For finer lifecycle control, set an explicit sandbox timeout and call sandbox.kill() when the task finishes.

Availability and installation

The Go SDK is currently available as source code and requires Go 1.22 or later. Its go.mod still declares the legacy module path github.com/e2b-dev/e2b-go-sdk, which is no longer resolvable. Clone the SDK next to your Go project and replace the legacy module with the local directory.

The following example assumes that your project is in myapp/:

# Run from the directory that contains myapp/.
git clone https://github.com/aliyun-fc/e2b-go-sdk.git
cd myapp
go mod init myapp  # Skip this command if go.mod already exists.
go mod edit -replace=github.com/e2b-dev/e2b-go-sdk=../e2b-go-sdk

Keep the legacy module path in imports because it matches the SDK's current go.mod declaration:

import e2b "github.com/e2b-dev/e2b-go-sdk"

Create and run a sandbox

Save the following example as main.go:

package main

import (
    "context"
    "fmt"
    "log"
    "os"
    "strings"
    "time"

    e2b "github.com/e2b-dev/e2b-go-sdk"
)

func main() {
    ctx := context.Background()

    client, err := e2b.NewClient(
        e2b.WithAPIKey(os.Getenv("E2B_API_KEY")),
        e2b.WithAPIURL(os.Getenv("E2B_API_URL")),
        e2b.WithDomain(os.Getenv("E2B_DOMAIN")),
    )
    if err != nil {
        log.Fatal(err)
    }

    sandbox, err := client.CreateSandbox(
        ctx,
        e2b.WithTemplate("code-interpreter-v1"),
        e2b.WithTimeout(900),
    )
    if err != nil {
        log.Fatal(err)
    }
    defer sandbox.Kill(context.Background())

    result, err := sandbox.Commands.Run(
        ctx,
        "python3 -c \"print('hello from sandbox')\"",
        e2b.WithCommandTimeout(60*time.Second),
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(strings.TrimSpace(result.Stdout))
}

Resolve the local replacement and run the example:

go mod tidy
go run .

defer sandbox.Kill(...) releases the sandbox when the function exits. In production code, set an explicit timeout and release the sandbox when the task finishes.