跳到主要内容

安装

本指南将帮助您在本地机器上设置TradingAgents。安装过程包括设置环境、安装依赖项和配置所需的API密钥。

前提条件​

在安装TradingAgents之前，请确保您拥有：

  • Python 3.13或更高版本
  • Git
  • 虚拟环境管理器（conda、venv等）
  • FinnHub API访问权限（提供免费层）
  • OpenAI API访问权限

步骤1：克隆仓库​

首先，克隆TradingAgents仓库：

git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents

步骤2：创建虚拟环境​

使用您首选的方法创建并激活虚拟环境：

使用Conda（推荐）​

conda create -n tradingagents python=3.13
conda activate tradingagents

使用venv​

python -m venv tradingagents
source tradingagents/bin/activate  # Windows上：tradingagents\Scripts\activate

步骤3：安装依赖项​

安装所需的Python包：

pip install -r requirements.txt

这将安装所有必要的依赖项，包括：

  • 用于多智能体编排的LangGraph
  • 用于LLM集成的OpenAI SDK
  • 用于金融数据的FinnHub SDK
  • 其他支持库

步骤4：API配置​

TradingAgents需要两个API密钥才能正常运行：

FinnHub API密钥​

FinnHub提供金融市场数据。您可以使用免费层进行测试：

  1. 访问FinnHub.io并创建账户
  2. 从仪表板生成您的API密钥
  3. 设置环境变量：
export FINNHUB_API_KEY=your_finnhub_api_key_here

OpenAI API密钥​

OpenAI为框架中的LLM智能体提供支持：

  1. 访问OpenAI平台并创建账户
  2. 从API密钥部分生成您的API密钥
  3. 设置环境变量：
export OPENAI_API_KEY=your_openai_api_key_here

持久化环境变量​

要使这些环境变量持久化，请将它们添加到您的shell配置文件中：

# 对于bash用户（~/.bashrc或~/.bash_profile）
echo 'export FINNHUB_API_KEY=your_finnhub_api_key_here' >> ~/.bashrc
echo 'export OPENAI_API_KEY=your_openai_api_key_here' >> ~/.bashrc
source ~/.bashrc

# 对于zsh用户（~/.zshrc）
echo 'export FINNHUB_API_KEY=your_finnhub_api_key_here' >> ~/.zshrc
echo 'export OPENAI_API_KEY=your_openai_api_key_here' >> ~/.zshrc
source ~/.zshrc

步骤5：验证安装​

通过运行简单示例测试您的安装：

from tradingagents.graph.trading_graph import TradingAgentsGraph
from tradingagents.default_config import DEFAULT_CONFIG

# 初始化TradingAgents
ta = TradingAgentsGraph(debug=True, config=DEFAULT_CONFIG.copy())

# 使用示例股票代码进行测试
_, decision = ta.propagate("NVDA", "2024-05-10")
print(decision)

常见安装问题​

问题：包安装错误​

如果遇到包安装错误：

pip install --upgrade pip
pip install -r requirements.txt --force-reinstall

问题：找不到API密钥​

确保您的环境变量已正确设置：

echo $FINNHUB_API_KEY
echo $OPENAI_API_KEY

问题：Python版本兼容性​

TradingAgents需要Python 3.13+。检查您的版本：

python --version

下一步​

安装完成后：

  1. 尝试快速开始指南
  2. 探索CLI使用
  3. 了解API设置

替代安装方法​

使用Docker（即将推出）​

未来版本计划支持Docker，以简化部署和环境管理。

包管理器安装（即将推出）​

未来版本将提供PyPI包安装：

pip install tradingagents  # 即将推出