deer-flow 是什么?

DeerFlow 2.0 是字节跳动开源的长任务 Agent harness,用 LangGraph 组织主 Agent、子 Agent、技能、长期记忆、沙箱与消息渠道。它面向研究、编码和内容生成等分钟到小时级任务,2.x 是与早期 Deep Research 版本不共享代码的重写。

⭐ 83,676 Stars 🍴 11,644 Forks Python MIT 作者: bytedance
来源:github.com/bytedance/deer-flow 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

当前正式 release 已到 v2.0.0,主分支又进入 2.1.0-rc0;安装命令、资源估算、Gateway 权限和 1.x/2.x 边界都与旧稿不同,需要按当前官方文档重写。

来源:github.com/bytedance/deer-flow/releases/tag/v2.0.0

核心功能

长任务与子 Agent

主 Agent 可按任务拆分子 Agent,并用 session goal、context compaction 和运行状态维持较长流程。

来源:github.com/bytedance/deer-flow
技能、工具与沙箱

技能提供可复用工作流,工具负责搜索、代码和文件操作;setup wizard 可配置 sandbox、bash 与 file-write 权限。

来源:github.com/bytedance/deer-flow
记忆与持久化

长期记忆和 thread/run 状态由后端保存;持久部署可选择 SQLite 或 PostgreSQL,并可选 Redis checkpoint cache。

来源:github.com/bytedance/deer-flow
Web、TUI 与消息渠道

同一运行时可从 Web UI、终端工作台及 Slack、Telegram、Discord、飞书、钉钉、微信、企业微信等渠道使用。

来源:github.com/bytedance/deer-flow/releases/tag/v2.0.0

技术架构

2.x 的 Gateway API 内含 LangGraph agent runtime,统一处理 thread、run、认证与工具调用;Next.js 前端经 nginx 访问 Gateway。沙箱可在本机进程、Docker AIO 或外部 provisioner 中运行,状态存入 SQLite/PostgreSQL,Redis cache 为可选性能层。模型和搜索 provider 由 config.yaml 引用 .env 中的密钥。

来源:github.com/bytedance/deer-flow/blob/main/frontend/src/content/en/appl…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Docker 与 Docker Compose 2.24+(推荐路径)Docker 与 Dock… 本地开发需要 Node.js 22+、pnpm、uv、nginx本地开发需要 No… 至少一个 LLM provider 或本地兼容端点至少一个 LLM pr… 本地评估建议 4 vCPU、8 GB RAM、20 GB SSD;长驻服务起点 8 vCPU、16 GB RAM、40 GB SSD本地评估建议 4… 长任务与子 Agent 技能、工具与沙箱 记忆与持久化 Web、TUI 与消息渠道 deer-flow 项目本体 核心功能 关键依赖

技术栈

语言Python 3.12+ 后端、TypeScript/Next.js 前端框架LangGraph、FastAPI、可插拔 sandbox/skills/tools
Docker 与 Docker Compose 2.24+(推荐路径)本地开发需要 Node.js 22+、pnpm、uv、nginx至少一个 LLM provider 或本地兼容端点本地评估建议 4 vCPU、8 GB RAM、20 GB SSD;长驻服…
Gateway、前端/nginx、数据库与按会话创建的沙箱;公开部署还需认证、反向代理和持久卷
来源:github.com/bytedance/deer-flow

快速上手

克隆仓库后运行 make setup,交互式选择模型、可选搜索服务以及 sandbox、bash、文件写入权限;它生成 config.yaml,并把密钥写到 .env。先执行 make doctor。Docker 开发路径再运行 make docker-init、make docker-start、make docker-logs;正式自建用 make up,并在 localhost:2026 检查。
来源:github.com/bytedance/deer-flow

使用场景

适合需要把研究、代码、报告或多媒体生成拆成子任务,并保留 thread、memory、skill 与沙箱记录的团队。先在仅回环地址运行一个不开放 bash/file-write 的短任务,核对模型成本与产物;确认权限后再增加写文件、定时任务、消息渠道或公网入口。

来源:github.com/bytedance/deer-flow

优势与局限

优势

  • 2.x 把子 Agent、记忆、沙箱、技能和多入口合在同一 harness
  • setup wizard 与 make doctor 给出可检查的配置路径
  • 官方明确列出本地、Docker 开发和长驻服务的资源起点
  • MIT 许可,支持自建模型端点和多种 provider

局限

  • 2.x 与 1.x 不共享代码,不能把旧 Deep Research 教程直接套用
  • 正式 release 是 v2.0.0,而主分支后端已标 2.1.0-rc0,按 main 部署会进入预发布状态
  • Gateway 管理员能注册 stdio MCP,官方明确视为等同主机代码执行
  • 公开部署若缺少认证和网络隔离,系统命令与文件读写能力可能被未授权调用
  • 模型、搜索、沙箱与多渠道集成会带来外部费用和密钥管理成本
来源:github.com/bytedance/deer-flow

最新版本

最新正式 release 是 v2.0.0,发布于 2026-06-25,标志 2.x 重写正式发布。当前 main 已继续到后端 2.1.0-rc0;生产部署应固定 v2.0.0 或经过审查的具体 commit,不能把 main 当稳定版。

来源:github.com/bytedance/deer-flow/releases/tag/v2.0.0

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、Install.md、部署文档、backend/pyproject.toml、MIT LICENSE 与 v2.0.0 release  |  limitations: 未克隆仓库,未执行 make setup/doctor/up,未启动模型、沙箱、Gateway、数据库或消息渠道,也未验证资源占用和权限隔离  |  observed_output: GitHub 最新正式 release 为 v2.0.0,发布于 2026-06-25;当前 main 的 backend/pyproject.toml 标记 2.1.0-rc0,要求 Python 3.12+

来源:github.com/bytedance/deer-flow/releases/tag/v2.0.0

同类项目对比

OpenHands Agent Canvas 是面向编码 Agent 与自动化的自托管控制中心,重点是 OpenHands、Claude Code、Codex 等 ACP Agent、项目目录与工程任务;DeerFlow 更强调通用长任务、skills、memory、sub-agent、内容生成和多消息渠道。主要目标是软件工程团队调度时先看 OpenHands;要把研究和内容流程也纳入同一 harness 时再评估 DeerFlow。

来源:github.com/OpenHands/OpenHands

总结评价

DeerFlow 2.0 适合确有长任务、多入口和沙箱需求的团队。先固定 v2.0.0,在本地回环地址用最小权限跑通一条短任务;公开服务前再处理管理员权限、认证、代理头、沙箱和持久化。

来源:github.com/bytedance/deer-flow

常见问题

DeerFlow 2.0 能直接使用 1.x 的配置和教程吗?

不能直接套用。官方说明 2.0 是完全重写,与 1.x 不共享代码;旧版在单独分支维护。

DeerFlow 当前版本到底是 2.0.0 还是 2.1.0-rc0?

最新正式 release 是 v2.0.0;当前 main 分支的后端包已标为 2.1.0-rc0。生产评估应固定 tag 或具体 commit。

2 核 4 GB 能跑 DeerFlow 2.0 吗?

官方写明通常不够。本地评估起点是 4 vCPU、8 GB RAM、20 GB SSD,长驻服务起点是 8 vCPU、16 GB RAM、40 GB SSD。

DeerFlow 的 Gateway 管理员只是普通管理权限吗?

不是。管理员可注册并启动 stdio MCP,官方要求将 Gateway admin 视为主机代码执行权限。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件