bytedance /deer-flow
An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.
★ 85,368⑂ 12,031👁 332⑃ 5,326● 2,678▤ 3
More from this author
+27
Daily
+198
Weekly
+1,614
Monthly
85,368
stars
12,031
forks
332
watchers
5,326
prs
2,678
issues
3
releases
README
English | 中文 | 日本語 | Français | Русский | Português | 한국어 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! 💪🔥 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. https://github.com/user-attachments/assets/a8bcadc4-e040-4cf2-8fda-dd768b999c18 [!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. Official Website Learn more and see real demos on our official website. The landing-page case studies open as allowlisted, read-only showcases without requiring a sign-in. Sister Projects - LLM Space - Meet our secret weapon behind DeerFlow — one desktop tool to prototype agent ideas, inspect each harness step, replay failures, and benchmark performance. 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 - 中国大陆地区的开发者请点击这里 InfoQuest DeerFlow has newly integrated the intelligent search and crawling toolset independently developed by BytePlus — InfoQuest (supports free online experience) --- 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: text 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. Quick Start bash git clone https://github.com/bytedance/deer-flow.git cd deer-flow make setup interactive wizard: writes config.yaml and .env (about 2 minutes) Then start DeerFlow with Docker (recommended) or run it locally: bash Docker make docker-init pull the sandbox image (once, or when the image updates) make docker-start start services bash Local development make check verifies Node.js 22+, pnpm, uv, nginx make install make dev The local commands use the pnpm version pinned in frontend/package.json. If a different global pnpm is on PATH, they use Corepack when available; otherwise they report the version mismatch before installing frontend dependencies. Run make doctor after setting model credentials. It reports obvious placeholder API keys as incomplete configuration; replace them with real keys before testing model calls. Open http://localhost:2026. - All configuration options, providers and manual setup: Configurati
Top issues
#1156有没有人建个QQ群互相讨论的?没有的话我临时创建一个,Q群号:71172934740 comments · 2026-03-16#1669RoadMap of DeerFlow Q230 comments · 2026-03-31#6269Feature: 统一 DeerFlow Knowledge 能力层,并接入 WeKnora22 comments · 2026-10-04#819DeerFlow 2.0 wish list, 你们希望有哪些功能?22 comments · 2026-01-17#1415按照文档接入飞书后无法使用19 comments · 2026-03-26#4680[feat] 多智能体协同:lead_agent可以调度custom agent吗?因为大部分人观念里面,我创建了一个custom agent后应该可以由主智能体调度的17 comments · 2026-08-04#4189Checkpoint storage still grows: residual base64 in messages, multi-instance storage, retention policy, large tool results17 comments · 2026-07-15#74MCP 工具无法调起,如何强制调起外部的 MCP server 服务来进行服务16 comments · 2025-05-12
Discussions
#8238[RFC] Lightweight Linux sandbox backend using bubblewrap + cgroup v2 for non-K8s / non-container deployments0 comments · 2026-11-14#8217Chopper: a small open model that cuts only the needed sentences out of retrieved text0 comments · 2026-11-13#8201Proposal: boxd as an optional community sandbox provider0 comments · 2026-11-12#8044DeerFlow 2.x: a generic OpenAI-compatible model entry in config.yaml (ChatOpenAI + base_url), with context_window, retries and capability flags explained0 comments · 2026-11-09#7970Tool-level idempotency registry for recovered tool executions — is this worth building?1 comments · 2026-11-07#7896DeerFlow 2.2.00 comments · 2026-11-04#7895[Proposal] Adaptive Ephemeral Tool Output Pruning in SummarizationMiddleware for Long-Horizon Agent Runs4 comments · 2026-11-04#7880建议将 examples 下的扩展统一迁移至 deer-flow 组织管理1 comments · 2026-11-04
Latest release
DeerFlow 2.2.0 v2.2.0 2026-11-04DeerFlow 2.2.0 DeerFlow 2.2 turns the 2.1 super-agent harness into a deployment-grade platform with a focus on operating at scale and delegating with trust: scheduled tasks grow into goal-driven workflows with fair multi-owner execution, every subsystem from IM channels to workflows runs across multiple Gateway instances, the extension platform ships full-stack plugins, knowledge retrieval becomes provider-independent with verifiable citations, and models, memory and channels gain production-grade management — hardened by fail-closed defaults, at-rest credential encryption, and a muc
相关报道 (7)
blog.csdn【GitHub项目推荐--DeerFlow:社区驱动的深度研究框架完全指南】2025-09-1953aiDeerFlow:手把手教你把字节开源的GitHub深度研究项目部署到本地2025-05-22Pasquale Pillitteri2026年自动化工作的10个开源AI智能体框架2026-04-26智源社区字节版龙虾架构火爆GitHub!开源获35k+ Star,内置Skill全家桶,原生适配飞书2026-03-24InfoQ.cn从AI Agent到Agentic AI:开源如何助力开发者解决行业痛点?2025-06-2553AI字节DeerFlow深度解析:下一代AI研究助理,还是又一个Agent框架?2025-06-15InfoQ.cn字节跳动 Deep Research 项目正式开源:基于 LangStack,支持 MCP 无缝集成2025-05-16
News & coverage (15)
Hacker NewsHas Anyone Tried Deerflow?▲ 4 · 0 comments · 2026-03-27Hacker NewsDeerFlow, a community-driven Deep Research framework▲ 4 · 0 comments · 2025-05-12Hacker NewsDeer-Flow Installing Line▲ 3 · 1 comments · 2026-03-30Hacker NewsDeep Exploration and Efficient Research Flow▲ 2 · 0 comments · 2026-03-16Hacker NewsDeerFlow 2.0: open-source SuperAgent harness that researches, codes, creates▲ 2 · 0 comments · 2026-03-15Hacker NewsDeerFlow: Deep Research Framework▲ 2 · 0 comments · 2025-05-13Hacker NewsDeerFlow 2.0 – Deep Exploration and Efficient Research Flow▲ 1 · 0 comments · 2026-05-18Hacker NewsAn open-source long-horizon SuperAgent harness that researches,codes and creates▲ 1 · 1 comments · 2026-04-18pandailyByteDance Open-Sources Deer-Flow 2.0, Tops GitHub Trending2026-03-22noteByteDance's AI Agent Infrastructure 'DeerFlow 2.0' is Amazing—What I Learned by Researching and Trying It Out2026-03-22