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>