hsliuping/TradingAgents-CN

TradingAgents‑CN Community Edition – 简介

TradingAgents‑CN 是一个结合开源与专有授权的平台，让您能使用多个 AI 代理 (LLMs) 来探索中国 A 股，这些代理扮演分析师、研究员与助理的角色。系统基于 FastAPI 后端 (Python 3.11) 与 Vue 3 前端构建，并使用 MongoDB 与 Redis 进行数据持久化。

核心理念

一组专业代理（例如：宏观分析师、行业分析师、基本面分析师、新闻分析师、乐观/理性研究员）在多轮对话中针对股票或市场主题进行辩论。
辩论结果以分层观点呈现，帮助使用者从不同角度审视研究问题。
使用者也可以透过自然语言查询进行临时研究、筛选股票，或使用“选股助理”根据描述匹配候选代码。
平台包含一个模拟交易沙盒以及一个提供免费课程与指南的小型学习中心。

主要功能 (如 README 所述)

功能	说明
个股研究	5 层深度、多代理辩论，提供多种视角。
一般研究	以自然语言询问任何市场问题；代理会协作回答。
股票筛选	针对 6,000 多个 A 股代码进行自然语言 + 条件筛选。
选股助理	描述投资论点；系统建议匹配的股票代码。
智慧助理	整合网页搜索、工具调用，以及跨会话的“AI 记忆”。
AI 记忆	存储事实与过往分析的项目级知识库。
技能中心	建立自定义数据获取“技能”（例如：新的数据源适配器）。
学习中心	免费结构化课程（目前版本包含 5 堂课）与 8 份学习指南。
模拟交易与回放	模拟交易与交易后检讨。

架构与技术堆栈

后端: FastAPI (app/main.py) 提供 REST 端点，运行于 Python 3.11。
前端: Vue 3 + TypeScript UI (frontend/)。
持久化: MongoDB (存储使用者数据、研究结果、代理配置) 与 Redis (缓存、会话状态)。
LLM 整合: 支持 OpenAI、DeepSeek、阿里云通义等；API 金钥设定于 .env 文件中。
数据来源: 公开中国市场 API – Tushare、AKShare、BaoStock – 用于价格/财务数据（使用者需自行取得 Token）。

授权

混合模式: 核心引擎 (tradingagents/、CLI、文档、测试) 为 Apache‑2.0 且可完全重复使用。应用层 (app/、frontend/、core/) 为源码可见但非商业用途；商业用途需另行授权。

目标受众

学生与爱好者：希望获得构建金融多代理 AI 工作流程实作经验的人。
研究人员：探索 LLM 驱动的代理如何协作进行量化/质化股票分析的人。
开发者：有兴趣扩展代理框架、新增数据适配器或构建自定义代理的人。

入门指南 (快速回顾)

安装 MongoDB 与 Redis (或执行提供的 Docker 指令)。
Clone 仓库，设定 Python 虚拟环境，安装 requirements.txt。
复制 .env.example 为 .env 并填入数据库凭证、JWT 密钥与 LLM API 金钥。
执行 uvicorn app.main:app (后端) 并在 frontend 目录内执行 npm run dev (UI)。
使用自动建立的账号登入 (admin / 密码来自 .env)。
在系统设置中配置您的 LLM 金钥，即可开始探索研究工具。

社区与贡献

本项目积极寻求贡献者（数据源适配器、Vue UI 工作、提示工程、文档）。贡献仅根据 PR 质量进行评估；需签署贡献者协议 (CLA)。

总结: TradingAgents‑CN 是一个真正的多代理 AI 研究助理，专注于中国股市，提供了一个如何编排 LLM 进行金融分析的具体范例，同时提供学习平台与适度的模拟交易沙盒。