bytedance/deer-flow

★ 84,636⑂ 11,865

An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway

About bytedance/deer-flow

bytedance/deer-flow is an open-source project on GitHub, mainly written in Python. An open-source long-horizon SuperAgent harness that researches, codes, and creates. It currently holds 84,636 stars and 11,865 forks with 988 open issues, and was last pushed on 2026-10-29 (repository created 2025-05-07).

Project Overview

Git Homed tracks it on the AI Agent Skills Trending board and on the AI AI Agent Skills Trending list.

GitHub Repository Details

Repository bytedance/deer-flow · default branch main · size 98081 KB · watchers 330 · source: GitHub REST API and repository README

README

English | 中文 | 日本語 | Français | Русский | Português | 한국어

Python Node.js License: MIT

https://github.com/bytedance/deer-flow/blob/HEAD/bytedance%2Fdeer-flow | Trendshift

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

https://github.com/bytedance/deer-flow/blob/HEAD/image

Coding Plan from ByteDance Volcengine

InfoQuest

DeerFlow has newly integrated the intelligent search and crawling toolset independently developed by BytePlus — InfoQuest (supports free online experience)

https://github.com/bytedance/deer-flow/blob/HEAD/InfoQuest_banner

---

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.

Quick Start

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:

# Docker
make docker-init    # pull the sandbox image (once, or when the image updates)
make docker-start   # start services
# 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.

From Deep Research to Super Agent Harness

DeerFlow started as a Deep Research framework — and the community ran with it. Since launch, developers have pushed it far beyond research: building data pipelines, generating slide decks, spinning up dashboards, automating content workflows. Things we never anticipated.

That told us something important: DeerFlow wasn't just a research tool. It was a harness — a runtime that gives agents the infrastructure to actually get work done.

So we rebuilt it from scratch.

DeerFlow 2.0 is no longer a framework you wire together. It's a super agent harness — batteries included, fully extensible. Built on LangGraph and LangChain, it ships with everything an agent needs out of the box: a filesystem, memory, skills, sandbox-aware execution, and the ability to plan and spawn sub-agents for complex, multi-step tasks.

Use it as-is. Or tear it apart and make it yours.

Guides

Each guide is the full reference for its topic. Open the one you need.

| Topic | Guide | | --- | --- | | Models, providers, config.yaml, environment variables | Configuration | | Docker, local development, upgrades, production deployment | Running the Application | | Sandbox modes, file system, uploads and outputs | Sandbox | | Skills, built-in tools, script workflows, Claude Code integration | Skills & Tools | | MCP servers | MCP Server | | Sub-agents and task delegation | Sub-Agents, Tool restrictions | | Long-term memory | Long-Term Memory | | Session goals, context compaction, task notes, evidence-based decisions | Context, Goals and Agent Decisions | | Private knowledge retrieval (RAGFlow) | Private Knowledge Retrieval | | Agentic browser control | Agentic Browser Control | | Projects, instructions, document shelf | Projects | | Scheduled tasks | Scheduled Tasks | | Feishu, Slack, Telegram, Discord, DingTalk and other IM channels | IM Channels | | File attachments, downloads and Office previews | File Previews | | Token usage dashboard, workspace, chat archive | Workspace UI | | Terminal workbench | Terminal Workbench (TUI) | | Personal access tokens, stream actions, embedded Python client | API Access and Python Client | | Trace correlation, LangSmith, Langfuse, Monocle | Tracing and Observability | | Deployment risks, admin model, security recommendations | Security Notice |

Recommended Models

DeerFlow is model-agnostic — it works with any LLM that implements the OpenAI-compatible API. That said, it performs best with models that support:

More Documentation

⚠️ Security Notice

DeerFlow can execute commands and read and write files. It is designed to run in a local trusted environment, and a Gateway admin account is equivalent to code execution on the host. Before you deploy it on a server or expose it to a network, read the full Security Notice and SECURITY.md.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for development setup, workflow, and guidelines.

License

This project is open source and available under the MIT License.

Acknowledgments

DeerFlow is built upon the incredible work of the open-source community. We are deeply grateful to all the projects and contributors whose efforts have made DeerFlow possible. Truly, we stand on the shoulders of giants.

We would like to extend our sincere appreciation to the following projects for their invaluable contributions:

These projects exemplify the transformative power of open-source collaboration, and we are proud to build upon their foundations.

Key Contributors

A heartfelt thank you goes out to the core authors of DeerFlow, whose vision, passion, and dedication have brought this project to life:

Your unwavering commitment and expertise have been the driving force behind DeerFlow's success. We are honored to have you at the helm of this journey.

Star History

Star History Chart

GitHub Stars & Activity

84,636Stars
11,865Forks
988Open issues
PythonLanguage

GitHub Popularity

GitHub stars84,636
Forks11,865
Open issues988
Primary languagePython
LicenseMIT
Stars gained today0
Created2025-05-07
Last pushed2026-10-29

Trending History

Trending statusnot on today's boards

Related GitHub Projects

1

NousResearch / hermes-agent

Python★ 264,057⑂ 0
→
2

anthropics / skills

Python★ 196,375⑂ 0
→
3
→
4

langchain-ai / langchain

Python★ 149,759⑂ 0
→
5

Graphify-Labs / graphify

Python★ 149,281⑂ 0
→
6

browser-use / browser-use

Python★ 121,280⑂ 0
→
7

Panniantong / Agent-Reach

Python★ 112,540⑂ 0
→
8

unclecode / crawl4ai

Python★ 87,467⑂ 0
→

More Trending Repositories