bytedance / deer-flow
🦌 DeerFlow - 2.0
On February 28th, 2026, DeerFlow claimed the 🏆 #1 spot on GitHub Trending following the launch of version 2. Thanks a million to our incredible community — you made this happen! 💪🔥 2026年2月28日,随着 2.0 版本的发布,DeerFlow 荣登 GitHub 趋势榜 🏆 第一名。衷心感谢我们出色的社区——是你们让这一切成为可能!💪🔥
DeerFlow (Deep Exploration and Efficient Research Flow) is an open-source super agent harness that orchestrates sub-agents, memory, and sandboxes to do almost anything — powered by extensible skills. DeerFlow(深度探索与高效研究流程)是一个开源的超级智能体框架,它通过编排子智能体、记忆系统和沙箱环境,在可扩展技能的支持下,几乎可以完成任何任务。
Note
DeerFlow 2.0 is a ground-up rewrite. It shares no code with v1. If you’re looking for the original Deep Research framework, it’s maintained on the 1.x branch — contributions there are still welcome. Active development has moved to 2.0.
注意
DeerFlow 2.0 是从零开始重写的,与 v1 版本没有任何代码共享。如果您正在寻找最初的 Deep Research 框架,它目前在 1.x 分支进行维护——我们依然欢迎对该分支的贡献。目前的活跃开发已全部转向 2.0 版本。
Official Website
Learn more and see real demos on our official website.
官方网站
请访问我们的官方网站了解更多信息并查看实际演示。
Coding Plan from ByteDance Volcengine
We strongly recommend using Doubao-Seed-2.0-Code, DeepSeek v3.2 and Kimi 2.5 to run DeerFlow. Learn more. 中国大陆地区的开发者请点击这里。
来自字节跳动火山引擎的编码方案
我们强烈建议使用豆包-Seed-2.0-Code、DeepSeek v3.2 和 Kimi 2.5 来运行 DeerFlow。了解更多。中国大陆地区的开发者请点击这里。
InfoQuest
DeerFlow has newly integrated the intelligent search and crawling toolset independently developed by BytePlus—InfoQuest (supports free online experience).
InfoQuest
DeerFlow 新集成了由 BytePlus 自主研发的智能搜索与爬虫工具集——InfoQuest(支持免费在线体验)。
One-Line Agent Setup
If you use Claude Code, Codex, Cursor, Windsurf, or another coding agent, you can hand it the setup instructions in one sentence: Help me clone DeerFlow if needed, then bootstrap it for local development by following https://raw.githubusercontent.com/bytedance/deer-flow/main/Install.md That prompt is intended for coding agents. It tells the agent to clone the repo if needed, choose Docker when available, and stop with the exact next command plus any missing config the user still needs to provide.
一行指令配置智能体
如果您使用 Claude Code、Codex、Cursor、Windsurf 或其他编码智能体,您可以向它发送以下一行设置指令: Help me clone DeerFlow if needed, then bootstrap it for local development by following https://raw.githubusercontent.com/bytedance/deer-flow/main/Install.md 该提示词专为编码智能体设计。它会指示智能体在必要时克隆仓库,优先选择 Docker 部署,并在执行完下一步命令后停止,同时提示用户补充缺失的配置。
Quick Start Configuration
- Clone the DeerFlow repository:
git clone https://github.com/bytedance/deer-flow.gitthencd deer-flow - Run the setup wizard: From the project root directory (deer-flow/), run:
make setupThis launches an interactive wizard that guides you through choosing an LLM provider, optional web search, and execution/safety preferences such as sandbox mode, bash access, and file-write tools. It generates a minimalconfig.yamland writes your keys to.env. Takes about 2 minutes.
快速启动配置
- 克隆 DeerFlow 仓库:
git clone https://github.com/bytedance/deer-flow.git然后进入目录cd deer-flow - 运行设置向导:在项目根目录 (deer-flow/) 下运行:
make setup这将启动一个交互式向导,引导您选择大模型提供商、可选的网络搜索功能,以及执行/安全偏好设置(如沙箱模式、Bash 访问权限和文件写入工具)。它会生成一个最小化的config.yaml并将您的密钥写入.env文件。整个过程大约需要 2 分钟。
The wizard also lets you configure an optional web search provider, or skip it for now. Run make doctor at any time to verify your setup and get actionable fix hints.
向导还允许您配置可选的网络搜索提供商,或者暂时跳过。您可以随时运行 make doctor 来验证您的配置并获取可操作的修复建议。