Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/e2b-dev/e2b

Open-source, secure environment with real-world tools for enterprise-grade agents.
https://github.com/e2b-dev/e2b

agent ai ai-agent ai-agents code-interpreter copilot development devtools gpt gpt-4 javascript llm nextjs openai python react software typescript

Last synced: 1 day ago
JSON representation

Open-source, secure environment with real-world tools for enterprise-grade agents.

Awesome Lists containing this project

README 

          


  E2B Logo

  E2B Logo






  

    Last 1 month downloads for the Python SDK

  

  

    Last 1 month downloads for the JavaScript SDK

  




## What is E2B?

[E2B](https://e2b.dev/?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=E2B) 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/?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=E2B).

2. Get your API key [here](https://e2b.dev/dashboard?tab=keys&utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=E2B).

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?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=E2B)/[`run_code()`](https://e2b.dev/docs/code-interpreting?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=E2B), install the Code Interpreter SDK ([JavaScript](./packages/code-interpreter-js) / [Python](./packages/code-interpreter-python)):



```

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. Computer use with Desktop



For mouse, keyboard, screenshot, application, and desktop streaming APIs, install the Desktop SDK ([JavaScript](./packages/desktop-js) / [Python](./packages/desktop-python)):



```

npm i @e2b/desktop  # JavaScript/TypeScript

pip install e2b-desktop  # Python

```



```ts

import { Sandbox } from '@e2b/desktop'



const desktop = await Sandbox.create()

await desktop.launch('google-chrome')

const screenshot = await desktop.screenshot()

```



### 6. Check docs

Visit [E2B documentation](https://e2b.dev/docs?utm_source=github&utm_medium=referral&utm_campaign=readme&utm_content=E2B).



### 7. 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 [embed deployment guide](https://github.com/e2b-dev/runtime/blob/main/embed/README.md) to learn how to set up the [E2B runtime](https://github.com/e2b-dev/runtime) on your own. The infrastructure is deployed using Terraform. 



Supported cloud providers:

- 🟢 AWS

- 🟢 Google Cloud (GCP)

- 🟢 Azure

- 🟢 General Linux machine (via Embed)