Overview How It Works Features FAQ Get Started
#1 on GitHub Trending

An open-source super agent harness for anything

DeerFlow orchestrates sub-agents, memory, and sandboxes to do almost anything — powered by extensible skills. Built on LangGraph and LangChain.

72.8k
GitHub Stars
2.0
Latest Version
9.9k
Forks

From Deep Research to Super Agent Harness

DeerFlow started as a Deep Research framework. The community ran with it — building data pipelines, generating slide decks, spinning up dashboards. So we rebuilt it from scratch.

🧠

Skills & Tools

Skills are structured capability modules — Markdown files that define workflows, best practices, and resources. Loaded progressively, only when needed.

👥

Sub-Agents

The lead agent spawns sub-agents on the fly — each with scoped context, tools, and termination conditions. They run in parallel and report structured results.

💻

Sandbox & File System

Each task gets its own execution environment with a full filesystem view — skills, workspace, uploads, outputs. Shell execution runs inside isolated containers.

🤖

Long-Term Memory

Across sessions, DeerFlow builds persistent memory of your profile, preferences, and accumulated knowledge. Memory is stored locally under your control.

One harness, many hands

DeerFlow doesn't just talk about doing things. It has its own computer.

⚙️

Configure

Run the setup wizard to choose an LLM provider, web search, and execution preferences. Generates config.yaml in about 2 minutes.

🚀

Deploy

Choose Docker (recommended) or local development. One command to start — sandbox, gateway, frontend, all wired up.

🔍

Research

Send tasks via web UI, IM channels (Telegram, Slack, Feishu, WeChat), or Claude Code. Fan out into sub-agents automatically.

📊

Deliver

The lead agent synthesizes everything — reports, websites, slide decks, dashboards — into a coherent output.

Batteries included, fully extensible

DeerFlow 2.0 ships with everything an agent needs out of the box.

🧰 Skills & Tools

Built-in skills for research, report generation, slide creation, web pages, image and video generation. Extend with custom skills via MCP servers or Python functions.

🤖 Sub-Agents

Decompose complex tasks into parallel sub-agents, each with isolated context and tools. The lead agent synthesizes everything into a coherent output.

📦 Sandbox Execution

Local, Docker, or Kubernetes sandboxes. Isolated containers with full filesystem access — uploads, workspace, outputs.

💬 IM Channels

Receive tasks from Telegram, Slack, Feishu, DingTalk, WeChat, and WeCom. No public IP needed — all channels auto-start.

🧮 Context Engineering

Aggressive summarization, isolated sub-agent contexts, strict tool-call recovery. Stays sharp across long multi-step tasks.

📁 Long-Term Memory

Persistent memory across sessions. Your profile, preferences, and accumulated knowledge — stored locally, under your control.

Ready to run your own super agent?

Clone the repo, run one command, and hand the harness your first task. Docker recommended — two minutes to a running instance.

Get Started View the GitHub repo

Common questions

What is DeerFlow?

DeerFlow is an open-source super agent harness — a runtime that gives agents the infrastructure to get work done. It orchestrates sub-agents, memory, and sandboxes to handle tasks that take minutes to hours.

Who created DeerFlow?

DeerFlow is built by ByteDance and lives at github.com/bytedance/deer-flow. It claimed the #1 spot on GitHub Trending on February 28th, 2026.

What models does DeerFlow support?

DeerFlow is model-agnostic and works with any LLM that implements the OpenAI-compatible API. It performs best with models supporting long context windows (100k+ tokens) and strong tool-use capabilities.

What does "super agent harness" mean?

DeerFlow is not a framework you wire together — it's a harness. Batteries included: filesystem, memory, skills, sandbox-aware execution, and the ability to plan and spawn sub-agents for complex multi-step tasks.

How do I deploy DeerFlow?

Docker is the recommended deployment target. Run make up for production or make docker-start for development. The unified endpoint runs on port 2026.

Is DeerFlow secure for production use?

DeerFlow is designed for local trusted environments. For production, use IP allowlists, authentication gateways, and network isolation. See the Security Notice in the repo for detailed recommendations.