什么是 E2B？

E2B 是一个开源基础设施，允许你在云端的安全隔离沙箱中运行由 AI 生成的代码。要启动和控制沙箱，请使用我们的 JavaScript SDK 或 Python SDK。

运行你的第一个沙箱

1. 安装 SDK

JavaScript / TypeScript

npm i e2b

Python

pip install e2b

2. 获取你的 E2B API 密钥

1. 在 这里 注册 E2B。
2. 在 这里 获取你的 API 密钥。
3. 设置包含你的 API 密钥的环境变量：

E2B_API_KEY=e2b_***

3. 启动一个沙箱并运行命令

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. 使用代码解释器执行代码

如果你需要使用 runCode()/run_code() 来执行代码，可以安装 代码解释器 SDK：

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)  // 输出 2

5. 查看文档

访问 E2B 文档。

6. E2B 烹饪书

访问我们的 烹饪书，获取使用不同 LLM 和 AI 框架的示例灵感。

自托管

阅读 自托管指南，了解如何在你自己的环境中搭建 E2B 基础设施。该基础设施使用 Terraform 部署。

支持的云服务提供商：

• 🟢 AWS
• 🟢 Google Cloud (GCP)
• Azure
• 通用 Linux 服务器

E2B 快速上手指南

E2B 是一个开源基础设施，允许你在云端安全的隔离沙箱中运行 AI 生成的代码。本指南将帮助你快速开始使用 E2B SDK。

环境准备

• 操作系统：支持 Linux、macOS 和 Windows
• 运行时环境：
  • Node.js (推荐 v16+) 用于 JavaScript/TypeScript
  • Python (推荐 v3.8+) 用于 Python
• 网络要求：需要能够访问 e2b.dev 服务
• 账号要求：需要注册 E2B 账号并获取 API Key

安装步骤

1. 安装 SDK

根据你的开发语言选择对应的安装命令：

JavaScript / TypeScript

npm i e2b

Python

pip install e2b

💡 国内加速建议：如果下载缓慢，可配置国内镜像源：

• npm: npm config set registry https://registry.npmmirror.com
• pip: pip install -i https://pypi.tuna.tsinghua.edu.cn/simple e2b

2. 配置 API Key

1. 访问 E2B 官网 注册账号
2. 在 Dashboard Keys 页面 获取你的 API Key
3. 设置环境变量：

Linux/macOS

export E2B_API_KEY=e2b_***

Windows (PowerShell)

$env:E2B_API_KEY="e2b_***"

基本使用

创建沙箱并运行命令

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!

执行代码（可选）

如需执行具体的代码片段（如 Python、JS 等），需安装 Code Interpreter SDK：

安装

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

---

更多高级用法、自定义模板及多模型集成示例，请访问 E2B 官方文档 或查看 Cookbook。