TradingAgents-CN
多智能体LLM中文金融分析平台,模拟分析师-研究员-风控官-交易员协作链路
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
多智能体LLM中文金融分析平台,模拟分析师-研究员-风控官-交易员协作链路
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
2025年的A股市场,一位名叫老张的散户每天盯着屏幕上的K线图,看着消息面上的各种利好利空,却始终找不到一个系统化的分析方法。他想借鉴机构投资者的做法,却发现他们的研报要么太贵,要么太专业看不懂。与此同时,在大洋彼岸,一群技术极客正在尝试用大型语言模型(LLMs)构建一套能够自动分析股票、生成研究报告的多智能体系统——这就是 TauricResearch/TradingAgents 的诞生背景。
而TradingAgents-CN则是这一框架的中文增强版本,由国内开发者 hsliuping 在原版基础上进行了深度本地化改造,专门针对中文用户的投资研究场景进行了大量优化。凭借 27,000+ 的 GitHub Stars,它已经成为中文 AI 金融领域最受欢迎的开源项目之一。
TradingAgents-CN 基于 TauricResearch/TradingAgents 项目开发。源项目由 Tauric Research 团队创建,首次将多智能体(Multi-Agent)架构与大型语言模型结合,应用于金融交易研究领域。
为什么要做中文增强版? 核心原因在于三点:
第一,数据源差异。A股市场与美股市场的数据结构、数据接口完全不同——A股需要使用 AkShare、Tushare、BaoStock 等中文数据源,而原版只支持 Finnhub、yfinance 等英文数据源。TradingAgents-CN 深度集成了这些中文数据源,能够获取A股的实时行情、财务数据、公告信息等。
第二,语言理解差异。金融新闻分析需要对中文语境有深入理解。中文财经媒体的表达方式、专业术语、数据格式与英文有显著差异,原版模型在中文场景下效果欠佳。CN版本针对中文分词、财经术语识别、新闻情感分析等进行了专项优化。
第三,生态配套差异。国内用户更多使用微信公众号、微信群等渠道传播信息,而不仅仅是英文世界的Twitter/Reddit。CN版本新增了微信公众号关注引导、微信消息推送等中国特色功能。
TradingAgents-CN 的核心设计理念来自多智能体协作(Multi-Agent Collaboration)。整个系统由四类专业 Agent 组成,各司其职,通过 LangGraph 编排的工作流进行协调:
市场分析师(Market Analyst) 是整个系统的数据中枢。它负责从 AkShare、Tushare、BaoStock 等多个数据源获取股票的OHLCV行情数据、技术指标(MACD、RSI、布林带等)、基本面数据(市盈率、市净率、净利润等)。分析师会对这些原始数据进行清洗和交叉验证,如果主数据源不可用,会自动切换到备用数据源,形成多级降级链(stock_bid_ask_em → stock_zh_a_spot → stock_zh_a_hist),确保数据获取的稳定性。
新闻研究员(Researcher) 负责收集和筛选与目标股票相关的新闻、公告和社交媒体信息。它整合了多个新闻源,支持新闻质量评估和多层次过滤。中文增强版重点优化了中文财经新闻的抓取和情感分析能力,能够识别新闻来源的可信度并过滤噪音信息。
风控经理(Risk Manager) 负责评估分析结果的潜在风险,包括市场风险、流动性风险、信息不对称风险等。它会对分析师的结论进行独立复核,当发现数据异常或逻辑矛盾时会触发告警。这一 Agent 是系统避免"AI幻觉"导致错误投资建议的关键防线。
交易员(Trader) 负责综合各方分析结果,生成最终的交易策略建议和研究报告。它会综合市场趋势、基本面分析、新闻情绪和风控评估,给出综合性的投资建议。
图1:研究员 Agent — 负责新闻抓取、舆情分析与信息检索
这四类 Agent 之间的通信和协作通过 LangGraph 实现。LangGraph 是 LangChain 团队推出的用于构建有状态、多角色 LLM 应用的工作流框架,特别适合需要 Agent 之间相互反馈、迭代改进的场景。例如,交易员的初步结论可以反馈给分析师要求补充数据,再由研究员核实,最终形成一份完整的分析报告。
从代码结构来看,TradingAgents-CN 采用了前后端分离 + 微服务的现代化架构:
后端基于 FastAPI 构建 RESTful API(之前版本使用 Streamlit),这是一个高性能、异步友好的 Python Web 框架。相比 Streamlit,FastAPI 提供了更规范的 API 接口定义、更强大的请求验证和更好的生产级支持。数据库层采用 MongoDB + Redis 双引擎组合:MongoDB 用于存储用户数据、分析报告和配置信息,Redis 用于缓存实时行情和会话状态。相比之前的纯文件存储方案,性能提升约 10 倍。
前端采用 Vue 3 + Vite + Element Plus 重构(v1.0.x 版本),提供了现代化的单页应用体验。相比旧版的 Streamlit 前端,Vue 重构版在响应速度、交互体验和移动端适配上都有显著提升。
LLM接入层采用了高度抽象的客户端架构(llm_clients/ 目录)。系统支持 OpenAI GPT 系列、Anthropic Claude 系列、Google Gemini 系列,以及国内主流的 通义千问(DashScope)、百度文心、智谱 GLM 等。所有 LLM 客户端都实现了统一的接口规范(base_client.py),通过工厂模式(factory.py)进行管理,实现了模型选择的无缝切换。这种设计使得用户可以根据自己的需求和预算,选择最合适的 LLM 提供商。
数据流编排方面,系统使用 LangGraph 管理多 Agent 的状态流转、条件分支和错误恢复。trading_graph.py 是核心编排文件,定义了节点(Agent)和边(通信路径)的拓扑结构,以及条件逻辑(conditional_logic.py)和信号处理(signal_processing.py)。
值得注意的是,项目采用了混合许可证策略:核心算法代码(tradingagents/ 目录)采用 Apache 2.0 开源许可证,允许个人免费使用;但 app/(FastAPI 后端)和 frontend/(Vue 前端)目录采用专有许可证,需要商业授权才能用于商业目的。作者明确在 README 中声明,v2.0 版本将暂不开源(理由是"盗版问题"),这是对开源可持续性的一次现实考量。
**Docker 部署(推荐方式)**是最简单的启动方案。系统提供了完整的多架构 Docker 镜像(amd64 + arm64),支持 Apple Silicon 设备。部署流程非常清晰:克隆仓库后,在项目根目录执行 docker-compose up -d,系统会自动拉取前后端镜像、初始化 MongoDB 和 Redis 容器,整个过程约 5-10 分钟。启动后访问 http://localhost:3000 即可看到 Vue 3 前端界面。
本地源码部署适合需要定制开发的用户。需要先安装 Python 3.10+、MongoDB、Redis,然后通过 pip install -r requirements.txt 安装依赖,再运行 python main.py。但作者在文档中特别提醒,在分析股票之前必须先完成数据同步,否则分析结果会出现数据错误——这一步需要配置 AkShare/Tushare 的 API Key,对于新手来说有一定门槛。
硬件需求方面,系统主要消耗的是 LLM API 调用(成本取决于使用量),本地计算资源需求相对适中:4GB+ RAM、5GB+ 磁盘空间,无需 GPU(LLM 调用走 API,不在本地运行模型)。
图2:风控 Agent — 评估投资风险,守住安全底线
没有任何项目是完美的。TradingAgents-CN 也有几个值得关注的局限:
版权争议。作者在 README 中明确声明,发现有网站(tradingagents-ai.com)未经授权使用了项目代码并声称是自家产品。这提示用户在使用和分发时需要仔细确认许可证边界。
许可证的复杂性。混合许可证模式(Apache 2.0 + 专有部分)对商业用户不够友好——如果你想在商业产品中使用完整功能,需要联系作者获取商业授权,授权条款和费用并不透明。
v2.0 暂不开源。由于"盗版问题",开发团队决定 v2.0 版本不进行开源,而是通过官方渠道发布。这意味着 v1.0.x 将成为最后一个主要开源版本,后续的功能迭代和 bug 修复可能缺乏社区支持。
数据准确性风险。系统输出的分析报告基于 LLM 对历史数据的理解和推理,并不构成真正的投资建议。作者也明确说明"不提供实盘交易指令",但用户仍需自行判断 AI 生成内容的可靠性。
安装门槛。尽管提供了 Docker 部署,但数据同步配置(AkShare/Tushare API Key)、LLM API Key 的配置对非技术用户仍有一定难度,且依赖多个外部数据源任何一个出问题都可能影响分析质量。
TradingAgents-CN 的价值不仅在于它本身是一个可用的工具,更在于它代表了一种趋势:AI 正在降低金融分析的专业门槛。
传统的量化交易研究需要深厚的金融工程背景、熟练的编程能力和强大的计算资源。而 TradingAgents-CN 展示了一种新的可能性:通过多智能体协作,一个普通投资者也可以获得接近机构级别的分析视角——从新闻情绪、技术指标、基本面数据到风险评估,全部由 AI 自动完成。
从技术演进角度,项目从 Streamlit 单体应用演进到 FastAPI + Vue 前后端分离架构的过程,也是一个很好的工程实践案例。它展示了如何通过渐进式重构,将一个实验性的研究项目逐步改造成可维护、可扩展的生产级系统。
在增长曲线方面,27,000+ Stars、5,600+ Forks、265 个 Open Issues 的数据表明项目正在被活跃地使用和迭代。其中 265 个 Open Issues 也提醒我们,这个项目仍处于快速迭代期,可能存在一些稳定性问题,用户需要有一定的心理准备。
分析基于 GitHub 仓库信息(Stars 27,247,Forks 5,785,Python 语言,Apache 2.0 + 专有混合许可证)。数据获取时间:2026年5月。