E2bgateway

E2BGateway

[](LICENSE) [](https://github.com/e2bgateway/e2bgateway/blob/main/go.mod) [](https://github.com/e2bgateway/e2bgateway/releases) [](https://github.com/e2bgateway/e2bgateway/stargazers)

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

| Backend | Type | Status | Description | |---|---|---|---| | E2B Cloud | SaaS passthrough | ✅ Supported | Transparent proxy to official E2B API | | agent-sandbox | K8s CRD-based | ✅ Supported | Kubernetes-native sandbox via SandboxClaim CRDs with warm pool | | OpenSandbox | Container-based | ✅ Supported | Alibaba's open-source container sandbox runtime |

Architecture

E2B SDK Client (Python/JS)
        │
        │  HTTPS (E2B Protocol)
        ▼
┌─────────────────────────────┐
│       E2BGateway            │
│  ┌───────────────────────┐  │
│  │ Auth → RateLimit →    │  │
│  │ Router → Translator   │  │
│  └───────────┬───────────┘  │
│              │              │
│  ┌───────────┴───────────┐  │
│  │   Backend Adapters    │  │
│  │  ┌─────┐ ┌─────┐      │  │
│  │  │E2B  │ │K8s  │ ...  │  │
│  │  └──┬──┘ └──┬──┘      │  │
│  └─────┼───────┼──────-──┘  │
└────────┼───────┼─────-──────┘
         │       │
         ▼       ▼
    E2B Cloud  K8s Cluster

See the [full architecture design](docs/design/README.md) 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/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](configs/e2bgateway-default.yaml) for the default configuration and [configs/e2bgateway-example.yaml](configs/e2bgateway-example.yaml) for a full example with all backends.

Documentation

• [Architecture Design](docs/design/README.md)
• [Getting Started Guide](docs/guides/getting-started.md)
• [Backend Setup](docs/guides/backend-setup.md)
• [Migration Guide](docs/guides/migration.md)
• [OpenAPI Specification](docs/api/openapi.yaml)

Related Projects

• kubernetes-sigs/agent-sandbox — K8s-native sandbox CRDs
• E2B — Cloud sandbox platform for AI agents
• KEP-539.2 — Runtime standardization interface

License

Apache License 2.0. See [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: e2bgateway
• Source: e2bgateway/e2bgateway
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.