E2B offers Python and JS/TS SDK to spawn and control these sandboxes.

Getting started

  1. Get your API key
  2. Set your E2B API key to the E2B_API_KEY env var when starting the Docker container
  3. Optional - Install the CLI with NPM.
    npm install -g @e2b/cli@latest
    
    Full CLI API is here.

OpenHands sandbox

You can use the E2B CLI to create a custom sandbox with a Dockerfile. Read the full guide here. The premade OpenHands sandbox for E2B is set up in the containers directory. and it’s called openhands.

Debugging

You can connect to a running E2B sandbox with E2B CLI in your terminal.
  • List all running sandboxes (based on your API key)
    e2b sandbox list
    
  • Connect to a running sandbox
    e2b sandbox connect <sandbox-id>