TradingAgents 自建
2-4 小时起- 安装 Git、Python 或 Docker / WSL2
- 下载代码或镜像并安装依赖
- 配置模型、API Key、额度和端点
- 配置行情、新闻、财务数据源
- 确认市场代码并排查首次运行问题
国内普通技术用户建议至少预留 1 个工作日；镜像、端点或数据服务受限时可能需要 1-3 天。
Python ≥ 3.10pyproject 当前声明
Python 3.12官方 README 示例
pip install .源码安装命令
Docker Compose官方支持路线
Ollama可选本地模型 profile
Build time
从下载到第一次成功研究，时间花在哪里？
以下时间不是只打开命令，而是完成模型、数据和首次研究结果的完整链路。
EasyClaw
下载安装后即可开始- 下载安装 EasyClaw
- 打开股票研究入口
- 输入股票和研究问题
- 开始查看基础研究结果
不需要先搭建 TradingAgents；专业数据服务仍可能需要另外连接和授权。
不想维护 Python、Docker 和多种密钥？
可以改走 EasyClaw 的独立股票研究路线，从一个明确问题开始，再按任务连接所需数据服务；下载安装不会自动运行 TradingAgents。
Preflight
安装前检查
如果下面任一项还没有答案，先停在配置阶段，不要急着运行完整研究。
运行环境
- Git 可用
- Python 3.10+ 或 Docker
- 有权限创建虚拟环境和缓存目录
模型路线
- 选择云端 LLM 提供商
- 或准备 Ollama / OpenAI-compatible 端点
- 确认模型额度与区域端点
数据路线
- 确认目标市场与代码格式
- 按需准备 Alpha Vantage 等 Key
- 接受新闻和社交数据的时效变化
Python
路线一：Python 源码安装
适合希望直接阅读代码、调试配置和使用 Python 包接口的部署者。
克隆官方仓库
从 TauricResearch 的官方仓库获取代码，并记录准备使用的提交或发布版本。
创建独立环境
官方 README 使用 Conda 与 Python 3.12；也可以使用兼容的虚拟环境工具。
安装当前包
在仓库根目录运行
pip install .。先做 CLI 启动验证
确认命令可打开，再进入模型与数据配置，不要把启动成功误写成研究运行成功。
PowerShell / Shellgit clone https://github.com/TauricResearch/TradingAgents.git
cd TradingAgents
conda create -n tradingagents python=3.12
conda activate tradingagents
pip install .
tradingagentsDocker
路线二：Docker Compose
适合希望隔离依赖、使用标准容器入口或搭配本地 Ollama 服务的环境。
标准容器
复制环境变量示例，填入所选提供商的密钥，然后通过 Compose 启动交互式 CLI。
Dockercp .env.example .env
docker compose run --rm tradingagentsOllama profile
本地模型需要 Ollama 服务和已拉取模型；远程 Ollama 可通过相应端点配置。
Docker + Ollamadocker compose --profile ollama run --rm tradingagents-ollama密钥保护：不要把填写后的 .env、终端历史、账户信息或本地绝对路径复制到公开页面和截图中。
Verification
什么才算安装完成
安装验证只确认程序入口和依赖，不证明数据源、模型权限或研究输出已经可用。
命令可识别
tradingagents 或 python -m cli.main 能进入交互流程。
配置仍待完成
模型 API、数据源、市场代码和配额需要在下一步独立核验。
尚未运行研究
只有完成一次带标的、日期、来源和时间记录的调用，才属于运行证据。
Troubleshooting
常见安装问题
Python 版本满足但依赖仍冲突怎么办？
确认命令运行在独立虚拟环境中，并以当前 pyproject 为准。不要混用系统 Python、旧环境和不同锁定版本。
Docker 启动后为什么还不能分析？
容器启动只说明运行环境可用。模型 Key、数据提供商、区域端点、额度和目标市场仍需分别配置。
本地模型是否完全不需要 Key？
本地 OpenAI-compatible 或 Ollama 端点本身可以不需要外部 Key，但若其端点设置了鉴权，仍需配置对应凭据；市场数据也可能需要独立 Key。