e2b-cookbook

照着抄,轻松给 AI 加上代码执行能力

e2b-cookbook 是一个面向 AI 智能体开发者的示例代码库,专门展示如何使用 E2B 的代码解释器(Code Interpreter)能力。它解决的核心问题是:当 AI 模型(如 GPT-4)需要执行代码、处理数据或进行复杂计算时,如何安全地在云端沙箱环境中运行。项目提供大量可运行的示例,覆盖 Python、JavaScript/TypeScript 等主流语言,演示了从基础的文件操作、数据分析到高级的智能体工作流构建。通过清晰的指南和代码片段,开发者可以快速上手 E2B SDK,将代码执行能力集成到自己的 AI 应用中,从而扩展模型的功能边界。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1404
维护状态 活跃
是否开源 是
定价模式 unknown

项目数据

分类智能体
开发团队e2b-dev
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议
主要语言TypeScript
技术栈/模型agent,ai,ai-agents,code-interpreter,cookbook,devtools,e2b,example,gpt,gpt4,guides,javascript,llm,openai,python,python3,sdk,tutorial,typescript
GitHub 星标★ 1404
30天Star增速
HF 下载量
上线时间2023-09-27 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

环境要求

  • 能运行 npm 的 Node.js 环境(仓库自带 npm 脚本)
  • 有效的 E2B_API_KEY 环境变量
  • 按所运行示例准备对应的模型供应商密钥(如 OpenAI,见 .env.example)
  • 网络可访问 E2B 云端沙箱与 npm 源

安装与启动步骤

  1. 1克隆仓库

    把 e2b-cookbook 示例仓库下载到本地,后续所有命令都在该目录中执行。

    git clone https://github.com/e2b-dev/e2b-cookbook.git
    cd e2b-cookbook
  2. 2安装依赖

    在仓库根目录安装运行示例测试套件所需的依赖,README 要求先执行这一步再跑测试。

    npm install
  3. 3配置 API Key

    README 说明需要 E2B_API_KEY,以及所运行示例对应的供应商密钥,可参考 .env.example 填写。

    cp .env.example .env
  4. 4运行全部示例

    测试套件会把每个示例上传到全新沙箱,用各自的工具链安装并运行,退出码为 0 即通过。

    npm test
  5. 5只跑 Hello World

    npm test 支持子串过滤;README 建议先从 hello-world 开始,它只需要 E2B 密钥。

    npm test -- hello-world

关键配置

配置项必填说明示例
E2B_API_KEY是访问 E2B 云端沙箱的密钥,运行任何示例都需要e2b_xxxxxxxxxxxxxxxx
供应商模型密钥(如 OPENAI_API_KEY)否运行非 Hello World 示例时所需的模型供应商密钥,具体名称见 .env.examplesk-xxxxxxxxxxxxxxxx

如何确认成功

运行 npm test 后终端输出每个示例的执行结果,示例以退出码 0 结束即表示通过。

常见问题

Q:需要哪些密钥才能跑起来?

A:至少要 E2B_API_KEY;hello-world-js 和 hello-world-python 只需要这一个密钥,其他示例还需按 .env.example 提供对应的供应商密钥。

Q:供应商限流或额度用尽算失败吗?

A:不算。README 明确说明限流或额度耗尽仍算通过,因为沙箱已经成功构建、安装并运行了。

Q:为什么有些结果显示 skipped?

A:模型行为不确定的情况(没生成图表、工具调用格式错误、生成的代码在沙箱内报错)会被标记为 skipped,而不是失败。

Q:为什么部分示例没有被测试套件覆盖?

A:这些示例需要仓库不持有的供应商密钥、长时间运行的服务器或等待上游修复,原因逐条写在 tests/run-examples.ts 顶部。

注意事项

  • 仓库本身是示例与指南集合,不是可部署的服务,使用方式是运行其中的示例代码。
  • 先跑 hello-world-js 和 hello-world-python,它们只依赖 E2B 密钥,排错成本最低。
  • 真正的失败指模板缺失、依赖解析失败、入口写错、认证失败、模型 ID 下线或沙箱超时。
  • 单个示例的具体运行方式以各 examples 子目录内的说明为准,README 未统一给出。

核心亮点

  • 示例丰富,覆盖 Python 和 JS/TS,上手快
  • 直接对接 E2B 官方 SDK,代码可复用性高
  • 场景贴近实战,如数据分析、代码生成、智能体工作流

不足之处

  • 依赖 E2B 平台,非通用方案
  • 文档/社区待观察

适用场景

  • 为 AI 应用集成安全代码执行环境
  • 构建数据分析和可视化智能体
  • 开发需要动态代码生成与执行的编程助手

替代项目

OpenAI Code Interpreter、LangChain CodeExecutor、Jupyter Kernel Gateway

项目介绍

e2b-cookbook 是智能体领域的开源项目,由 e2b-dev 开发,2023 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,404)位列前 30%,在智能体分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,383 增加到 1,404,净增 21。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。

它主要面向的使用场景是:为AI应用集成安全代码执行环境。同类可对比的替代方案包括 OpenAI Code Interpreter、LangChain CodeExecutor、Jupyter Kernel Gateway。

上一篇:recall-loom

下一篇:devchain

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12