virattt/ai-hedge-fund
GitHub: virattt/ai-hedge-fund
一个基于多智能体协作的AI对冲基金概念验证项目,通过模拟多位著名投资大师的决策风格,结合技术面、基本面和情绪分析进行股票研究和策略回测。
Stars: 46444 | Forks: 8104
# AI 对冲基金
这是一个由 AI 驱动的对冲基金的概念验证。该项目的目标是探索使用 AI 进行交易决策。本项目**仅用于教育目的**,不适用于真实交易或投资。
该系统采用多个协同工作的智能体(Agent):
1. Aswath Damodaran Agent - 估值院长,专注于故事、数字和严谨的估值
2. Ben Graham Agent - 价值投资教父,只购买具有安全边际的隐藏宝石
3. Bill Ackman Agent - 激进投资者,采取大胆立场并推动变革
4. Cathie Wood Agent - 增长投资女王,相信创新和颠覆的力量
5. Charlie Munger Agent - Warren Buffett 的合伙人,只以公道价格购买优秀的企业
6. Michael Burry Agent - 《大空头》中的逆向投资者,寻找深度价值
7. Mohnish Pabrai Agent - Dhandho 投资者,寻找低风险的双倍回报
8. Peter Lynch Agent - 务实的投资者,在日常业务中寻找“十倍股”
9. Phil Fisher Agent - 一丝不苟的增长投资者,使用深入的“闲聊”调查法
10. Rakesh Jhunjhunwala Agent - 印度的大多头
11. Stanley Druckenmiller Agent - 宏观传奇人物,寻找具有增长潜力的不对称机会
12. Warren Buffett Agent - 奥马哈先知,寻求以公道价格购买优秀的公司
13. Valuation Agent - 计算股票的内在价值并生成交易信号
14. Sentiment Agent - 分析市场情绪并生成交易信号
15. Fundamentals Agent - 分析基本面数据并生成交易信号
16. Technicals Agent - 分析技术指标并生成交易信号
17. Risk Manager - 计算风险指标并设定仓位限制
18. Portfolio Manager - 做出最终交易决策并生成订单
注意:该系统实际上不会进行任何交易。
[](https://twitter.com/virattt)
## 免责声明
本项目**仅用于教育和研究目的**。
- 不适用于真实交易或投资
- 不提供投资建议或保证
- 创建者不对财务损失承担任何责任
- 投资决策请咨询财务顾问
- 过往表现并不代表未来结果
使用本软件即表示您同意仅将其用于学习目的。
## 目录
- [安装指南](#how-to-install)
- [如何运行](#how-to-run)
- [⌨️ 命令行界面](#️-command-line-interface)
- [🖥️ Web 应用程序](#️-web-application)
- [如何贡献](#how-to-contribute)
- [功能请求](#feature-requests)
- [许可证](#license)
## 安装指南
在运行 AI Hedge Fund 之前,您需要安装它并设置您的 API Key。这些步骤对于全栈 Web 应用程序和命令行界面都是通用的。
### 1. 克隆仓库
```
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
```
### 2. 设置 API Key
为您的 API Key 创建一个 `.env` 文件:
```
# 为你的 API keys 创建 .env file (在 root directory)
cp .env.example .env
```
打开并编辑 `.env` 文件以添加您的 API Key:
```
# 用于运行由 openai 托管的 LLMs (gpt-4o, gpt-4o-mini 等)
OPENAI_API_KEY=your-openai-api-key
# 用于获取 financial data 以驱动 hedge fund
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
```
**重要提示**:您必须至少设置一个 LLM API Key(例如 `OPENAI_API_KEY`、`GROQ_API_KEY`、`ANTHROPIC_API_KEY` 或 `DEEPSEEK_API_KEY`)才能运行该对冲基金。
**金融数据**:AAPL、GOOGL、MSFT、NVDA 和 TSLA 的数据是免费的,不需要 API Key。对于任何其他股票代码,您需要在 .env 文件中设置 `FINANCIAL_DATASETS_API_KEY`。
## 如何运行
### ⌨️ 命令行界面
您可以直接通过终端运行 AI Hedge Fund。这种方法提供了更精细的控制,适用于自动化、脚本编写和集成目的。
#### 快速开始
1. 安装 Poetry(如果尚未安装):
```
curl -sSL https://install.python-poetry.org | python3 -
```
2. 安装依赖项:
```
poetry install
```
#### 运行 AI Hedge Fund
```
poetry run python src/main.py --ticker AAPL,MSFT,NVDA
```
您也可以指定 `--ollama` 标志,以使用本地 LLM 运行 AI 对冲基金。
```
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` 标志也适用于回测器!
### 🖥️ Web 应用程序
运行 AI Hedge Fund 的新方式是通过我们的 Web 应用程序,它提供了一个用户友好的界面。推荐给喜欢可视化界面而非命令行工具的用户。
请参阅[此处](https://github.com/virattt/ai-hedge-fund/tree/main/app)关于如何安装和运行 Web 应用程序的详细说明。
## 功能请求
如果您有功能请求,请提交一个 [issue](https://github.com/virattt/ai-hedge-fund/issues) 并确保打上 `enhancement` 标签。
## 许可证
本项目基于 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
注意:该系统实际上不会进行任何交易。
[](https://twitter.com/virattt)
## 免责声明
本项目**仅用于教育和研究目的**。
- 不适用于真实交易或投资
- 不提供投资建议或保证
- 创建者不对财务损失承担任何责任
- 投资决策请咨询财务顾问
- 过往表现并不代表未来结果
使用本软件即表示您同意仅将其用于学习目的。
## 目录
- [安装指南](#how-to-install)
- [如何运行](#how-to-run)
- [⌨️ 命令行界面](#️-command-line-interface)
- [🖥️ Web 应用程序](#️-web-application)
- [如何贡献](#how-to-contribute)
- [功能请求](#feature-requests)
- [许可证](#license)
## 安装指南
在运行 AI Hedge Fund 之前,您需要安装它并设置您的 API Key。这些步骤对于全栈 Web 应用程序和命令行界面都是通用的。
### 1. 克隆仓库
```
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
```
### 2. 设置 API Key
为您的 API Key 创建一个 `.env` 文件:
```
# 为你的 API keys 创建 .env file (在 root directory)
cp .env.example .env
```
打开并编辑 `.env` 文件以添加您的 API Key:
```
# 用于运行由 openai 托管的 LLMs (gpt-4o, gpt-4o-mini 等)
OPENAI_API_KEY=your-openai-api-key
# 用于获取 financial data 以驱动 hedge fund
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
```
**重要提示**:您必须至少设置一个 LLM API Key(例如 `OPENAI_API_KEY`、`GROQ_API_KEY`、`ANTHROPIC_API_KEY` 或 `DEEPSEEK_API_KEY`)才能运行该对冲基金。
**金融数据**:AAPL、GOOGL、MSFT、NVDA 和 TSLA 的数据是免费的,不需要 API Key。对于任何其他股票代码,您需要在 .env 文件中设置 `FINANCIAL_DATASETS_API_KEY`。
## 如何运行
### ⌨️ 命令行界面
您可以直接通过终端运行 AI Hedge Fund。这种方法提供了更精细的控制,适用于自动化、脚本编写和集成目的。
#### 快速开始
1. 安装 Poetry(如果尚未安装):
```
curl -sSL https://install.python-poetry.org | python3 -
```
2. 安装依赖项:
```
poetry install
```
#### 运行 AI Hedge Fund
```
poetry run python src/main.py --ticker AAPL,MSFT,NVDA
```
您也可以指定 `--ollama` 标志,以使用本地 LLM 运行 AI 对冲基金。
```
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` 标志也适用于回测器!
### 🖥️ Web 应用程序
运行 AI Hedge Fund 的新方式是通过我们的 Web 应用程序,它提供了一个用户友好的界面。推荐给喜欢可视化界面而非命令行工具的用户。
请参阅[此处](https://github.com/virattt/ai-hedge-fund/tree/main/app)关于如何安装和运行 Web 应用程序的详细说明。
## 功能请求
如果您有功能请求,请提交一个 [issue](https://github.com/virattt/ai-hedge-fund/issues) 并确保打上 `enhancement` 标签。
## 许可证
本项目基于 MIT 许可证授权 - 详情请参阅 LICENSE 文件。标签:AI交易系统, AI风险缓解, FinTech, Petitpotam, Python金融, Sysdig, 人工智能对冲基金, 价值投资, 估值模型, 基本面分析, 多智能体架构, 大语言模型金融应用, 市场情绪分析, 成长投资, 技术分析, 投资组合管理, 教育科研项目, 模仿交易, 股票分析工具, 自动化交易机器人, 逆向工具, 量化交易, 量化投资, 金融科技