E2B Code Interpreter

2.4.1 · active · verified Sun Mar 01

Secure cloud sandboxes for executing AI-generated code. Two packages: e2b-code-interpreter (Jupyter/stateful code execution) and e2b (core sandbox SDK). v0.x is fully deprecated — all versions below 1.0 show deprecation warnings and the API is incompatible with v1.x.

Warnings

breaking CodeInterpreter class removed in v1.0. All v0.x code using CodeInterpreter() or from e2b_code_interpreter import CodeInterpreter fails with ImportError.
Fix: Replace CodeInterpreter() with Sandbox(). Use context manager: with Sandbox() as sandbox:
breaking Global cwd option removed from Sandbox constructor in v1.0. Setting cwd at sandbox creation no longer works.
Fix: Pass cwd per command call instead of at sandbox instantiation.
breaking Sandbox.list() output structure changed in v1.0. Code parsing the old list format breaks silently or raises KeyError.
Fix: Review and rewrite any code consuming Sandbox.list() output against v1.x docs.
deprecated e2b package (core SDK) v0.x is fully deprecated. All PyPI releases below 1.0 display deprecation warnings at import time.
Fix: pip install e2b-code-interpreter>=1.0.0 and follow migration guide at e2b.dev/docs/quickstart/migrating-from-v0
gotcha Sandboxes are billed by runtime duration, not by number of calls. Long-running agents with persistent sandboxes accumulate cost even when idle.
Fix: Use context managers (with Sandbox() as sb:) to ensure sandboxes are closed after use. Explicitly call sandbox.close() in non-context-manager usage.
gotcha execution.text is None if the code produces no output. Accessing .text without checking causes NoneType errors downstream.
Fix: Check execution.text is not None before use. Also check execution.error for runtime errors in executed code.

Install

pip install e2b-code-interpreter Python (code interpreter, recommended)
pip install e2b Python (core sandbox SDK)
npm install @e2b/code-interpreter Node.js

Imports

Sandbox
```
from e2b_code_interpreter import Sandbox
```
CodeInterpreter class was the v0.x entry point. Removed in v1.0. All v0.x code using CodeInterpreter() breaks.
Sandbox (core)
```
from e2b import Sandbox
```
Use e2b.Sandbox for general-purpose sandboxes without Jupyter kernel. Use e2b_code_interpreter.Sandbox for stateful code execution with output capture.

Quickstart

Stateful code execution in a secure cloud sandbox. Requires E2B_API_KEY environment variable.

from e2b_code_interpreter import Sandbox

with Sandbox() as sandbox:
    sandbox.run_code("x = 1")
    execution = sandbox.run_code("x += 1; x")
    print(execution.text)  # outputs 2

view raw JSON →