TradingAgents-CN 部署指南：三条命令拉起一套多智能体股票分析平台

TradingAgents-CN 部署指南三条命令拉起一套多智能体股票分析平台【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本文讲解 TradingAgents-CN 的部署安装过程。TradingAgents-CN 是一个基于多智能体大语言模型的中文金融交易分析框架由多个 AI 分析师角色市场、基本面、新闻、风控协作完成股票研究与风险判断。读完本文你应能选出一条适合自己的部署路径在本地完整跑起这套系统并完成部署后的健康验证卡在某一环节时也有对应的排查入口。走哪条路先按背景对号入座这个项目提供两条主线部署方式外加一条给进阶用户的分支。选错路径是部署返工的最常见原因先花一分钟对照你的情况推荐路径特点预计耗时没碰过命令行只想先跑起来Docker 一键编排后端、前端、MongoDB、Redis 全部容器化环境隔离不污染本机10 分钟左右会基本命令行日常使用同上Docker 仍是首选生产环境、跨平台都推荐这条10 分钟左右要改代码、调试、二次开发源码部署本机 Python Node 环境可断点调试30 分钟起Windows 上完全不想装 Docker一键安装脚本scripts/setup/quick_install.py 自动装依赖并引导配置15 分钟左右下面的主路径按 Docker 编排完整写到底源码部署作为可选章节给出差异步骤两条线不并行。 环境要求清单部署前逐项确认先确认机器满足门槛避免装到一半才发现资源不够项目最低要求推荐配置CPU双核 2.0GHz4 核及以上内存4GB8GB 及以上磁盘5GB50GB 可用SSD网络能访问 LLM API 与数据源稳定连接软件层面两条路径的依赖不同Docker 路径只需 DockerCompose 插件可用本机不需要 Python、Node、MongoDB、Redis——它们都在容器里。源码路径Python 3.103.12建议 3.11、Node.js 18、MongoDB 4.4、Redis 6.0、Git。两条路径都需要一个可用的 LLM API 密钥DeepSeek、通义千问、OpenAI 等任选其一这是系统真正干活的动力。主路径部署Docker 编排下 3 条命令完成启动整个过程就四步拉代码、写密钥、起服务、等就绪。1. 获取代码git clone https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN cd TradingAgents-CN执行后本地多出一个TradingAgents-CN目录里面有 docker-compose.yml服务编排定义和 Dockerfile.backend 等构建文件确认存在即可进入下一步。2. 配置密钥cp .env.example .env编辑.env至少填一项 LLM 密钥例如DEEPSEEK_API_KEYsk-xxxx。如果你打算用 A 股数据源可顺带填上TUSHARE_TOKEN。数据库地址不用动——编排文件里已按mongodb/redis服务名配好内部连接串。3. 启动全部服务docker compose up -d首次运行需要构建后端、前端两个镜像耗时几分钟到十几分钟取决于网络。预期看到类似 Container tradingagents-mongodb Started 的逐行输出且没有 ERROR 字样。4. 等待就绪编排里配了健康检查后端探测http://localhost:8000/api/health启动顺序是 MongoDB/Redis → 后端 → 前端。跑完后确认状态docker compose ps预期 4 个核心服务mongodb、redis、backend、frontend状态列均为Up (healthy)。前端首次初始化会稍慢Up后等 10 秒再试。部署验证3 个可观察的验证点服务看起来在跑和真能用是两回事按顺序过这三个点① 后端健康接口浏览器打开http://localhost:8000/api/health预期返回一段表示健康的 JSON。这一步不通过后面都不用看。② 前端页面打开http://localhost:3000预期看到登录或配置界面而不是 502 / 空白页。若页面正常但提示无法连接后端多半是浏览器跨域到 8000 端口被拦检查本机防火墙。③ 跑一次最小分析这是最容易踩坑的一步先同步股票数据再发起分析否则报告里的数字会失真。在界面上进入数据同步入口或 CLI 初始化见下图对目标股票执行一次行情同步随后输入一个 A 股代码如000001选最浅的研究深度、最少的分析师组合发起分析。预期几分钟内看到进度推进并最终产出报告。可选扩展源码部署与按需定制只在需要改代码或深度调试时才走这条路差异步骤如下前置克隆步骤同主路径python -m venv venv # 建虚拟环境后激活 pip install -e . # 依赖以 pyproject.toml 为准requirements.txt 已弃用后端用python -m app.main或 uvicorn 启动默认 8000 端口前端在frontend/目录yarn install后执行开发命令默认 3000 端口。前提是 MongoDB 与 Redis 已按 docs/deployment/ 中的说明在本机装好并创建好账号。其他按需项数据源支持 Tushare、AkShare、BaoStock 多源AkShare 免费且带多级降级链适合测试正式环境建议配付费源。缓存与并发Redis 缓存大小、分析并发数可按硬件调整配置入口在 Web 界面的配置中心。管理界面docker compose --profile management up -d可额外拉起 Redis Commander8081与 Mongo Express8082方便观察数据。更细的部署变体端口配置、便携版、日志参考 docs/deployment/。排障速查现象 → 检查 → 处理端口冲突8000 / 3000 / 27017 / 6379 被占检查docker compose ps看是否有端口Unpublished或本机是否已有其他服务监听同端口。处理改 docker-compose.yml 中对应服务的宿主端口映射只改冒号左侧docker compose up -d重启。依赖或镜像拉取失败检查docker compose logs backend看具体报错行国内网络常见为 PyPI / Docker Hub 超时。处理给本机 pip 换镜像源如清华源Docker 配置可用镜像加速器确认能外网访问 LLM API 后重试。数据库连接异常检查docker compose logs mongodb确认容器healthy若本机自管 MongoDB核对连接串的用户名、密码与authSourceadmin是否齐全。处理确认 mongo-init 脚本已执行、账号已创建默认密码是tradingagents123正式环境务必更换并同步改.env中的连接串。页面能打开但分析不启动 / 结果异常检查.env里 LLM 密钥是否有效、账户余额是否充足目标股票是否已做过数据同步。处理补密钥、补同步后重试仍失败时看logs/下的运行日志容器内路径已映射到项目logs/目录。下一步建议把默认的数据库密码和.env里的示例值换成自己的再决定要不要把 27017/6379 这两个端口从宿主映射中移除仅容器内访问即可。用 1 级研究深度对 23 只你熟悉的股票各跑一次完整分析核对报告中的 PE、PB 等数值与行情软件是否一致——这是检验数据同步是否正确的最直接方式。有定制需求前先通读 docs/overview/installation.md 和 docs/deployment/ 下的源码安装手册避免边装边查。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考