E2BGateway acts as an abstraction gateway layer for AI agent sandboxes. It provides a fully compatible interface aligned with the official E2B client protocol, transparently routing requests to diverse underlying agent runtime implementations such as agent-sandbox and OpenSandbox.

Why E2BGateway?

• Eliminate vendor lock-in — Write once, run against any sandbox backend
• Zero-code migration — Existing E2B SDK users connect with only a URL change
• Multi-backend routing — Dynamic routing, load balancing, and failover between sandbox clusters
• Production ready — Auth, rate limiting, audit logging, and OpenTelemetry observability built-in

Quick Start

import os

# Point E2B SDK at your E2BGateway instance
os.environ["E2B_API_URL"] = "https://sandbox.example.com"
os.environ["E2B_API_KEY"] = "your-api-key"

from e2b_code_interpreter import Sandbox

# Standard E2B code — no modifications needed
sbx = Sandbox.create(template="code-interpreter")
result = sbx.run_code("print('Hello from E2BGateway!')")
print(result.text)
sbx.kill()

Supported Backends

Architecture

See the full architecture design for details.

API Compatibility

E2BGateway implements the complete E2B REST API:

• POST/GET/DELETE /api/v1/sandboxes — Sandbox lifecycle
• POST /api/v1/sandboxes/{id}/code — Code execution
• POST /api/v1/sandboxes/{id}/commands — Shell commands
• POST/GET /api/v1/sandboxes/{id}/files/* — Filesystem operations
• GET /api/v1/sandboxes/{id}/ports — List open ports (port forwarding)
• GET /api/v1/sandboxes/{id}/ports/{port} — Get port URL (port forwarding)
• GET/POST/DELETE /api/v1/templates — Template management
• WebSocket channels for streaming code execution, terminals, and port forwarding

Build & Run

# Build
make build

# Run locally
make run

# Run tests
make test

# Docker
make docker-build

# Helm
helm install e2bgateway deploy/helm/e2bgateway

Configuration

See configs/e2bgateway-default.yaml for the default configuration and configs/e2bgateway-example.yaml for a full example with all backends.

Documentation

• Architecture Design
• Getting Started Guide
• Backend Setup
• Port Forwarding Guide
• Migration Guide
• OpenAPI Specification

Related Projects

• kubernetes-sigs/agent-sandbox — K8s-native sandbox CRDs
• E2B — Cloud sandbox platform for AI agents
• OpenSandbox — Alibaba's open-source container sandbox runtime
• CubeSandbox — High-performance container sandbox
• AgentENV — Agent environment platform
• KEP-539.2 — Runtime standardization interface

License

Apache License 2.0. See LICENSE.