What is E2B?
E2B is an open-source infrastructure that allows you to run AI-generated code in secure isolated sandboxes in the cloud. To start and control sandboxes, use our JavaScript SDK or Python SDK.
Run your first Sandbox
1. Install SDK
pip install e2b
2. Get your E2B API key
E2B_API_KEY=e2b_***
3. Start a sandbox and run commands
from e2b import Sandbox
with Sandbox.create() as sandbox:
result = sandbox.commands.run('echo "Hello from E2B!"')
print(result.stdout) # Hello from E2B!
4. Bind the configuration to a client
The top-level Sandbox, AsyncSandbox, Volume, AsyncVolume, Template, AsyncTemplate and Secret exports read their configuration from the environment variables. To use an explicit configuration — e.g. several API keys or domains in one process — create an E2B client and use the resource classes it exposes:
from e2b import E2B
client = E2B(api_key="e2b_***", domain="e2b.dev")
sandbox = client.Sandbox.create()
volume = client.Volume.create("my-volume")
exists = client.Template.exists("my-template")
secret = client.Secret.create("openai-api-key", "sk-***")
# The async variants are exposed as well.
async_sandbox = await client.AsyncSandbox.create()
# The classes can be assigned and used like the top-level ones.
Sandbox = client.Sandbox
paginator = Sandbox.list()
Per-call params still take precedence over the client's params, and clients are isolated from each other and from the env-configured top-level exports.
High-concurrency sandbox streams
The Python SDK spreads sandbox commands and files traffic across four HTTP/2 connection pools by default. This prevents long-running streams in one process from all contending for a single connection's concurrent-stream limit.
If one process needs more capacity, set E2B_ENVD_POOL_SHARDS before importing e2b. Each additional shard can open another connection to the sandbox host, so increase it only as needed:
E2B_ENVD_POOL_SHARDS=8 python eval.py
5. Code execution with Code Interpreter
If you need run_code(), install the Code Interpreter SDK:
pip install e2b-code-interpreter
from e2b_code_interpreter import Sandbox
with Sandbox.create() as sandbox:
execution = sandbox.run_code("x = 1; x += 1; x")
print(execution.text) # outputs 2
6. Check docs
Visit E2B documentation.
7. E2B cookbook
Visit our Cookbook to get inspired by examples with different LLMs and AI frameworks.
3 maintainers
Release files for e2b 2.51.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| e2b-2.51.0.tar.gz | 229.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| e2b-2.51.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 617.6 kB
Release files / e2b-2.51.0.tar.gz
| Download URL | e2b-2.51.0.tar.gz |
|---|---|
| Size | 229.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
902ee861b30c8ec3e46e7f84db8c993f30695872c7b4490efaad1627ec6e08ba
|
|
BLAKE2b-256 checksum How to use checksums |
440431a10aad90c6d9a55cd2f638b47b92fd867cc188127bc5087809b2b67628
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / e2b-2.51.0-py3-none-any.whl
| Download URL | e2b-2.51.0-py3-none-any.whl |
|---|---|
| Size | 388.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
951d0fd069f017e760b338a435bdb83589b4bfb9574fc5203a7f777e9cb994c2
|
|
BLAKE2b-256 checksum How to use checksums |
fb75882e5105b6f2ad8df3abff8701302f5dd4c41afa930a5ec0590c76e89c1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
