Auto-Deep-Research

环境要求

• 已安装 Conda（用 conda 创建 Python 环境）
• Python 3.10（conda create 指定版本）
• 已安装 Docker（智能体交互环境使用 Docker 容器化）
• 准备所需 LLM 的 API Key（按需，非全部必需）

安装与启动步骤

1. 1创建 Conda 环境

   用 conda 新建名为 auto_deep_research 的环境，Python 版本固定为 3.10，与项目要求一致。

   conda create -n auto_deep_research python=3.10

   复制

2. 2激活环境

   激活刚创建的环境，后续所有安装与运行命令都要在该环境中执行，避免依赖冲突。

   conda activate auto_deep_research

   复制

3. 3克隆项目仓库

   从 GitHub 拉取 Auto-Deep-Research 源码到本地当前目录。

   git clone https://github.com/HKUDS/Auto-Deep-Research.git

   复制

4. 4安装项目依赖

   进入项目目录后以可编辑模式安装，README 中的安装方式即为 pip install -e .。

   cd Auto-Deep-Research
   pip install -e .

   复制

5. 5安装 Docker

   README 要求先自行安装 Docker，用于容器化智能体交互环境；无需手动拉取镜像，程序会按机器架构自动拉取预构建镜像。

6. 6配置 API Key

   参照项目中的 .env.template 创建环境变量文件（如 .env），按需填入你要使用的 LLM 的 API Key，不需要全部配置。

关键配置

如何确认成功

pip install -e . 执行无报错即安装完成；README 节选中未给出启动命令，请按官方文档的 Start 章节启动验证。

常见问题

注意事项

• 请先安装 Docker，不要手动拉取镜像，程序会自动按机器架构拉取预构建镜像。
• API Key 不是全部必填，按实际使用的 LLM 配置，写入参照 .env.template 创建的环境变量文件中。
• README 节选未包含启动命令与端口等信息，启动前建议查阅官方文档。
• 建议始终在 auto_deep_research 这个 conda 环境中执行安装与运行命令。