Running your first Sandbox

This guide will show you how to start your first E2B Sandbox.

1. Create E2B account

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

2. Set your environment variables

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

.env

E2B_API_KEY=e2b_***

3. Install E2B SDK

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

Terminal
npm i @e2b/code-interpreter dotenv

4. 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() // By default the sandbox is alive for 5 minutes
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)

5. Start your first E2B Sandbox

Run the code with the following command:

Terminal
npx tsx ./index.ts