这是一套面向中文用户的开源多智能体股票分析框架源码，基于大模型驱动的多角色协作来做股票研究与策略实验。
原项目是英文版 TradingAgents，本仓库在其基础上做了中文本地化、A股数据接入与 Web 平台增强，适合想研究 AI 金融分析、多智能体编排的同学下载学习。
源码简介
这套源码属于 AI 金融分析类，核心是一套多智能体协作的股票研究框架。
它把基本面、技术面、情绪面和风控分析拆成不同角色，由大模型分别给出判断再汇总成投资建议，整体定位是研究学习而非实盘交易。
仓库同时附带 FastAPI 后端、Vue 前端和 Streamlit 界面，开箱即可部署一套带用户系统和分析流程的本地平台。
适用场景
- 学习多智能体与大模型如何协作完成股票研究
- 搭建本地化的 A股/港股/美股分析实验环境
- 在开源框架基础上做二次开发或接入自有数据源
技术栈与运行环境
- 前端：Vue 3 + Vite + Element Plus（app/frontend 专有组件）；另含 Streamlit Web 界面（开源）
- 后端：FastAPI + Uvicorn（app/ 专有组件）
- 数据库：MongoDB + Redis（分析记录、缓存与用户数据）
- 运行环境：Python 3.10+，需配置 LLM API Key 与数据源账号
- 其他依赖：LangGraph/LangChain 编排，ChromaDB 记忆，AKShare/Tushare/BaoStock/yfinance 等数据接口，报告导出用 python-docx/pypandoc/pdfkit
功能亮点
- 多智能体分析框架：tradingagents/agents 下分分析师、研究员、经理、风控、交易员等角色，由 tradingagents/graph 用 LangGraph 编排并支持反思记忆。
- 多 LLM 提供商接入：llm_clients 支持 OpenAI/Google/Anthropic，llm_adapters 含通义 DashScope、DeepSeek 及 OpenAI 兼容端点，模型选择可持久化。
- 多数据源同步：cli 下 tushare/akshare/baostock 初始化脚本，app 提供 multi_source_sync、multi_market_stocks 等路由，覆盖 A股/港股/美股与多级降级。
- Web 平台与用户系统：app/routers 含 auth_db、角色权限中间件、operation_logs、system_config 等，前端含 Dashboard、个股详情、分析页。
- 模拟交易与智能筛选：app/routers/paper.py 与前端 PaperTrading 视图提供虚拟交易环境；screening 与 enhanced_screening 做多维度选股。
- 报告导出与实时通知：reports.py 支持 Markdown/Word/PDF 导出；sse.py 与 websocket_notifications.py 提供 SSE+WebSocket 实时进度推送。
安装与部署提示
1. 安装依赖：Python 3.10+，执行 `pip install -e .`（或 uv），按 .env.example 填写 LLM 与数据源密钥。
2. 准备数据库：部署 MongoDB 与 Redis，按 docker-compose.yml 或 .env.docker 配置连接信息。
3. 启动服务：后端 `uvicorn app.main:app`，前端 `npm run dev`（需 Node），或直接使用 Docker Compose 一键启动。
截图与演示说明
- 前端 Dashboard 首页与左侧角色/权限菜单（frontend/src/views/Dashboard、SidebarMenu.vue）
- 个股详情页与单股分析页（Stocks/Detail.vue、Analysis/SingleAnalysis.vue）
- 模拟交易页（PaperTrading/index.vue）
- 报告详情页（Reports/ReportDetail.vue）
- 后端接口文档与配置管理页（app/routers/config.py、system_config.py）
常见问题
**运行前需要准备什么？**
需要 Python 3.10+、可用的 LLM API（OpenAI/Google/Anthropic 等）密钥，以及股票数据源账号（Tushare/AKShare/BaoStock 等）。
分析前务必先完成股票数据同步，否则结果会出现数据缺失或错误。
**适合二次开发吗？**
核心 tradingagents/ 与 cli/、web/ 为 Apache 2.0 开源，结构清晰、模块分明，适合学习多智能体编排与接入新数据源。
但 app/ 后端与 frontend/ 前端为专有组件，商业使用需联系作者获取授权。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
另：本项目采用混合许可证，tradingagents/、cli/、web/ 等为 Apache 2.0 开源，可自由用于个人学习；但 app/（FastAPI 后端）与 frontend/（Vue 前端）为专有组件，商业使用需获得作者授权（hsliup@163.com）。下载用于学习研究请遵守对应许可证与版权规定。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本项目定位为研究与教育用途，不提供实盘交易指令，投资有风险，决策需谨慎。
GitHub项目开源地址：https://github.com/hsliuping/TradingAgents-CN