E2B README

The project's README from github.com/e2b-dev/E2B. As one markdown file: README.md.

E2B Logo E2B Logo

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

What is E2B?

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 or Python SDK.

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.
  2. Get your API key here.
  3. Set environment variable with your API key
E2B_API_KEY=e2b_***

3. Start a sandbox and run commands

JavaScript / TypeScript

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

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()/run_code(), install the Code Interpreter SDK (JavaScript / Python):

npm i @e2b/code-interpreter  # JavaScript/TypeScript
pip install e2b-code-interpreter  # Python

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 / Python):

npm i @e2b/desktop  # JavaScript/TypeScript
pip install e2b-desktop  # Python

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.

7. E2B cookbook

Visit our Cookbook to get inspired by examples with different LLMs and AI frameworks.

Self-hosting

Read the self-hosting guide to learn how to set up the E2B infrastructure on your own. The infrastructure is deployed using Terraform.

Supported cloud providers:

E2B (e2b-dev/E2B)

Searching Database…

14.5K ·GitHub
E2B
Что это такое?E2B — это инфраструктура с открытым исходным кодом, которая позволяет запускать код, сгенерированный ИИ, в безопасных изолированных облачных песочницах, чтобы агенты могли безопасно выполнять непроверенный код.
Это библиотека или облачный сервис?И то, и другое: это облачный сервис песочниц, которым управляют через SDK для JavaScript/TypeScript или Python, а также всю инфраструктуру можно развернуть самостоятельно.
Как запустить первую песочницу?Установите SDK, зарегистрируйтесь и получите API-ключ E2B, задайте его как переменную окружения, затем запустите песочницу и выполняйте команды из вашего кода на JS/TS или Python.
Нужен ли API-ключ E2B для работы с песочницами?Да, перед запуском любой песочницы нужно зарегистрироваться в E2B и получить API-ключ.
Можно ли развернуть E2B у себя вместо облака?Да, есть руководство по самостоятельному развёртыванию, которое поднимает инфраструктуру с помощью Terraform, но пока полностью поддерживаются только AWS и GCP — Azure и обычные Linux-машины пока не готовы.
Для кого предназначен E2B?Для разработчиков, которые создают ИИ-агентов или копилотов и должны безопасно выполнять код, сгенерированный LLM, например интерпретаторы кода или ИИ-ассистентов для программирования.
Это десктопное приложение или облачная платформа?Это облачная платформа, к которой обращаются через вызовы SDK из вашего кода на JS или Python; десктопного приложения здесь нет.
Для чего нужен SDK Code Interpreter?Это дополнительный SDK, который позволяет выполнять код внутри песочницы простым вызовом runCode()/run_code(), полезен для сценариев работы агентов в стиле блокнота.
Что такое Desktop SDK?Он добавляет песочницам возможности управления компьютером: мышь, клавиатура, скриншоты, управление приложениями и API для потоковой передачи рабочего стола.
Есть ли примеры проектов, на которых можно учиться?Да, в E2B Cookbook есть примеры, где песочницы E2B сочетаются с разными LLM и фреймворками для ИИ.
Какие облачные провайдеры поддерживают размещённый сервис E2B?Управляемый облачный сервис E2B работает сразу после регистрации; вариант самостоятельного развёртывания специально поддерживает установку на AWS и GCP через Terraform.
What are similar projects?awesome-chatgpt-zh, botpress, self-operating-computer, OpenIntelligentUI, qwen-code, langfuse, agent-zero, composio
Which topics is it in?development, software, gui-automation, gpt-4, terraform, computer-use, copilot, devtools, gpt, sandbox, browser-automation, nextjs
Creator
e2b-dev
Size
126.9 MB
Stars
14.5K
Updated
CommitOct 19Release@e2b/[email protected]Oct 13
Age
3y
Commits · 90 Days