deepfund 的安装和配置教程

1. 项目基础介绍和主要编程语言

deepfund 是一个开源项目，旨在通过使用大型语言模型（LLM）来评估其在不同金融市场的交易能力。该项目允许LLM处理外部信息，驱动多代理系统，并做出交易决策。项目的主要编程语言是 Python。

2. 项目使用的关键技术和框架

该项目使用了以下关键技术和框架：

• Python：作为主要的编程语言。
• 大型语言模型（LLM）：例如 OpenAI、DeepSeek 等，用于分析金融数据。
• 数据库：使用 Supabase 或 SQLite 来存储和分析交易数据。
• Anaconda 或 uv：作为环境管理器，用于创建和管理虚拟环境。
• APIs：如 Alpha Vantage API 和 YFinance API，用于获取金融数据。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装之前，请确保您的系统中已经安装了以下软件：

• Python 3.x
• Git
• 安装环境管理器（Anaconda 或 uv）

安装步骤

步骤 1：克隆项目仓库

打开命令行（终端），执行以下命令克隆项目仓库：

git clone https://github.com/HKUSTDial/deepfund.git

步骤 2：创建虚拟环境

进入项目目录，根据您的环境管理器选择以下命令创建虚拟环境：

• 如果使用 Anaconda：

  conda env create -f environment.yml
  

• 如果使用 uv：

  uv sync
  

步骤 3：激活虚拟环境

• 对于 Anaconda 用户：

  source .venv/bin/activate
  

• 对于 uv 用户：

  .venv\Scripts\activate
  

步骤 4：设置环境变量

创建 .env 文件以存储您的 API 密钥（如 OpenAI、DeepSeek 等）：

cp .env.example .env

在 .env 文件中添加您的 API 密钥。

步骤 5：连接数据库

根据您的选择，可以选择以下两种数据库配置方式：

• 使用 Supabase：

  在 Supabase 官网上创建免费账户，并根据 src/database/supabase_setup.sql 创建表。更新 .env 文件中的 SUPABASE_URL 和 SUPABASE_KEY。

• 使用 SQLite：

  运行以下命令在 src 目录下创建 SQLite 数据库：

  cd src
  python database/sqlite_setup.py
  

步骤 6：运行项目

进入 src 目录，运行以下命令启动项目：

python main.py --config xxx.yaml --trading-date YYYY-MM-DD

其中 xxx.yaml 是您的配置文件名称，YYYY-MM-DD 是您要模拟的交易日期。

完成以上步骤后，您就可以开始使用 deepfund 项目了。如果遇到任何问题，请参考项目文档或向社区寻求帮助。