AI Hedge Fund 自建
1 个工作日起- 安装 Python 与工具链
- 安装 aihf 或克隆仓库
- 配置金融数据 API Key
- 配置 LLM API Key
- 确认市场代码并排查首次运行问题
国内普通技术用户建议至少预留 1 个工作日；镜像、端点或数据服务受限时可能需要更久。
AI Hedge Fund
AI Hedge Fund 自建：从安装到第一次研究
从安装 aihf、配置模型与数据，到第一次得到可阅读研究结果的完整流程，并比较 EasyClaw 的免自建路线。
Build time
从下载到第一次成功研究，时间花在哪里？
以下时间不是只打开命令，而是完成模型、数据和首次研究结果的完整链路。
EasyClaw
下载安装后即可开始- 下载安装 EasyClaw
- 打开股票研究入口
- 输入股票和研究问题
- 开始查看基础研究结果
不需要先搭建 AI Hedge Fund；专业数据服务仍可能需要另外连接和授权。
不想维护 Python、Docker 和多种密钥？
可以改走 EasyClaw 的独立股票研究路线，从一个明确问题开始，再按任务连接所需数据服务；下载安装不会自动运行 AI Hedge Fund。
Preflight
安装前检查
如果下面任一项还没有答案，先停在配置阶段，不要急着运行完整研究。
运行环境
- Python 3.10+ 或兼容环境
- pipx / uv / pip 可用
- 有权限创建环境与缓存目录
模型路线
- 选择云端 LLM 提供商
- 准备对应 API Key
- 确认模型额度与区域端点
数据路线
- 准备 Financial Datasets API Key
- 确认目标市场与代码格式
- 接受数据时效变化
Install
官方安装方式
项目官方 README 提供的安装命令（2026-08 抓取）。
Shellpipx install aihf
# 或 uv tool install aihf
# 或 pip install aihf
交互式应用
直接运行 aihf，进入交互式终端应用，选择股票、策略、再平衡周期。
非交互式运行
aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT 输出 JSON 记录和摘要。
回测模式
在命令后加 --backtest，在历史数据上回测基金。
版本提示：命令与参数随版本演进（当前抓取为 v2.2.0 相关文档），以官方 README 最新为准。
Verification
什么才算安装完成
安装验证只确认程序入口和依赖，不证明数据源、模型权限或研究输出已经可用。
命令可识别
aihf 能启动交互流程或显示帮助。
配置仍待完成
模型 API、数据源、市场代码和配额需要在下一步独立核验。
尚未运行研究
只有完成一次带标的、日期、来源和时间记录的调用，才属于运行证据。
Troubleshooting
常见安装问题
Python 版本满足但依赖仍冲突怎么办？
确认命令运行在独立虚拟环境中，并以当前 pyproject 为准。不要混用系统 Python、旧环境和不同锁定版本。
安装后 aihf 命令找不到怎么办？
确认 pipx/uv 的 bin 目录已加入 PATH；或改用 python -m aihf（视版本而定）运行。
国内镜像访问受限怎么办？
PyPI 可配置国内镜像源安装；LLM 提供商与金融数据服务的区域可访问性需单独确认。