virattt ai-hedge-fund

AI Hedge Fund

这是一个AI驱动对冲基金的概念验证项目。该项目旨在探索利用人工智能进行交易决策。本项目仅用于教育目的，不适用于真实交易或投资。

🚧 项目正在演进中。我们正在将其重建为一个持久运行的、始终在线的AI对冲基金——一个作为一级实体的基金，你可以对其进行回测、模拟交易，以及（可选）实盘运行，同时将投资者代理重新构想为可插拔、可回测的“阿尔法模型”。阅读愿景 → 和路线图 →。

该系统由多个代理协同工作：

• Aswath Damodaran 代理 - 估值院长，专注于故事、数字和严谨的估值
• Ben Graham 代理 - 价值投资之父，只买入具有安全边际的隐藏瑰宝
• Bill Ackman 代理 - 激进投资者，采取大胆头寸并推动变革
• Cathie Wood 代理 - 成长投资女王，相信创新与颠覆的力量
• Charlie Munger 代理 - 沃伦·巴菲特的合伙人，只以合理价格买入优秀企业
• Michael Burry 代理 - 《大空头》中的逆向投资者，猎寻深度价值
• Mohnish Pabrai 代理 - Dhandho 投资者，寻找低风险翻倍机会
• Nassim Taleb 代理 - 黑天鹅风险分析师，专注于尾部风险、反脆弱性和非对称收益
• Peter Lynch 代理 - 务实的投资者，在日常业务中寻找“十倍股”
• Phil Fisher 代理 - 严谨的成长投资者，运用深入的“小道消息”研究
• Rakesh Jhunjhunwala 代理 - 印度大牛
• Stanley Druckenmiller 代理 - 宏观传奇，猎寻具有增长潜力的非对称机会
• Warren Buffett 代理 - 奥马哈先知，寻求以合理价格买入优秀公司
• 估值代理 - 计算股票的内在价值并生成交易信号
• 情绪代理 - 分析市场情绪并生成交易信号
• 基本面代理 - 分析基本面数据并生成交易信号
• 技术面代理 - 分析技术指标并生成交易信号
• 风险管理者 - 计算风险指标并设置头寸限制
• 投资组合管理者 - 做出最终交易决策并生成订单

注意：该系统实际上不会进行任何交易。

免责声明 本项目仅用于教育和研究目的。不适用于真实交易或投资。不提供任何投资建议或保证。创建者不对任何财务损失承担责任。请咨询财务顾问进行投资决策。过往表现不代表未来结果。使用本软件即表示您同意仅将其用于学习目的。

目录

• 如何安装
• 如何运行
• ⌨️ 命令行界面
• 🖥️ 网页应用
• 如何贡献
• 功能请求
• 许可证

如何安装

在运行 AI Hedge Fund 之前，您需要安装它并设置您的 API 密钥。这些步骤对于全栈网页应用和命令行界面都是通用的。

1. 克隆仓库

git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund

2. 设置 API 密钥

为您的 API 密钥创建一个 .env 文件：

# 为您的 API 密钥创建 .env 文件（在根目录下）
cp .env.example .env

打开并编辑 .env 文件以添加您的 API 密钥：

# 用于运行由 openai 托管的 LLM（gpt-4o、gpt-4o-mini 等）
OPENAI_API_KEY=your-openai-api-key

# 用于获取金融数据以驱动对冲基金
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

重要提示：您必须至少设置一个 LLM API 密钥（例如 OPENAI_API_KEY、GROQ_API_KEY、ANTHROPIC_API_KEY 或 DEEPSEEK_API_KEY），对冲基金才能运行。

如何运行

⌨️ 命令行界面

您可以直接通过终端运行 AI Hedge Fund。这种方法提供更精细的控制，适用于自动化、脚本编写和集成目的。

快速开始

安装 Poetry（如果尚未安装）：

curl -sSL https://install.python-poetry.org | python3 -

安装依赖项：

poetry install

运行 AI Hedge Fund：

poetry run python src/main.py --ticker AAPL,MSFT,NVDA

您还可以指定 --ollama 标志，使用本地 LLM 运行 AI Hedge Fund：

poetry run python src/main.py --ticker AAPL,MSFT,NVDA --ollama

您可以选择指定开始和结束日期，以便在特定时间段内做出决策：

poetry run python src/main.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01

运行回测器

poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA

示例输出：

注意：--ollama、--start-date 和 --end-date 标志同样适用于回测器！

🖥️ 网页应用

运行 AI Hedge Fund 的新方式是通过我们的网页应用，它提供了用户友好的界面。对于偏好可视化界面而非命令行工具的用户，推荐使用此方式。

请在此处查看如何安装和运行网页应用的详细说明。

如何贡献

1. Fork 仓库
2. 创建功能分支
3. 提交您的更改
4. 推送到分支
5. 创建 Pull Request

重要提示：请保持您的 pull request 小而精。这将使审查和合并更加容易。

功能请求

如果您有功能请求，请创建一个 issue，并确保其标记为 enhancement。

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。