02. 快速开始：先把 DeerFlow 跑起来

这一篇只做一件事

先把 DeerFlow 跑起来。

不要一上来读源码。Agent 框架目录很多，先跑通一次，后面看架构和源码才有参照。

先准备环境

官方仓库是一个前后端一起工作的项目。你至少需要准备：

Git
Python / uv
Node.js / pnpm
Docker，可选但建议装

如果你只想先看界面，本地开发模式就够。如果后面要试 sandbox、MCP 或长期运行，Docker 会更稳。

拉代码

git clone https://github.com/bytedance/deer-flow.git
cd deer-flow

后面的命令都默认在仓库根目录执行。

安装依赖

官方仓库提供了 Makefile。优先看当前 README 和 Makefile，不要从旧博客里复制命令。

通常可以从这一步开始：

make setup

如果这一步失败，先不要急着改代码。先确认：

python --version
node --version
pnpm --version
uv --version

大多数快速开始问题都出在环境版本或包管理器没装好。

配置模型

DeerFlow 不是内置模型。它需要你配置 provider、model、api key、base url 等信息。

官方配置样例在：

config.example.yaml

建议做法：

cp config.example.yaml config.yaml

然后只改你要用的 provider。不要一上来把所有 provider 都填满。

配置搜索能力

研究型 Agent 离不开搜索和抓取。DeerFlow 支持搜索相关配置，具体字段以 config.example.yaml 为准。

第一轮只要做到：

模型能调用
搜索能返回结果
页面能看到一次任务的输出

不要在快速开始阶段同时接 MCP、Memory、tracing。变量太多，出问题不好排。

启动本地开发

常见路径是：

make dev

如果你拆开启动，也要分别确认：

后端服务起来了
前端页面能打开
前端能连到后端
一次任务能创建 run

看日志时重点盯三类错误：

配置没读到
provider 调用失败
前端请求后端失败

跑通第一个任务

第一个任务不要太复杂。

可以问一个轻量研究问题，例如：

总结一下 DeerFlow 这个项目解决什么问题，并给出三个适合继续学习的方向。

不要一开始就让它写长报告、接外部系统或执行复杂代码。

跑通的标准

这一篇的完成标准很简单：

• 页面能打开；
• 后端没有启动错误；
• 模型调用成功；
• 搜索或工具能力至少有一个能正常返回；
• 能看到一次任务从输入到输出的完整过程。

做到这里就够了。

下一篇再看配置文件。配置看懂以后，再谈架构和源码。