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
PythonMITCreated 2025-05-07deerflow.tech
Download: DeerFlow 2.2.0DeerFlow-2.2.0 ↓2.2.02026-11-04
+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

Discussions

Latest release

DeerFlow 2.2.0 v2.2.0 2026-11-04
DeerFlow 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

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
5 morenoteByteDance의 AI 에이전트 기반 'DeerFlow 2.0'이 대단하다——조사하고 직접 써보며 알게 된 점2026-03-22xGitHub - bytedance/deer-flow: DeerFlow is a community-driven framework for deep research, combining language models with tools like web search, crawling, and Python execution ...2025-05-12Pasquale Pillitteri10 Open-Source AI Agent Frameworks to Automate Your Work in 20262026-04-27SitePointDeer-Flow Deep Dive: Managing Long-Running Autonomous Tasks2026-03-02TheSequence | Jesus RodriguezThe Sequence Engineering #661: Create Your Own Deep Research Agent with DeerFlow2025-06-11

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON