E2B example in Python

step-by-step E2B example in Python that shows stateful execution, installing packages, uploading a file, and doing a quick SQLite query—all inside a sandbox.

##0) Install & set your key

bash

pip install e2b-code-interpreter python-dotenv
export E2B_API_KEY="e2b_***"

E2B’s Python package is e2b-code-interpreter, and the SDK reads your E2B_API_KEY from env. (PyPI)

##1) Minimal stateful sandbox script

python

# e2b_step_by_step.py
import os
from e2b_code_interpreter import Sandbox

def main():
    # Spins up an isolated VM ("sandbox"); auto-shuts down when the block exits
    with Sandbox() as sbx:
        # --- A) Stateful Python: variables persist across calls ---
        sbx.run_code("x = 41")
        out = sbx.run_code("x += 1; x")          # reuses x
        print("x =", out.text)                   # -> 42

        # --- B) Shell: install a package inside the sandbox ---
        sbx.commands.run("pip install --quiet pandas")  # ok to pip-install at runtime

        # --- C) Upload a CSV into the sandbox filesystem ---
        csv = "name,age\nTaro,30\nHanako,28\n"
        sbx.files.write("/home/user/people.csv", csv)

        # --- D) Analyze the CSV in Python (pandas) ---
        out = sbx.run_code(r'''
import pandas as pd
df = pd.read_csv("/home/user/people.csv")
df["age"].mean()
''')
        print("mean age:", out.text)

        # --- E) Quick SQLite session (persists objects across cells) ---
        sbx.run_code(r'''
import sqlite3
conn = sqlite3.connect("/home/user/demo.db")
cur = conn.cursor()
cur.execute("CREATE TABLE IF NOT EXISTS t(a INT)")
cur.executemany("INSERT INTO t(a) VALUES (?)", [(1,), (2,), (3,)])
conn.commit()
''')
        out = sbx.run_code(r'''
cur.execute("SELECT sum(a) FROM t")
cur.fetchone()[0]
''')
        print("sum =", out.text)

        # --- F) Peek at files (via Python, no shell needed) ---
        out = sbx.run_code('import os; print(os.listdir("/home/user"))')
        print("files in /home/user:\n", "".join(out.logs.stdout))

if __name__ == "__main__":
    main()

Why this works / what to know

Sandbox() starts an isolated cloud VM where you can run code repeatedly and reuse variables (run_code shares state across calls). The returned Execution has .text (last expression) and .logs.stdout for prints. (e2b.dev)
You can run shell commands like pip install … via sandbox.commands.run(...). (Hugging Face)
You can upload files into the sandbox with sandbox.files.write(path, data) (string/bytes/IO). (e2b.dev)
By default, a sandbox has a short idle timeout (~5 minutes) unless you keep using it. (e2b.dev)

##2) (Optional) Pause & resume the same sandbox later

If you want the exact process memory and filesystem to persist (even running kernels), E2B has persistence (public beta):

python

from e2b_code_interpreter import Sandbox

sbx = Sandbox()               # create
sbx.beta_pause()              # save full state (ID: sbx.sandbox_id)
same = Sandbox.connect(sbx.sandbox_id)  # resume later and continue

This preserves files and memory (variables, processes) between sessions. (e2b.dev)

##3) Useful docs you’ll likely reference

Quickstart (API key, first sandbox). (e2b.dev)
Python SDK: Sandbox.run_code (stateful cells; result fields). (e2b.dev)
Filesystem read/write (Python files.write, files.read, etc.). (e2b.dev)
Install custom packages / runtime installs (pip install in sandbox). (e2b.dev)
Commands API (shell in sandbox). (e2b.dev)
Cookbook examples (more end-to-end Python demos). (GitHub)

If you want, I can tailor this to your exact use case (e.g., connecting to Postgres/MySQL from inside the sandbox, or wiring this into your LLM/tool-calling flow).

##0) Install & set your key

##1) Minimal stateful sandbox script

##2) (Optional) Pause & resume the same sandbox later

##3) Useful docs you’ll likely reference

k1ito-tech

diskcache

Best mcp server development sdk?

# [2508.20722] rStar2-Agent: Agentic Reasoning Technical Report

Daytona Sandbox：開発環境の新たな可能性

# Agentic workflow patterns - AWS Prescriptive Guidance

Amazon EC2 Single GPU P5 instances are now generally available