AI Hedge Fund：AI 驱动的对冲基金团队概念验证（virattt/ai-hedge-fund）
AI Hedge Fund 是一个用于探索“用 AI 做交易决策”的概念验证项目，作者 virattt，采用 MIT 许可证。项目定位为教育与研究用途，明确声明不进行真实交易、不提供投资建议。当前项目正在重构为持久化、常驻运行的 AI 对冲基金（fund 作为一等实体，可回测、可纸面交易、可选择性实盘），投资者 Agent 被重新设计为可插拔、可回测的 alpha 模型。安装方式为 pipx/uv/pip 安装 aihf，运行 aihf 启动交互式终端应用，或通过 mandate 文件加 --tickers 做非交互式单周期运行与历史回测。
社区作者 · zZz
它解决什么问题
项目名称：AI Hedge Fund（GitHub: virattt/ai-hedge-fund）。
一、项目定位 这是一个 AI 驱动的对冲基金的概念验证（proof of concept），目标是探索使用 AI 进行交易决策。项目仅用于教育目的，不用于真实交易或投资。
二、重构方向 项目仍在演进中。作者正在把它重建为一个持久化、常驻运行的 AI 对冲基金——一个作为一等实体存在的 fund，可以回测、纸面交易（paper-trade），以及在用户主动选择（opt-in）的情况下实盘运行；投资者 Agent 被重新构想为可插拔、可回测的“alpha models”。页面提供 Vision 与 Roadmap 两个进一步说明入口。
三、重要说明 系统实际上不会执行任何交易。
四、免责声明（要点）
- 仅用于教育与研究目的。
- 不用于真实交易或投资。
- 不提供投资建议，不作任何保证。
- 创作者不对财务损失承担责任。
- 投资决策请咨询财务顾问。
- 历史表现不代表未来结果。
- 使用本软件即表示同意仅将其用于学习目的。
五、核心用法概念
- 交互式应用：不带参数运行 aihf，进入交互式终端应用，可构建一个基金（选择股票、策略、再平衡频率），或对已保存的基金进行回测，并把其净值曲线与基准对照绘制。构建好的基金会以 mandate 文件形式保存到 ~/.hedge-fund/mandates/。
- 非交互式：从 mandate 文件运行一个基金周期，完整周期记录以 JSON 打印到 stdout，简短的人类可读摘要输出到 stderr。
- 回测：按 mandate 的再平衡频率在历史数据上回测。
- mandate 与 tickers 的关系：mandate 描述的是“交易台”——策略、人员、风险、资金、节奏，从不指定具体标的；--tickers 用于指定本次运行的标的。
- 模型可切换：可为投资者 Agent 指定模型，例如配置 TYPESAFE_API_KEY 后使用 --model jev-1.13.0。支持的模型提供方包括 Anthropic、OpenAI、DeepSeek、Google、xAI、Kimi、TypeSafe (Jev)。
六、数据与密钥 需要 Financial Datasets API key 用于价格、基本面与财报数据；另需一个模型 API key 供投资者 Agent 使用。应用在首次需要密钥时询问并保存到 ~/.hedge-fund/.env，无需提前配置；在 shell 中导出的密钥优先级高于已保存的文件。
七、贡献方式 Fork 仓库 → 创建特性分支 → 提交更改 → 推送到分支 → 创建 Pull Request。作者强调 PR 要小而聚焦，便于评审与合并；功能请求请开 issue 并打上 enhancement 标签。
八、许可证 本项目采用 MIT License，详见仓库中的 LICENSE 文件。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、安装（三种方式任选其一）
- 推荐方式：pipx install aihf
步骤 2 · 或使用 uv：
uv tool install aihf步骤 3 · 或安装到你自选的环境中：
pip install aihf安装完成后可在任意目录运行：aihf
二、API Key 配置
- 应用会在首次需要密钥时主动询问，并保存到 ~/.hedge-fund/.env，无需预先配置。
- 需要的密钥有两类：
- Financial Datasets API key：用于价格、基本面与财报数据。
- 一个模型 API key：供投资者 Agent 使用。支持的提供方：Anthropic、OpenAI、DeepSeek、Google、xAI、Kimi、TypeSafe (Jev)。
- 在 shell 中导出的密钥始终优先于已保存的 .env 文件。
三、运行方式
aihf 不带参数运行会启动交互式终端应用。可构建基金（选择股票、策略、再平衡频率），或对已保存的基金做回测，并观察其净值曲线与基准的对比绘制。构建的基金会以 mandate 文件保存到 ~/.hedge-fund/mandates/。
- 交互式应用：
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT 完整周期记录以 JSON 打印到 stdout，简短的人类可读摘要输出到 stderr。
- 非交互式（从 mandate 文件跑一个基金周期）：
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT --model jev-1.13.0
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT --backtest
- 指定模型运行（先配置 TYPESAFE_API_KEY）：
- 回测（按 mandate 的再平衡频率在历史数据上回测）：
- 关键概念：mandate 是“交易台”（策略、人员、风险、资金、节奏），从不包含股票代码；--tickers 指明本次运行要指向哪些标的。
四、开发模式安装与运行
- 克隆仓库：
git clone https://github.com/virattt/ai-hedge-fund.git- 进入目录：
cd ai-hedge-fundpoetry install
poetry run aihf
poetry run pytest hedge_fund
- 安装依赖：
- 运行应用：
- 运行测试：
五、常见问题
- 需要提前准备 API Key 吗？不需要，首次使用时应用会询问并自动保存到 ~/.hedge-fund/.env。
- shell 环境变量与 .env 冲突怎么办？shell 中导出的密钥优先级更高。
- 为什么命令里既有 mandate 又有 --tickers？mandate 定义交易台与策略、不含标的，--tickers 指定本次运行标的。
- 会真实下单吗？不会，系统不会实际执行任何交易。
- 首次上手建议路径？先 pipx install aihf → 运行 aihf 进入交互式应用构建或选择基金 → 再用非交互式命令配 --backtest 验证历史表现。