RepoDaily · 2026-06-23 · AI Agents

DeerFlow 2.0:字节跳动开源 SuperAgent 框架,覆盖研究、编码与创作

#7 Self-hosted app Python +736 bytedance/deer-flow 打开仓库

一次彻底重写——将子智能体、沙箱、长期记忆与可扩展技能编排到一个可自部署的智能体运行时中,内置 LangGraph 兼容网关与 Docker 优先部署方案。

项目类型自部署应用
最适合希望拥有可自部署的多智能体编排框架,用于深度研究、编码和内容创作的开发团队。
风险等级中等
评估时间Docker 方式约 1–2 小时;沙箱与多供应商配置可能需要更长时间。

核心问题: 你的团队是否需要一个可自部署、可扩展的智能体框架,能够协调子智能体、在沙箱中执行代码,并保留长期记忆?

83/100

RepoDaily 采用评分

RepoDaily 将该项目的采用分评为 83/100(强):分数来自文章来源、安装路径、生产风险、差异化、许可证清晰度以及 AI/Agent 适配度。

基于 RepoDaily 来源和采用说明的方向性评分,不是基准测试。风险: 中
76证据质量

包含 4 个来源、覆盖 2 类来源;如有 RepoDaily 独有模块,会进一步提高证据分。

100可安装/可试用性

检测到 5 个工作流步骤、4 个下一步动作,以及 5 个命令/安装信号。

66维护可信度

趋势热度为 +736 stars;如内容中有 release、issue 或维护信号,会提高维护可信度。

88生产准备度

采纳风险标记为 medium,并包含 4 条安全说明与 3 条跳过条件。

80差异化

2 个机会视角、3 个替代方案,以及 0 个类型化模块支撑差异化判断。

82许可证清晰度

文章中包含许可证来源或许可证表述。

90Agent / AI 适配度

文章正文和元数据中检测到 9 个 AI/Agent 相关信号。

项目概览

DeerFlow(Deep Exploration and Efficient Research Flow)是字节跳动推出的开源超级智能体框架。2.0 版本是一次完全重写,与 v1 深度研究框架不共享任何代码——旧分支仍可访问,但活跃开发已全面转向 2.0。

系统通过编排子智能体、持久化记忆、代码执行沙箱和可插拔技能系统,处理跨越研究、编码和内容创作的长周期任务。它提供 LangGraph 兼容的 API 网关、Web 前端和嵌入式 Python 客户端,既可作为交互式应用部署,也可作为编程后端使用。

DeerFlow 以 Docker 优先的方式自部署在 nginx 之后,支持多种 LLM 供应商——包括 OpenAI 兼容端点、OpenRouter、vLLM、Codex CLI 和 Claude Code OAuth——并集成了 BytePlus InfoQuest 提供智能搜索与爬取能力。

解决什么问题

  • 多数智能体框架要么是薄编排层(无沙箱、无记忆),要么是不可自部署或审计的托管 SaaS 产品。
  • 长周期任务——多步研究、迭代编码、内容管线——需要协调子智能体、持久化上下文和安全代码执行,很少有开源工具同时提供。
  • 配置多个 LLM 供应商、搜索后端和执行安全策略通常是手动且容易出错的过程。

工作原理

  1. 克隆仓库并运行 `make setup`——交互式向导引导你选择供应商、搜索、沙箱模式、bash 访问和文件写入偏好,生成 config.yaml 和 .env。
  2. 运行 `make docker-init` 然后 `make docker-start`,启动 nginx、前端、网关和可选的 provisioner 容器,全部支持热重载。
  3. 通过 localhost:2026 访问 Web 界面,或通过 Gateway API 和 LangGraph 兼容端点以编程方式交互。
  4. 智能体运行时编排子智能体、查询长期记忆、在沙箱环境中执行任务,并调用可扩展技能完成多步目标。
  5. 随时运行 `make doctor` 验证配置并获取修复建议。

部署与架构

DeerFlow 运行在 nginx 之后(端口 2026),将非 API 请求路由到前端(端口 3000),API 请求路由到网关(端口 8001)。网关承载 LangGraph 兼容运行时,处理智能体交互。

Docker 是推荐路径:`make docker-init` 构建镜像并安装依赖;`make docker-start` 启动所有服务并启用热重载。也提供本地开发路径,可直接用 Node.js 22+、pnpm、uv 和 nginx 运行。

README 提供了明确的主机资源配置建议:4 vCPU / 8 GB RAM 为起点,共享多智能体测试服务器建议 16 vCPU / 32 GB RAM。明确警告 2 vCPU / 4 GB 环境在正常负载下经常失败。

模型供应商灵活性

  • 通过 langchain_openai:ChatOpenAI 支持 OpenAI 兼容供应商,包括带自定义 base_url 的 OpenRouter。
  • 支持 OpenAI Responses API(通过 use_responses_api 标志)。
  • 通过自定义 VllmChatModel 供应商支持 vLLM(0.19.0+),包括推理模型开关。
  • CLI 供应商:Codex CLI(读取 ~/.codex/auth.json)和 Claude Code OAuth(多种凭证路径)。
  • README 推荐使用 Doubao-Seed-2.0-Code、DeepSeek v3.2 和 Kimi 2.5 运行 DeerFlow。

技能、子智能体与记忆

DeerFlow 的技能系统位于顶层 `skills/` 目录,包含 `public/` 和 `custom/` 子目录,团队无需 fork 核心代码即可扩展智能体能力。extensions_config 模板涵盖 MCP 和技能配置。

子智能体可通过运行时进行编排,长期记忆层跨会话持久化上下文。沙箱和文件系统层为代码生成任务提供隔离执行环境,上下文工程功能帮助管理多步工作流中的 token 预算。

谁适合关注

适合关注

  • 寻找 Devin 或 Manus 等托管智能体产品的自部署替代方案的团队。
  • 已在 LangChain/LangGraph 生态中,希望获得兼容智能体运行时的开发者。
  • 运行需要沙箱代码执行和持久化记忆的长周期任务的研究人员和工程师。
  • 拥有自有 LLM 部署(vLLM、OpenAI 兼容网关)并需要智能体前端的组织。

可以先跳过

  • 寻求托管式、免基础设施 SaaS 智能体产品的团队。
  • 仅需简单的单轮 LLM 包装器、无需编排的项目。
  • 资源低于 4 vCPU / 8 GB RAM 的环境——README 警告此类环境经常失败。

风险与注意事项

DeerFlow 2.0 是有强力背书的全新重写,但多服务架构、沙箱配置和资源要求构成了不可忽视的运维复杂度。

  • 运行完整技术栈(nginx、前端、网关、可选 provisioner)需要 Docker 经验和充足的主机资源。
  • 沙箱模式、bash 访问和文件写入工具引入了 README 明确指出的安全考量。
  • 作为 2.0 的完全重写,大规模生产验证仍在积累中。
  • 多种供应商配置路径(OpenAI、vLLM、Codex CLI、Claude OAuth)增加了使用非标准后端团队的配置复杂度。
  • README 包含专门的安全提示,警告不当部署可能引入安全风险。
  • 沙箱模式、bash 访问和文件写入工具可通过设置向导配置——在共享环境中应限制这些权限。
  • 凭证处理支持多种路径(环境变量、认证文件)——敏感密钥应通过 `.env` 管理,切勿提交到代码库。
  • nginx 配置提供同源 API 路由;跨源部署需通过 GATEWAY_CORS_ORIGINS 显式配置 CORS 白名单。

替代方案比较

方案适用场景代价
LangGraph(LangChain)
希望自行构建自定义智能体图,不需要预打包框架。开源;自部署
OpenHands
需要具有类似沙箱执行能力的开源自主编码智能体。开源;自部署
AutoGen(微软)
希望使用专注于智能体间对话的多智能体对话框架。开源;自部署

这个趋势说明了什么

企业研究自动化

团队可以在企业防火墙后部署 DeerFlow,配合自有 LLM 端点,为分析师提供一个自托管的深度研究智能体,处理搜索、综合和报告生成,数据不离开内部网络。

先与单个研究团队试点;配置 InfoQuest 或内部搜索供应商;对比手动工作流衡量任务完成质量。

自定义技能市场

技能目录结构(public + custom)邀请团队构建领域特定技能——金融分析、法律文档审查、代码审计——为垂直场景扩展智能体能力。

为你的领域构建一个自定义技能,通过 Web UI 测试,评估子智能体协调是否优于单体提示方案。

下一步建议

运行 Docker 快速开始

克隆仓库、运行设置向导、启动 Docker 技术栈,在真实任务上探索 DeerFlow 的 Web UI 和智能体能力。

  1. 克隆:git clone https://github.com/bytedance/deer-flow.git && cd deer-flow
  2. 运行 `make setup`,按交互向导配置 LLM 供应商。
  3. 运行 `make docker-init`,然后 `make docker-start`。
  4. 打开 http://localhost:2026,尝试一个多步研究或编码任务。

RepoDaily 判断

DeerFlow 2.0 是目前最具雄心的开源智能体框架之一——一个可自部署、可扩展的平台,集成了子智能体编排、沙箱执行、持久化记忆和 LangGraph 兼容 API。对于愿意管理基础设施的团队,它提供了一条端到端掌控自身智能体技术栈的可靠路径。

信息来源