TradingAgents 怎么安装：源码、Docker 与绿色版步骤对照

TradingAgents 是一个多智能体金融交易框架，可用于让多个角色协作分析股票并形成交易决策。

截至 2026 年 10 月，TradingAgents 已更新到 v0.7.1；README 同时记录了源码安装、容器部署和命令行运行方式。现在值得重新整理安装路径，是因为 v0.7.0 已支持使用自己的 ChatGPT Plus 或 Pro 计划，并为 GitHub Release 附加安装 wheel。不同部署方式使用的密钥、启动命令和操作界面并不相同，照着单一教程操作容易装到一半才发现选错了路线。

下文以官方 TradingAgents 仓库 为安装基线，同时对照社区维护的 TradingAgents-CN 安装指南。TradingAgents-CN 是独立的中文社区版本，不是上游官方分支；其中文界面和预配置更适合中文用户，但升级、功能和兼容性应以各自仓库为准。

先选对安装方式

本地代码安装指下载上游源码，在自己的 Python 环境中运行，优点是方便检查代码和切换模型，代价是必须自行准备环境与 API 密钥。Docker 安装把程序和依赖放进容器，隔离环境更稳定，适合服务器或长期运行。绿色版是 TradingAgents-CN 提供的 Windows 免安装压缩包，解压后启动脚本，适合先体验中文界面。

方式	适合对象	主要入口	启动结果	密钥配置
上游源码安装	想研究代码、修改模型或流程的用户	main.py	命令行交互界面	编辑 .env
上游 Docker 安装	Linux 服务器、容器环境	docker-compose.yml	容器内运行服务	编辑 .env
TradingAgents-CN 绿色版	Windows 新手、中文界面体验	start_all.ps1	浏览器访问本地页面	启动后按界面配置
TradingAgents-CN Docker 安装	跨平台部署、长期运行	docker-compose.yml	浏览器访问本地页面	编辑 .env

如果只是想判断框架能否运行，采用上游源码安装最省判断成本；如果需要中文操作面板，可以先用绿色版，但要先确认它不是上游官方版本。

上游源码安装：适合开发和调试

上游仓库当前包含 pyproject.toml、requirements.txt、Dockerfile、docker-compose.yml 和 .env.example。其中 .env.example 是环境变量模板，API 密钥不应直接写进代码或提交到 Git 仓库。

先安装 Git、Python 3.13 和 Conda，运行 python --version 与 conda --version，确认两个命令均能输出版本号。然后从 官方仓库 获取源码：

git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
conda create -n tradingagents python=3.13
conda activate tradingagents
pip install -r requirements.txt
cp .env.example .env

Windows 用户如果不在 Conda 环境中，可改用 Python 虚拟环境：

git clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
python -m venv env
envScriptsactivate
pip install -r requirements.txt
copy .env.example .env

编辑 .env 时，先看 .env.example 实际列出的变量名，再填写对应供应商的密钥。不同模型供应商的数据源、模型名称和费用规则并不完全相同，不能只填一个通用 API Key 就期待全部功能可用。涉及资金、数据许可与模型调用费用，本文只按官方仓库给出的配置入口说明；实际用量和可用区域仍应以各供应商控制台为准。

安装依赖后可先启动主程序：

python main.py

首次进入时若出现模型和分析师选择菜单，说明 Python 依赖已经成功加载。接下来可以先完成一次短周期分析，确认终端持续输出角色协作过程，再配置定时任务或数据源。TradingAgents 的框架说明与方法背景可参阅其 README 收录的 论文 PDF。

Docker 安装：先确认容器状态

上游仓库同时提供 Dockerfile 与 docker-compose.yml，因此不需要自行把原生依赖逐项映射到宿主机。Docker Compose 是把多个容器定义组合后统一启动的工具。

先安装 Docker Desktop 或 Docker Engine，并执行以下命令确认 Docker 服务可用：

docker --version
docker compose version

在已克隆项目根目录中复制环境变量文件并启动：

cp .env.example .env
docker compose up -d
docker compose ps
docker compose logs -f

docker compose ps 中应出现运行中的服务，状态不是 Exited；docker compose logs -f 应持续显示启动日志。需要停止服务时执行：

docker compose down

如果容器退出，先读取完整日志，不要立刻重复启动：

docker compose logs --no-color

TradingAgents-CN 的快速开始文档也采用容器路线，但其访问端口写为 http://localhost:8501，见 Quick Start。这个端口属于 CN 版本，不能直接套到上游仓库。上游应以其 Compose 文件和日志里公布的端口为准。

Windows 绿色版：不用先配 Python

TradingAgents-CN 的安装指南把绿色版列为个人体验方式：仅支持 Windows，压缩包解压后不需要单独安装 Python、MongoDB 或 Redis。其 快速安装指南 给出的启动命令是：

cd D:TradingAgentsCN-portable
powershell -ExecutionPolicy Bypass -File start_all.ps1

这里的 D:TradingAgentsCN-portable 必须替换成实际解压目录。启动后在浏览器访问 http://localhost，再根据页面提示完成配置。-ExecutionPolicy Bypass 只影响当前 PowerShell 进程中的脚本执行策略，不要把它理解为永久关闭系统安全检查。

绿色版的优势是省去 Python 环境，边界也同样明确：它只适用于 Windows，版本更新依赖发布包，不适合需要直接修改 TradingAgents 核心代码的用户。若浏览器打不开本地页面，先确认 PowerShell 窗口中的启动脚本没有报错，再检查脚本配置的端口是否已被其他程序占用。

常见卡点：先看报错属于哪一层

安装失败通常出现在 Python、容器、配置或网络四层。ModuleNotFoundError: No module named 'tradingagents' 表示当前 Python 没有找到项目包；重新激活安装依赖的虚拟环境，再执行 pip install -r requirements.txt，并用 python -c "import tradingagents; print('import ok')" 验证。

docker compose ps 显示服务为 Exited 时，根因不会出现在浏览器里，而应从容器日志读取。执行 docker compose logs --no-color，重点查看环境变量缺失、配置文件不存在或端口冲突等原始报错；修正 .env 或 Compose 配置后再重启。

API 请求出现 401 Unauthorized 时，说明服务端拒绝了当前密钥。重新核对 .env 中对应变量名、密钥是否带空格，以及该供应商账户是否已经启用。不要把真实密钥贴到 Issue；可使用脱敏后的 .env.example 说明变量结构。连接类错误则先检查代理和网络，再确认供应商 API 地址是否可访问。

上游从 v0.5.2 起提供不进入交互提问、可直接传入股票代码和日期的 CLI。运行前先查看当前版本帮助，避免沿用旧参数：

python -m cli.main --help

帮助信息应列出 --ticker、--date 等参数。模型响应异常时，先用默认配置完成最小运行，再逐项增加数据源；否则很难区分是模型服务、行情源还是自定义配置的问题。

怎么确认安装成功

源码安装的成功标志包括三个：激活环境后 python -c "import tradingagents; print('import ok')" 输出 import ok；python main.py 能进入分析师选择流程；.env 中配置的供应商能成功返回一次模型响应。

Docker 安装则以 docker compose ps 显示服务运行、docker compose logs -f 出现正常启动信息、对应本地端口可以打开为准。绿色版成功时，PowerShell 脚本保持运行，浏览器访问 http://localhost 能看到应用页面。任何一种方式都应先完成一次短分析并检查生成的报告，再投入长时间运行。

官方入口与后续维护

上游源码、Issue、Release 和更新记录都集中在 TauricResearch/TradingAgents。README 的 News 区域记录版本变化，CHANGELOG.md 用于定位修复内容，Release 页面提供 wheel 文件；需要操作 GitHub Release 或 CI 流程时，可参考 GitHub Actions 文档。

升级前先保存本地 .env，查看 Release Notes 中涉及的导入路径、模型目录或数据接口变化，再在单独虚拟环境中安装新版本。不要直接覆盖旧环境：上游 README 明确提到部分版本调整过模块导入路径，旧目录中的自定义脚本可能因此失效。容器用户更新时也应重新构建镜像，而不是只重启旧容器。