## 项目概述

AI Hedge Fund 是一个基于人工智能的对冲基金概念验证项目，旨在探索利用 AI 进行交易决策。该项目仅用于教育和研究目的，不用于真实交易或投资。项目正在演进为一个持久化、始终在线的 AI 对冲基金，支持回测、模拟交易和（可选）实盘运行，并将投资者代理重新构想为可插拔、可回测的“alpha 模型”。

## 核心功能

- 交互式终端应用：构建基金（选择股票、策略、再平衡周期），回测已保存的基金并绘制权益曲线。
- 非交互式运行：从授权文件（mandate file）运行一个基金周期，输出完整周期记录的 JSON 和人类可读摘要。
- 回测功能：按再平衡周期对历史数据进行回测。
- 支持多种 LLM 提供商：Anthropic、OpenAI、DeepSeek、Google、xAI、Kimi。
- 自动保存 API 密钥到 `~/.hedge-fund/.env`，无需预先配置。

## 适用与不适用场景

**适用场景：**
- 教育用途：学习 AI 在金融决策中的应用。
- 研究用途：探索 AI 驱动的交易策略。
- 模拟交易和回测：在无风险环境中测试策略。

**不适用场景：**
- 真实交易或投资：项目明确声明不用于真实交易，且系统实际上不会执行任何交易。
- 投资建议：不提供任何投资建议或保证。
- 生产环境：作为概念验证，不适合直接用于生产环境。

## 技术架构与依赖

- 语言：Python
- 包管理：使用 Poetry 进行开发，可通过 pipx、uv 或 pip 安装。
- 外部依赖：
  - Financial Datasets API（用于价格、基本面、收益数据）
  - 至少一个 LLM API（Anthropic、OpenAI、DeepSeek、Google、xAI、Kimi）
- 架构：基金作为一级实体，支持回测、模拟交易和可选实盘；投资者代理作为可插拔的 alpha 模型。

## 安装与快速开始

### 安装

```bash
pipx install aihf
```

或使用 `uv tool install aihf`，或 `pip install aihf` 到任意环境。

### 快速开始

运行交互式应用：

```bash
aihf
```

首次需要 API 密钥时，应用会提示输入并保存到 `~/.hedge-fund/.env`。需要 Financial Datasets API 密钥和一个 LLM API 密钥。

## 典型使用方法

### 交互式应用

```bash
aihf
```

构建基金，选择股票、策略、再平衡周期，或回测已保存的基金。基金保存为 `~/.hedge-fund/mandates/` 下的授权文件。

### 非交互式运行

从授权文件运行一个基金周期：

```bash
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT
```

回测授权文件：

```bash
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT --backtest
```

授权文件定义策略、人员、风险、资本和节奏，不指定股票；`--tickers` 指定本次运行的股票。

## 配置与部署要点

- API 密钥：首次使用时提示输入，保存到 `~/.hedge-fund/.env`。环境变量中导出的密钥优先于保存的文件。
- 授权文件：基金配置保存在 `~/.hedge-fund/mandates/` 下，可重复使用。
- 开发环境：克隆仓库后使用 Poetry 安装依赖，运行测试：

```bash
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
poetry install
poetry run aihf
poetry run pytest hedge_fund
```

## 限制、风险与许可证

- **限制**：项目为概念验证，不执行真实交易；仅用于教育和研究。
- **风险**：不提供投资建议或保证；创建者不对财务损失承担责任；过去的表现不代表未来结果。
- **许可证**：MIT License（详见 LICENSE 文件）。

## 官方链接

- GitHub 仓库：https://github.com/virattt/ai-hedge-fund
- 最新版本：v2.2.0（发布于 2026-08-07）
- 发布页面：https://github.com/virattt/ai-hedge-fund/releases/tag/v2.2.0

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README（https://github.com/virattt/ai-hedge-fund）
- 分析时间：2026-08-07（基于最新发布信息）