NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2310 most downloaded on PyPI
E2B Code Interpreter - Stateful code execution
Latest stable
2.11.9
Last release 18 days ago
04 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 46 of 46 stable releases
106 versions withdrawn
withdrawn after publishing
3 years old
167 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
### Patch Changes - Updated dependencies [a8155c4] - @e2b/python-sdk@2.63.0
### Patch Changes - Updated dependencies [48d24ac] - Updated dependencies [1ad3f76] - @e2b/python-sdk@2.62.1
8cc9ed1: Document the Result fields in the reference, including that png, jpeg and pdf are base64-encoded, and that logs.stdout, logs.stderr and Outpu
Result fields in the reference, including that png, jpeg and pdf are base64-encoded, and that logs.stdout, logs.stderr and OutputMessage.line hold raw chunks with newlines kept; use ''.join(execution.logs.stdout) to rebuild the output.Your coding agent can read these notes before it upgrades. Set up the MCP server →
### Patch Changes - Updated dependencies [9fdfa21] - Updated dependencies [d58ef55] - @e2b/python-sdk@2.62.0
### Patch Changes - Updated dependencies [bea0fe6] - @e2b/python-sdk@2.61.0
### Patch Changes - Updated dependencies [451a696] - Updated dependencies [e514999] - @e2b/python-sdk@2.60.0
### Patch Changes - Updated dependencies [5a714f0] - Updated dependencies [e5a9fa6] - Updated dependencies [61b6b55] - Updated dependencies [2cd2305]
d7ed073: Remove Python 3.10 compatibility shims (Python >=3.11 is already required).
### Patch Changes - Updated dependencies [f572bc7] - Updated dependencies [a1ad326] - Updated dependencies [999782e] - @e2b/python-sdk@2.57.0
f90f35d: Add --lifecycle.ontimeout, --lifecycle.autoresume, and --timeout support to e2b sandbox create.
7dc861f: fix: align behavior between the JS and Python SDKs
Python SDK:
commands.send_stdin and CommandHandle.send_stdin now accept bytes in addition to str, and the handle's send_stdin / close_stdin now accept a request_timeout.git.reset now accepts a typed GitResetMode and its validation error matches the JS SDK wording/ordering. GitResetMode is now exported.sandbox_url is now propagated through get_api_params.Template.from_image() now raises when only one of username / password is provided.get_info() no longer carries the envd access token on the returned SandboxInfo (the _envd_access_token field was unused), matching the JS SDK which strips it from getInfo.get_metrics() now raises TemplateException (was SandboxException) with the same message as the JS SDK when the sandbox is too old.JS SDK:
Sandbox.getInfo() now includes sandboxDomain, matching the Python SDK's single get_info. getFullInfo is deprecated and now just wraps getInfo (it no longer returns the envd access token).Sandbox.getMetrics() now returns [] in debug mode, matching the Python SDK. The debug short-circuit for getMetrics / kill is implemented on both the instance and static methods, so it applies consistently whether called as Sandbox.kill(sandboxId) or sandbox.kill().Template.fromImage() now requires both username and password when registry credentials are provided.Template.getBuildStatus() now defaults logsOffset to 0.requestTimeoutMs: 0 now explicitly disables the request timeout.getMetrics() now throws TemplateError (was SandboxError) when the sandbox is too old to support metrics.Updated dependencies [961ffba]
Updated dependencies [7dc861f]
Updated dependencies [da85b1e]
547decc: Require Python 3.11 or newer (Python 3.10 is no longer supported).
e2b template build (v1): command now only shows the deprecation notice and exits. Removed all v1 Docker build/push logic and deleted buildWithProxy.ts.components['schemas'][...] instead of verbose paths[...] traversal for OpenAPI-generated type references.ensureAccessToken call from e2b template create: the command now relies solely on the API key for authentication.29064bc: Require e2b>=2.55.1, the first release with get_sandbox_url(..., port=). 2.10.4 failed with TypeError: ... unexpected keyword argument 'port'
e2b>=2.55.1, the first release with get_sandbox_url(..., port=). 2.10.4 failed with TypeError: ... unexpected keyword argument 'port' when installed with e2b 2.55.0.e7a82ea: Remove unused internal code: wait helper (js-sdk), asSandboxTemplate/asHeadline/selectOption/basicDockerfile (cli), and format_execution_time
wait helper (js-sdk), asSandboxTemplate/asHeadline/selectOption/basicDockerfile (cli), and format_execution_timeout_error (python-sdk). No public API changes.cd4c62b: Publish the changes from the previous release, which was versioned but failed to publish to npm and PyPI.
~/.e2b/config.json permissions to owner-only (0600) and create ~/.e2b as 0700, preventing other local users from reading the stored access token and team API key2f92cc3: Pin the Jupyter transport to HTTP/1.1 with get_transport(config, http_version="1.1"), following the renamed argument in e2b 2.52.0 (now the m
get_transport(config, http_version="1.1"), following the renamed argument in e2b 2.52.0 (now the minimum supported version).390a1bf: Add an E2B client to the Code Interpreter SDKs that binds the connection configuration explicitly, so the API key and domain no longer have t
E2B client to the Code Interpreter SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox (and AsyncSandbox in Python) together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.e1532e9: Move the Code Interpreter and Desktop JavaScript and Python SDKs into the E2B monorepo.
8d0a81b : Bump E2B SDK dependency: JavaScript to 2.39.0, Python to 2.39.1.
8d0a81b: Bump E2B SDK dependency: JavaScript to 2.39.0, Python to 2.39.1.
The Python floor is 2.39.1 specifically: e2b 2.38.0 moved the SDK's HTTP stack onto pyqwest and dropped the http2 parameter that Jupyter requests rely on to pin HTTP/1.1, so any e2b in >=2.38.0, <2.39.1 raises TypeError on every code execution. 2.39.1 restores it.
Also fixes run_code's timeout in the Python SDK. The new transport collapses httpx's per-phase timeouts into a single whole-request deadline and takes the longest phase, so passing timeout as the read timeout alongside request_timeout on the write and pool phases made the effective deadline max(timeout, request_timeout) — any timeout shorter than request_timeout (60s by default) was ignored and the execution ran on until request_timeout. timeout now bounds the request on its own, and timeout=0 disables the deadline instead of inheriting the connect timeout.
logs.stdout, logs.stderr and OutputMessage.line hold raw chunks with newlines kept (join them with '' to rebuild the output), and that Result.png, Result.jpeg and Result.pdf are base64-encoded.readLines quadratic line reassembly when streaming long single-line outputs (e.g. base64 images, wide DataFrames, large JSON): decode and scan only each new chunk, accumulating line fragments in an array that is joined once per emitted line, instead of appending to and re-scanning a single string buffer on every chunk.OutputMessage.timestamp in the JS Code Interpreter to use the backend timestamp (Unix epoch in nanoseconds) sent with each stdout/stderr message, instead of the client clock (new Date().getTime() * 1000). The type is unchanged (number); this aligns the value with the documented contract and the Python SDK. Because nanosecond epoch values exceed Number.MAX_SAFE_INTEGER, the JS value is precise to a few hundred nanoseconds (documented on OutputMessage.timestamp).eb70a98 : Honor the sandboxUrl / sandbox_url option and the E2B_SANDBOX_URL environment variable when connecting to the Jupyter server, matching the b
sandboxUrl/sandbox_url option and the E2B_SANDBOX_URL environment variable when connecting to the Jupyter server, matching the base E2B SDK. Jupyter requests now also send the E2b-Sandbox-Id and E2b-Sandbox-Port headers so a custom sandbox URL (e.g. a gateway or proxy) can route them to the right sandbox and port.6a74c39: Require Node.js 22.19.0 or newer and depend on undici@^8 only (undici 7 is dropped).
SETTINGS_MAX_CONCURRENT_STREAMS and opens more connections when one is saturated.E2B_API_INFLIGHT_REQUESTS, E2B_ENVD_INFLIGHT_REQUESTS and E2B_ENVD_RPC_INFLIGHT_REQUESTS env vars. Concurrency is governed by undici's connection pools (E2B_API_CONNECTIONS, E2B_ENVD_RPC_CONNECTIONS).73a784d: Require Node.js 22 or newer (Node.js 20 is no longer supported).
fe3e5db : Throw a descriptive TimeoutError / TimeoutException instead of a raw socket error (e.g. ECONNRESET ) when the sandbox is killed or times out
TimeoutError/TimeoutException instead of a raw socket error (e.g. ECONNRESET) when the sandbox is killed or times out while a request (runCode/run_code, context management) is in progress94bebe8 : Bump E2B package: add API-only custom header options for the JavaScript and Python SDKs
E2B client to the Code Interpreter SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox (and AsyncSandbox in Python) together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.pause and resume commands to manage sandbox state.
e2b sandbox pause <sandboxID> - pause a running sandboxe2b sandbox resume <sandboxID> - resume a paused sandboxa214875: Update e2b SDK versions
a214875: Update e2b SDK versions
Remove Sandbox.betaCreate (JS) and Sandbox.beta_create (Python). These methods were a beta of the lifecycle configuration that has since shipped on Sandbox.create. Migrate by calling Sandbox.create with the lifecycle option:
// before
await Sandbox.betaCreate({ autoPause: true })
// after
await Sandbox.create({ lifecycle: { onTimeout: 'pause' } })
# before
Sandbox.beta_create(auto_pause=True)
# after
Sandbox.create(lifecycle={"on_timeout": "pause"})
sandboxUrl/sandbox_url option and the E2B_SANDBOX_URL environment variable when connecting to the Jupyter server, matching the base E2B SDK. Jupyter requests now also send the E2b-Sandbox-Id and E2b-Sandbox-Port headers so a custom sandbox URL (e.g. a gateway or proxy) can route them to the right sandbox and port.4db7f15: Raise the minimum supported e2b SDK dependency versions.
6d54054: Add autocomplete support for javascript, typescript, r, java, and bash languages in runCode/run_code and createCodeContext/create_code_contex
TimeoutError/TimeoutException instead of a raw socket error (e.g. ECONNRESET) when the sandbox is killed or times out while a request (runCode/run_code, context management) is in progressurllib3>=2.8.0 so installs pick up the fixes for CVE-2026-97687 (HTTPS proxy TLS configuration ignored) and CVE-2026-97689 (unbounded chunk-size line buffering).94bebe8: Bump E2B package: add API-only custom header options for the JavaScript and Python SDKs
secure option of Sandbox.create (still accepted, now ignored): every sandbox is created through the v2 API, which always secures envd access. allow_internet_access is no longer preset to True; when omitted, the API default applies.a214875: Update e2b SDK versions
a214875: Update e2b SDK versions
Remove Sandbox.betaCreate (JS) and Sandbox.beta_create (Python). These methods were a beta of the lifecycle configuration that has since shipped on Sandbox.create. Migrate by calling Sandbox.create with the lifecycle option:
// before
await Sandbox.betaCreate({ autoPause: true })
// after
await Sandbox.create({ lifecycle: { onTimeout: 'pause' } })
# before
Sandbox.beta_create(auto_pause=True)
# after
Sandbox.create(lifecycle={"on_timeout": "pause"})
E2B client to the Desktop SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.6a74c39: Require Node.js 22.19.0 or newer and depend on undici@^8 only (undici 7 is dropped).
SETTINGS_MAX_CONCURRENT_STREAMS and opens more connections when one is saturated.E2B_API_INFLIGHT_REQUESTS, E2B_ENVD_INFLIGHT_REQUESTS and E2B_ENVD_RPC_INFLIGHT_REQUESTS env vars. Concurrency is governed by undici's connection pools (E2B_API_CONNECTIONS, E2B_ENVD_RPC_CONNECTIONS).73a784d: Require Node.js 22 or newer (Node.js 20 is no longer supported).
### Patch Changes - 59ec6f4: secure traffic access
66eabba: added context methods to the sdk
E2B client to the Desktop SDKs that binds the connection configuration explicitly, so the API key and domain no longer have to come from the environment variables: new E2B({ apiKey, domain }).Sandbox.create() in JavaScript and E2B(api_key=..., domain=...).Sandbox.create() in Python. The client exposes the package's own Sandbox together with the core Volume, Template and Secret resources, per-call options still take precedence, and multiple clients are isolated from each other and from the env-configured top-level exports.66eabba: added context methods to the sdk
### Patch Changes - 699d26c: Await async callbacks
345fe4f: Update e2b version to use the new connect method
be28fb7: Fix issue with secure False
6f15355: e2b 2.3.0 bump, includes a new build system 2.0 release
It's using secure option by default. This is a breaking change for custom code interpreters, you will need to rebuild the template. New code interpret…
secure option by default. This is a breaking change for custom code interpreters, you will need to rebuild the template. New code interpreter template correctly forward the secure token.Nothing published for this version
### Patch Changes - 912b97e: updated e2b version
2b7833b: added MIT License source
c590c09: bump e2b core to 1.4.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
0a27b5c: Update core SDK to add proxy parameter
Nothing published for this version
Nothing published for this version
2ee6ffb: Update JS SDK target to es2017
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
3fe798e: Fix json serialization for Result object
0d7e24f: Updated E2B SDK version
5493595: Remove bug in init method
### Patch Changes - f14a2a5: Add to_dict() method
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - 9604b90: Update httpx version
### Patch Changes - 6022f33: bump e2b package
### Patch Changes - 822302a: Bump version
One column per month.