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
   

   pip install e2b-code-interpreter python-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() // 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)
   
5. Start your first E2B sandbox

   Run the code with the following command:

   JavaScript & TypeScript

   npx tsx ./index.ts
   

   python main.py