# e2b

> E2B SDK that give agents cloud environments

Latest version **2.58.0** (published 2026-10-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install e2b
pnpm add e2b
yarn add e2b
bun add e2b
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.58.0 |
| Published | 2026-10-20 |
| First published | 2024-02-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.19.0 |
| Dependencies | 11 |
| Unpacked size | 2.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 14363 |
| Author | FoundryLabs, Inc. |
| Maintainers | jakbuno, mlejva, dobrac, valentatomas, mishushakov, bl-e2b, ondrej-e2b, tomas.srnka-e2b |
| Keywords | e2b, ai-agents, agents, ai, code-interpreter, sandbox, code, runtime, vm, nodejs, javascript, typescript |

## Links

- npm: https://www.npmjs.com/package/e2b
- Repository: https://github.com/e2b-dev/e2b
- Homepage: https://e2b.dev/?utm_source=npm&utm_medium=referral&utm_campaign=package_homepage&utm_content=e2b
- Issues: https://github.com/e2b-dev/e2b/issues
- npm.io page: https://npm.io/package/e2b

## Dependencies (11)

- [tar](https://npm.io/package/tar.md) ^7.5.22
- [glob](https://npm.io/package/glob.md) ^13.0.6
- [chalk](https://npm.io/package/chalk.md) ^5.6.2
- [undici](https://npm.io/package/undici.md) ^8.11.2
- [platform](https://npm.io/package/platform.md) ^1.3.6
- [openapi-fetch](https://npm.io/package/openapi-fetch.md) ^0.17.0
- [compare-versions](https://npm.io/package/compare-versions.md) ^6.1.1
- [@bufbuild/protobuf](https://npm.io/package/@bufbuild/protobuf.md) ^2.16.0
- [@connectrpc/connect](https://npm.io/package/@connectrpc/connect.md) ^2.2.0
- [@e2b/dockerfile-utils](https://npm.io/package/@e2b/dockerfile-utils.md) ^0.1.1
- [@connectrpc/connect-web](https://npm.io/package/@connectrpc/connect-web.md) ^2.2.0

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 2.58.0 (latest) — 2026-10-20
- 2.24.1-connections.1189.0 (connections) — 2026-05-26
- 2.12.2-snapshots.0 (snapshots) — 2026-02-17
- 2.3.4-fix-prerelease-workflow.3 (rc) — 2025-10-20
- 1.2.0-beta.5 (beta) — 2025-04-30
- 1.2.5-autopause.1 (autopause) — 2025-04-23
- 0.16.1-deno.1 (deno) — 2024-05-08
- 2.57.0 — 2026-10-20
- 2.56.0 — 2026-10-13
- 2.55.0 — 2026-10-09
- 2.53.1 — 2026-10-06
- 2.52.1 — 2026-10-05
- 2.52.0 — 2026-10-01
- 2.51.0 — 2026-09-18
- 2.50.0 — 2026-09-16
- … 297 more at https://npm.io/package/e2b/versions

## README

<p align="center">
  <img src="/readme-assets/logo-black.png#gh-light-mode-only" alt="E2B Logo" width="200">
  <img src="/readme-assets/logo-white.png#gh-dark-mode-only" alt="E2B Logo" width="200">
</p>

<h4 align="center">
  <a href="https://pypi.org/project/e2b/">
    <img alt="Last 1 month downloads for the Python SDK" loading="lazy" decoding="async" style="color:transparent;width:170px;height:18px" src="https://static.pepy.tech/personalized-badge/e2b?period=monthly&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=PyPi%20Monthly%20Downloads">
  </a>
  <a href="https://www.npmjs.com/package/e2b">
    <img alt="Last 1 month downloads for the JavaScript SDK" loading="lazy" width="200" height="30" decoding="async" data-nimg="1"
    style="color:transparent;width:170px;height:18px" src="https://img.shields.io/npm/dm/e2b?label=NPM%20Monthly%20Downloads">
  </a>
</h4>

<!---
<img width="100%" src="/readme-assets/preview.png" alt="Cover image">
--->
## 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)

---
_Source: https://npm.io/package/e2b · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._