AI 对冲基金

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

本系统采用多智能体协作模式：

1. 阿斯沃斯·达摩达兰智能体 - 估值领域的权威，专注于商业叙事、财务数据和严谨估值
2. 本杰明·格雷厄姆智能体 - 价值投资之父，只购买具有安全边际的隐藏瑰宝
3. 比尔·阿克曼智能体 - 激进投资者，采取大胆立场并推动变革
4. 凯茜·伍德智能体 - 成长股投资女王，坚信创新与颠覆的力量
5. 查理·芒格智能体 - 巴菲特搭档，只以合理价格收购优质企业
6. 迈克尔·伯里智能体 - 《大空头》原型，逆向寻找深度价值
7. 彼得·林奇智能体 - 务实投资者，在普通企业中寻找"十倍股"
8. 菲利普·费雪智能体 - 严谨的成长股投资者，采用深度"小道消息"研究法
9. 拉克什·金君瓦拉智能体 - 印度股市"大公牛"
10. 斯坦利·德鲁肯米勒智能体 - 宏观投资传奇，寻找具有增长潜力的不对称机会
11. 沃伦·巴菲特智能体 - 奥马哈先知，以合理价格收购卓越企业
12. 估值智能体 - 计算股票内在价值并生成交易信号
13. 情绪分析智能体 - 解析市场情绪并生成交易信号
14. 基本面分析智能体 - 分析基本面数据并生成交易信号
15. 技术分析智能体 - 分析技术指标并生成交易信号
16. 风险管理智能体 - 计算风险指标并设置仓位限制
17. 组合管理智能体 - 做出最终交易决策并生成订单

注意：本系统仅模拟交易决策，不进行实际交易。

免责声明

本项目仅用于教育与研究目的：

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

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

目录

• 安装指南
  • 使用Poetry
  • 使用Docker
• 使用说明
  • 运行对冲基金
  • 运行回测系统
• 贡献指南
• 功能请求
• 许可证

安装指南

使用Poetry

克隆仓库：

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

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

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

2. 安装依赖项：

poetry install

3. 配置环境变量：

# Create .env file for your API keys
cp .env.example .env

4. 设置API密钥：

# For running LLMs hosted by openai (gpt-4o, gpt-4o-mini, etc.)
# Get your OpenAI API key from https://platform.openai.com/
OPENAI_API_KEY=your-openai-api-key

# For running LLMs hosted by groq (deepseek, llama3, etc.)
# Get your Groq API key from https://groq.com/
GROQ_API_KEY=your-groq-api-key

# For getting financial data to power the hedge fund
# Get your Financial Datasets API key from https://financialdatasets.ai/
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

使用Docker

1. 确保系统已安装Docker，如未安装请从Docker官网下载

2. 克隆仓库：

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

3. 配置环境变量：

# Create .env file for your API keys
cp .env.example .env

4. 编辑.env文件添加API密钥（方法同上）

5. 进入docker目录：

cd docker

6. 构建Docker镜像：

# On Linux/Mac:
./run.sh build

# On Windows:
run.bat build

重要提示：必须设置OPENAI_API_KEY、GROQ_API_KEY、ANTHROPIC_API_KEY或DEEPSEEK_API_KEY才能运行对冲基金。如需使用所有提供商的LLM，需设置全部API密钥。

AAPL、GOOGL、MSFT、NVDA和TSLA的金融数据可免费获取，无需API密钥。

其他股票代码需在.env文件中设置FINANCIAL_DATASETS_API_KEY。

使用说明

运行对冲基金

使用Poetry

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

使用Docker

注意：所有Docker命令必须在docker/目录下执行

# Navigate to the docker directory first
cd docker

# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA main

示例输出：

可通过--ollama参数使用本地LLM运行AI对冲基金：

# With Poetry:
poetry run python src/main.py --ticker AAPL,MSFT,NVDA --ollama

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --ollama main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --ollama main

通过--show-reasoning参数可打印各智能体的决策逻辑：

# With Poetry:
poetry run python src/main.py --ticker AAPL,MSFT,NVDA --show-reasoning

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --show-reasoning main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --show-reasoning main

可选指定起止日期分析特定时段：

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

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 main

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 main

运行回测系统

使用Poetry

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

使用Docker

注意：所有Docker命令必须在docker/目录下执行

# Navigate to the docker directory first
cd docker

# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA backtest

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA backtest

示例输出：

可选指定起止日期进行特定时段回测：

# With Poetry:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --start-date 2024-01-01 --end-date 2024-03-01 backtest

通过--ollama参数可使用本地LLM运行回测：

# With Poetry:
poetry run python src/backtester.py --ticker AAPL,MSFT,NVDA --ollama

# With Docker (from docker/ directory):
# On Linux/Mac:
./run.sh --ticker AAPL,MSFT,NVDA --ollama backtest

# On Windows:
run.bat --ticker AAPL,MSFT,NVDA --ollama backtest

贡献指南

1. Fork本仓库
2. 创建特性分支
3. 提交修改
4. 推送至分支
5. 创建Pull Request

重要：请保持PR精简专注，便于审核合并。

功能请求

如有功能需求，请提交issue并标记enhancement标签。

许可证

本项目采用MIT许可证，详见LICENSE文件。