AI对冲基金

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

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

1. 阿斯瓦斯·达莫达兰代理——估值学派宗师，专注于故事、数据与严谨的估值方法。
2. 本杰明·格雷厄姆代理——价值投资之父，只买入具有安全边际的被低估股票。
3. 比尔·阿克曼代理——激进投资者，敢于采取大胆立场并推动企业变革。
4. 凯茜·伍德代理——成长型投资女王，坚信创新与颠覆的力量。
5. 查理·芒格代理——沃伦·巴菲特的搭档，只在合理价格下买入卓越的企业。
6. 迈克尔·伯里代理——《大空头》中的逆向投资者，专攻深度价值股。
7. 莫尼什·帕布雷代理——“丹多”投资策略践行者，追求低风险下的翻倍回报。
8. 纳西姆·塔勒布代理——黑天鹅事件风险分析师，关注尾部风险、反脆弱性及非对称收益。
9. 彼得·林奇代理——务实型投资者，在日常经营中寻找十倍股。
10. 菲利普·费雪代理——细致的成长型投资者，通过深入调研捕捉市场内幕信息。
11. 拉凯什·荣朱恩瓦拉代理——印度股市的“大公牛”。
12. 斯坦利·德鲁肯米勒代理——宏观投资传奇人物，寻找具备增长潜力的非对称机会。
13. 沃伦·巴菲特代理——奥马哈先知，以合理价格买入卓越公司。
14. 估值代理——计算股票内在价值并生成交易信号。
15. 情绪代理——分析市场情绪并生成交易信号。
16. 基本面代理——分析基本面数据并生成交易信号。
17. 技术面代理——分析技术指标并生成交易信号。
18. 风险管理器——计算风险指标并设定仓位上限。
19. 投资组合经理——做出最终交易决策并生成订单。

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

免责声明

本项目仅用于教育和研究目的。

• 不适用于实际交易或投资。
• 不提供任何投资建议或保证。
• 创作者不对任何财务损失承担责任。
• 投资决策请咨询专业财务顾问。
• 历史业绩不代表未来表现。

使用本软件即表示您同意仅将其用于学习目的。

目录

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

如何安装

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

1. 克隆仓库

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

2. 设置API密钥

创建一个用于存放API密钥的.env文件：

# 在根目录下创建 .env 文件以存放 API 密钥
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对冲基金。这种方式提供了更精细的控制，适合自动化、脚本编写以及集成场景。

快速入门

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

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

2. 安装依赖项：

poetry install

运行AI对冲基金

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对冲基金的新方式是通过我们的Web应用程序，它提供了一个用户友好的界面。对于偏好可视化界面而非命令行工具的用户，推荐使用此方式。

有关如何安装和运行Web应用的详细说明，请参阅此处。

如何贡献

1. 分支仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 发起拉取请求

重要提示：请确保您的拉取请求内容简洁且聚焦明确，这将有助于我们更轻松地审查和合并。

功能请求

如果您有功能需求，请在GitHub上提交一个issue，并确保将其标记为enhancement。

许可证

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

AI Hedge Fund 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL 推荐)
• Python 版本：Python 3.9+
• 包管理工具：Poetry (项目依赖管理)
• API 密钥：
  • 至少一个大语言模型 API Key (如 OpenAI, Groq, Anthropic, DeepSeek 等)
  • 金融数据 API Key (Financial Datasets API)

提示：国内开发者若访问 GitHub 或 PyPI 较慢，建议配置相应的镜像加速源。

安装步骤

1. 克隆项目仓库

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

2. 配置 API 密钥

在项目根目录下创建 .env 文件并填入您的密钥：

cp .env.example .env

编辑 .env 文件，添加以下内容（至少配置一个 LLM Key）：

# LLM API Key (任选其一，例如 OpenAI)
OPENAI_API_KEY=your-openai-api-key

# 金融数据 API Key
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

注意：支持多种 LLM 提供商，也可使用 GROQ_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY 等。若需使用本地模型，可后续通过 --ollama 参数启动。

3. 安装依赖

使用 Poetry 安装项目所需依赖：

# 安装 Poetry (如果尚未安装)
curl -sSL https://install.python-poetry.org | python3 -

# 安装项目依赖
poetry install

基本使用

安装完成后，您可以通过命令行直接运行 AI 对冲基金系统。以下是最简单的使用示例，针对苹果、微软和英伟达三只股票进行分析：

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

常用扩展命令

使用本地大模型 (Ollama)：

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

免责声明：本项目仅用于教育和研究目的，不构成任何投资建议，请勿用于真实交易。