Running your first Sandbox

Create E2B account

Every new E2B account gets $100 in credits. You can sign up here.

Set your environment variables

Navigate to the E2B Dashboard.
Copy your API key.
Paste your E2B API key into your .env file.

.env

E2B_API_KEY=e2b_***

Install E2B SDK

Install the E2B SDK to your project by running the following command in your terminal.

npm i @e2b/code-interpreter dotenv

pip install e2b-code-interpreter python-dotenv

This guide uses the Code Interpreter SDK because the next step calls runCode() (Python: run_code()). Its Sandbox also supports shell commands and files. If your project only needs shell commands and files, the core e2b package is enough.

Write code for starting sandbox

We’ll write the minimal code for starting Sandbox, executing Python inside it and listing all files inside the root directory.

// index.ts
import 'dotenv/config'
import { Sandbox } from '@e2b/code-interpreter'

const sbx = await Sandbox.create() // Creates a persistent sandbox session
const execution = await sbx.runCode('print("hello world")') // Execute Python inside the sandbox
console.log(execution.logs)

const files = await sbx.files.list('/')
console.log(files)

# main.py
from dotenv import load_dotenv
load_dotenv()
from e2b_code_interpreter import Sandbox

sbx = Sandbox.create() # Creates a persistent sandbox session
execution = sbx.run_code("print('hello world')") # Execute Python inside the sandbox
print(execution.logs)

files = sbx.files.list("/")
print(files)

Start your first E2B sandbox

Run the code with the following command:

npx tsx ./index.ts

python main.py