E2B Sandbox
为 AI 生成代码提供云端隔离沙箱执行环境。
- 源仓库
- e2b-dev/E2B
- Star 数
- ★ 15k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 为调用大模型生成代码的应用，在每次执行前创建隔离云端 Sandbox。
- 不适合
- 需要完全离线或本地运行沙箱的团队
- 使用 Azure 或普通 Linux 机器自托管的团队
- 不愿注册 E2B 账号并获取 API key 的用户
这个 Agent 能做什么，适合哪些场景？
E2B 是用于在云端安全隔离沙箱中运行 AI 生成代码的开源基础设施。它通过 JavaScript/TypeScript SDK 与 Python SDK 创建和控制 Sandbox 实例。开发者可在沙箱中运行命令，并获取命令的标准输出；代码执行场景可使用独立的 Code Interpreter SDK 调用 runCode()/run_code()。默认使用 E2B API 密钥连接服务，也可依据其自托管指南用 Terraform 在 AWS 或 Google Cloud 部署基础设施。
应用先安装 e2b 包并配置 E2B_API_KEY，然后调用 Sandbox.create() 创建云端隔离沙箱。在 JavaScript 中，可调用 sandbox.commands.run('echo "Hello from E2B!"')，并从 result.stdout 读取输出；Python 版本在 with Sandbox.create() 上下文中执行同名 commands.run()。若安装 @e2b/code-interpreter 或 e2b-code-interpreter，则可创建对应的 Sandbox，使用 runCode()/run_code() 执行代码并读取 execution.text。自托管部署使用 E2B infrastructure 的 Terraform 配置，文档列出的支持云为 AWS 和 Google Cloud。
- 为调用大模型生成代码的应用，在每次执行前创建隔离云端 Sandbox。
- 使用 TypeScript 服务运行 echo 等命令，并将 result.stdout 返回给调用方。
- 使用 Python 后端在上下文管理器内运行沙箱命令并处理输出。
- 需要以 runCode() 执行代码并读取 execution.text 的代码解释器应用。
- 希望在 AWS 或 Google Cloud 内部署 E2B 基础设施的团队。
如何安装或部署这个 Agent？
JavaScript/TypeScript：运行 npm i e2b。Python：运行 pip install e2b。注册 E2B、获取 API 密钥，并配置环境变量 E2B_API_KEY=e2b_***。如需代码解释器，安装 npm i @e2b/code-interpreter 或 pip install e2b-code-interpreter。
如何使用这个 Agent？
JavaScript/TypeScript：import Sandbox from 'e2b'，然后执行 const sandbox = await Sandbox.create()、const result = await sandbox.commands.run('echo "Hello from E2B!"')，读取 result.stdout。Python：from e2b import Sandbox，在 with Sandbox.create() as sandbox: 中运行 sandbox.commands.run('echo "Hello from E2B!") 并读取 result.stdout。代码解释器示例使用 import { Sandbox } from '@e2b/code-interpreter'，随后调用 await sandbox.runCode('x = 1; x += 1; x') 并读取 execution.text。
这个 Agent 有哪些优点和局限？
- 提供 JavaScript/TypeScript 与 Python 两套 SDK，并使用相同的 Sandbox.create() 和 commands.run() 工作流。
- 命令执行结果可通过 result.stdout 直接读取，适合把沙箱执行接入应用逻辑。
- 代码解释器 SDK 提供 runCode()/run_code() 与 execution.text 的专用执行接口。
- 自托管基础设施采用 Terraform，并明确支持 AWS 和 Google Cloud。
- 使用托管服务前需要注册并配置 E2B API 密钥。
- 文档列出的自托管支持仅包括 AWS 和 Google Cloud；Azure 与通用 Linux 机器尚未标记为支持。
- 代码解释器不是主 e2b 包的一部分，需额外安装独立 SDK。
- 所给资料未说明定价、资源配额、沙箱生命周期或故障恢复策略。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| E2B Sandbox 当前 | 52 · 缺口较多 | 代码库 / SDK免费版 + 付费版 | ★ 15k | 今天 | Python | — |
| AgentQL 网页数据提取与自动化工具套件 | 42 · 缺口较多 | 代码库 / SDK免费版 + 付费版 | ★ 1.5k | 3 天前 | Python | — |
| SkillLite | 60 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 152 | 8 天前 | Rust | — |
| Capsule 沙箱运行时 | 52 · 缺口较多 | 命令行工具免费 | ★ 302 | 25 天前 | Rust | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：沙箱隔离设计（least_privilege 1分，有隔离但未明确权限最小化）；无用户确认机制（0分）；数据流透明度有限（1分，有文档但未详细说明数据流）；敏感数据处理有API密钥管理（1分）；依赖安全有overrides和锁定文件（2分）；外部影响有沙箱隔离（1分）；无回滚机制（0分）；来源归属有User-Agent测试（1分）。扣分原因：缺少用户确认、回滚机制，数据流透明度不足。
证据显示：自一致性良好（2分，测试覆盖）；依赖可用性有锁定文件（2分）；失败消息有测试（2分）。扣分原因：无执行验证，静态审查。
证据显示：受众明确（开发者）（2分）；能力边界有文档（2分）；触发精度有CLI参数验证（2分）；环境适配有跨平台测试（2分）。扣分原因：无重大缺陷。
证据显示：信息架构清晰（2分）；安装说明详细（2分）；命名稳定（2分）；示例和FAQ有（2分）；已知限制部分（1分，未明确列出）；许可证完整（3分）；版本变更有changeset（2分）；维护责任有GitHub Actions（2分）。扣分原因：已知限制不明确。
证据显示：输出可用性有JSON格式（2分）；边际价值高（2分）；成本效益未明确（1分）。扣分原因：成本效益未量化。
证据显示：声明可追溯（2分，文档和代码对应）；跨源验证有限（1分，仅内部测试）；事实与推断分离（2分）。扣分原因：缺乏外部验证。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 未验证发布者身份，需谨慎对待供应链风险。
- 静态审查未执行实际运行，安全性和可靠性需进一步验证。
- 缺少用户确认和回滚机制，可能影响企业级采用。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Minor Changes - a8155c4: Add strict to pause() (default false). With strict: true / strict=True a pause is refused with ServiceBusyError / ServiceBusyException while the sandbox's guest agent does not respond, and the sandbox keeps running. Without it the API's default applies: the memory snapshot is taken anyway and marked. Sandbox info exposes the mark as envdUnresponsiveAtPause / envd_unresponsive_at_pause, and resuming such a sandbox without onResume: 'reboot' / on_resume="reboot" now throws GuestUnresponsiveError / GuestUnresponsiveException.在 GitHub 查看 ↗ -
发布说明摘录
Minor Changes - a8155c4: Add strict to pause() (default false). With strict: true / strict=True a pause is refused with ServiceBusyError / ServiceBusyException while the sandbox's guest agent does not respond, and the sandbox keeps running. Without it the API's default applies: the memory snapshot is taken anyway and marked. Sandbox info exposes the mark as envdUnresponsiveAtPause / envd_unresponsive_at_pause, and resuming such a sandbox without onResume: 'reboot' / on_resume="reboot" now throws GuestUnresponsiveError / GuestUnresponsiveException.在 GitHub 查看 ↗
常见问题
是否需要 API 密钥？
E2B_API_KEY=e2b_***。