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.

   JavaScript & TypeScript

   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.

   JavaScript & TypeScript

   // 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:

   JavaScript & TypeScript

   npx tsx ./index.ts