![E2B SDK Preview](/readme-assets/e2b-sdk-light.png#gh-light-mode-only) ![E2B SDK Preview](/readme-assets/e2b-sdk-dark.png#gh-dark-mode-only)

Last 1 month downloads for the Python SDK Last 1 month downloads for the JavaScript SDK

## What is E2B? [E2B](https://www.e2b.dev/) is an open-source infrastructure that allows you to run AI-generated code in secure isolated sandboxes in the cloud. To start and control sandboxes, use our [JavaScript SDK](https://www.npmjs.com/package/e2b) or [Python SDK](https://pypi.org/project/e2b). ## Run your first Sandbox ### 1. Install SDK JavaScript / TypeScript ``` npm i e2b ``` Python ``` pip install e2b ``` ### 2. Get your E2B API key 1. Sign up to E2B [here](https://e2b.dev). 2. Get your API key [here](https://e2b.dev/dashboard?tab=keys). 3. Set environment variable with your API key ``` E2B_API_KEY=e2b_*** ``` ### 3. Start a sandbox and run commands JavaScript / TypeScript ```ts import Sandbox from 'e2b' const sandbox = await Sandbox.create() const result = await sandbox.commands.run('echo "Hello from E2B!"') console.log(result.stdout) // Hello from E2B! ``` Python ```py from e2b import Sandbox with Sandbox.create() as sandbox: result = sandbox.commands.run('echo "Hello from E2B!"') print(result.stdout) # Hello from E2B! ``` ### 4. Code execution with Code Interpreter If you need to execute code with [`runCode()`](https://e2b.dev/docs/code-interpreting)/[`run_code()`](https://e2b.dev/docs/code-interpreting), install the [Code Interpreter SDK](https://github.com/e2b-dev/code-interpreter): ``` npm i @e2b/code-interpreter # JavaScript/TypeScript pip install e2b-code-interpreter # Python ``` ```ts import { Sandbox } from '@e2b/code-interpreter' const sandbox = await Sandbox.create() const execution = await sandbox.runCode('x = 1; x += 1; x') console.log(execution.text) // outputs 2 ``` ### 5. Check docs Visit [E2B documentation](https://e2b.dev/docs). ### 6. E2B cookbook Visit our [Cookbook](https://github.com/e2b-dev/e2b-cookbook/tree/main) to get inspired by examples with different LLMs and AI frameworks. ## Self-hosting Read the [self-hosting guide](https://github.com/e2b-dev/infra/blob/main/self-host.md) to learn how to set up the [E2B infrastructure](https://github.com/e2b-dev/infra) on your own. The infrastructure is deployed using Terraform. Supported cloud providers: - 🟢 AWS - 🟢 Google Cloud (GCP) - [ ] Azure - [ ] General Linux machine