deer-flow
字节跳动开源的超级代理框架,让 AI 自主完成从研究到编码的复杂长周期任务
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
字节跳动开源的超级代理框架,让 AI 自主完成从研究到编码的复杂长周期任务
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象一下:你对 AI 说一句「帮我研究一下量子计算的最新进展,写一份报告」,然后去喝杯咖啡,回来时一份结构完整、图表丰富的研究报告已经躺在你的工作区里了。这不是科幻,而是 DeerFlow 2.0 正在做的事。
2025 年初,OpenAI 推出 Deep Research 功能,展示了 AI 自主规划、长周期任务执行的能力。然而,这类能力背后依赖复杂的基础设施:多轮推理、代码执行、信息检索、结果整合——每一环都是独立的工程挑战。DeerFlow(Deep Exploration and Efficient Research Flow)的诞生,正是为了让任何团队都能在本地构建类似 Deep Research 的能力。
DeerFlow 由字节跳动火山引擎(ByteDance Volcengine)孵化,2025 年初发布 v1.0,2026 年 2 月 28 日发布从零重写的 2.0 版本,一经发布即登顶 GitHub Trending 第一名,目前 Stars 数已超过 69,000,成为 AI Agent 领域最受关注的项目之一。
如果说普通的 LLM 是一个「能思考的人」,DeerFlow 就是给这个人配备了一个完整的工作台:里面有各种专业工具(代码沙箱、搜索工具、文件读写)、一个记忆系统(记录任务进展)、多个可以分工协作的助手(子 Agent),以及一个指挥官(主 Agent)来协调全局。这套「脚手架」(harness)让 AI 不再只是「能说会道」,而是真正能「动手干活」。
多 Agent 协作编排:DeerFlow 基于 LangGraph 构建图调度引擎,支持主 Agent 调用多个专业子 Agent。不同的子 Agent 可以分别负责资料检索、代码编写、数据分析、内容生成等不同任务,主 Agent 负责规划任务流程、协调子 Agent 之间的信息传递。
可插拔技能系统(Skills):项目内置 21 个预置技能(skills/public 目录),涵盖深度研究、论文综述、图表可视化、数据分析、前端设计、PPT 生成、播客生成、GitHub 研究等场景。每个技能是一个结构化目录,定义了工具、提示词和执行逻辑,用户可以像装插件一样加载和切换技能。
代码沙箱隔离执行:DeerFlow 的沙箱(Sandbox)模块支持在 Docker 容器内安全执行 AI 生成的代码,隔离运行环境防止恶意代码影响宿主机。这是实现「AI 写代码并运行验证」能力的基础设施,也是大多数开源 Agent 框架欠缺的环节。
上下文工程(Context Engineering):支持对对话上下文进行精细化管理,包括长程记忆(Long-Term Memory)和工作区文件系统,AI 在长周期任务中可以持续积累和检索信息,而不是每次都「失忆」。
多模态与多模型支持:推荐使用豆包 Seed-2.0-Code 和 DeepSeek v3,同时也支持 OpenAI GPT 系列、Anthropic Claude、Qwen 等主流模型。支持推理模式(thinking)开关,还支持本地 vLLM 部署的 Qwen3 系列推理模型。
DeerFlow 2.0 采用现代化的微服务架构:
项目提供了完整的多阶段 Dockerfile,分别构建后端(Python + uv 包管理)和前端(Node.js 22 + pnpm),生产环境通过 docker-compose 编排 3 个服务(nginx、frontend、gateway)。支持通过 APT 镜像和 NPM 镜像适配受限网络环境。
代码质量方面,项目包含 .pre-commit-config.yaml 自动化检查,文档极为完善(5 种语言的 README、Install.md 面向 AI 编程工具的引导脚本、完整配置示例),体现了字节跳动工程团队的成熟实践。
DeerFlow 提供了两种部署路径:**Docker 部署(推荐)**和本地开发部署。Docker 部署只需 10-15 分钟,通过 make setup 交互式引导配置 LLM API Key,然后 docker compose up 即可启动完整服务。
本地开发部署依赖 Python 3.12+、Node.js 22、pnpm、uv 等工具链,门槛稍高但方便调试。配置通过 config.yaml 文件管理,支持多种模型提供方和环境变量注入。
项目还提供了 Claude Code 集成能力——通过 MCP 协议,DeerFlow 可以直接调用 Claude Code 执行更复杂的编程任务,实现「AI 研究 + AI 编程」的无缝衔接。
DeerFlow 在文档中明确标注了安全注意事项:沙箱模式可防止恶意代码逃逸,但 Docker socket 挂载到容器内的配置需要谨慎审查;API Key 管理应使用密钥管理服务而非明文存储;在非可信环境下部署时需要额外的网络隔离措施。这些提醒反映了项目团队的工程严谨性。
DeerFlow 的出现代表了 AI Agent 发展的一个重要方向:基础设施下沉。当 Deep Research 能力被封装成开源工具包,中小团队也能快速拥有「AI 研究员 + AI 程序员」的生产力。这与 Manus 的「通用 Agent」理念一脉相承,但在部署成本、可扩展性方面更具优势。
LangGraph 生态的成熟也让 DeerFlow 的技术选型更具长期维护性——不是从零造轮子,而是站在 LangChain/LangGraph 的肩膀上专注于上层编排逻辑。19 个活跃 topics 标签也说明项目正在向多模态、多场景方向快速演进。
图1:DeerFlow 2.0 官方首页展示(deerflow.tech)
图2:DeerFlow 2.0 功能架构图
