DeepFund 项目启动与配置教程

1. 项目的目录结构及介绍

DeepFund 项目的目录结构如下所示：

deepfund/
├── src/
│   ├── main.py                   # 主入口文件
│   ├── agents/                   # 代理构建和注册目录
│   ├── apis/                     # 外部金融数据APIs
│   ├── config/                   # 配置文件目录
│   ├── database/                 # 数据库设置和助手
│   ├── example/                  # 期望输出示例
│   ├── graph/                    # 工作流、提示和模式目录
│   ├── llm/                      # 语言模型提供者
│   ├── util/                     # 实用函数和助手
├── environment.yml               # Conda环境配置文件
├── README.md                     # 项目文档
├── ...

• src/: 源代码目录，包含项目的所有Python代码。
• agents/: 代理模块，负责构建和注册不同的分析代理。
• apis/: API接口，用于从外部金融数据源获取数据。
• config/: 配置文件，包含项目运行所需的配置信息。
• database/: 数据库相关设置和工具，用于存储和分析交易数据。
• example/: 输出示例，提供项目输出结果的参考。
• graph/: 工作流和提示定义，以及模式相关的代码。
• llm/: 语言模型模块，包含与语言模型提供者相关的代码。
• util/: 实用工具模块，提供项目中常用的工具函数。

2. 项目的启动文件介绍

项目的启动文件为 src/main.py。这是项目的主入口点，用于初始化和运行整个DeepFund系统。以下是 main.py 文件的主要功能：

• 解析命令行参数，包括配置文件路径和交易日期等。
• 根据配置文件设置，初始化数据库连接。
• 加载和配置工作流中的分析代理。
• 执行交易决策流程，并记录相关的交易决策。
• 启动数据分析，并将结果存储在数据库中。

3. 项目的配置文件介绍

项目的配置文件位于 src/config/ 目录下。这些文件包含项目运行所需的各种配置信息。以下是一些主要的配置文件：

• config_template.yaml: 配置模板，包含了所有的配置选项和说明，用于创建具体的实验配置文件。
• xxx.yaml: 实验配置文件，用于特定实验的配置。其中 xxx 应当由用户替换为唯一的实验名称。

配置文件通常包含以下内容：

• exp_name: 实验名称，用于标识每次实验。
• tickers: 股票代码列表，用于指定分析的目标股票。
• planner_mode: 计划模式，用于确定是否由计划代理来协调分析代理的工作流。
• workflow_analysts: 工作流分析代理，列出了参与决策的分析代理名称。
• llm: 语言模型设置，包括模型提供者和模型名称。

在运行项目之前，用户需要根据具体需求修改配置文件，并确保所有配置都是正确的。