TradingAgentsCN 使用教程

📖 项目简介

TradingAgents-CN 是一个基于多智能体 + 大语言模型（LLM）的中文量化分析学习平台。它通过 6 个 AI 智能体协同工作，从技术面、基本面、消息面等多维度对标的进行全方位分析，最终生成专业的分析报告。

项目基于 Tauric Research 团队的 TradingAgents 框架进行中文增强，全面支持 A股、港股、美股数据，并集成了国产大模型（DeepSeek、通义千问等），是学习 AI 量化分析的绝佳工具。

💡

GitHub 地址： https://github.com/hsliuping/TradingAgents-CN

⚠️

风险提示：本框架仅用于研究和教育目的，不构成投资建议。AI 模型的预测存在不确定性，投资有风险，决策需谨慎。

✨ 核心亮点

🤖

多智能体协同

6 个 AI 智能体分工协作，技术面、基本面、消息面全覆盖

🧠

多 LLM 支持

支持 OpenAI、Gemini、DeepSeek、通义千问等多种大模型

🌍

全市场覆盖

完整支持 A股、港股、美股数据分析

🐳

Docker 一键部署

支持 Docker 多架构部署，5 分钟快速启动

📊

专业报告导出

支持 Markdown / Word / PDF 多格式报告导出

🆓

开源免费

GitHub 22K Star，个人使用完全免费

🏗️ 技术架构

v1.0.0-preview 版本采用全新架构：

后端：FastAPI + Uvicorn，提供 RESTful API
前端：Vue 3 + Vite + Element Plus，现代化单页应用
数据库：MongoDB + Redis 双数据库架构，性能提升 10 倍
数据源：统一管理 Tushare、AkShare、BaoStock 多个数据源
部署：Docker 多架构支持（amd64 + arm64）

🚀 快速开始

方式一：Docker 部署（推荐）

克隆项目

                        bash
                        git clone https://github.com/hsliuping/TradingAgents-CN.git
cd TradingAgents-CN
                    

配置环境变量

复制 .env.example 为 .env，填入大模型 API Key 和数据源配置。

                        bash
                        cp .env.example .env
# 编辑 .env 文件，填入 API Key
                    

启动服务

                        bash
                        docker-compose up -d
                    

启动后访问 http://localhost:8080 即可使用。

方式二：绿色版安装（Windows 用户）

下载绿色版压缩包，解压后双击启动即可，无需安装任何依赖。适合快速体验。

方式三：本地源码安装（开发者）

安装依赖

                        bash
                        pip install -r requirements.txt
                    

启动后端

                        bash
                        python main.py
                    

⚠️

重要提醒：在分析之前，请先按文档要求将数据同步完成，否则分析结果可能出现数据错误。

📋 分析流程

输入标的代码

在搜索框输入 A股/港股/美股代码，如 000001（平安银行）。

选择分析模型

选择要使用的大模型（OpenAI / DeepSeek / 通义千问等），系统会根据任务自动匹配最佳模型。

等待多智能体分析

6 个 AI 智能体同时启动，实时显示分析进度。技术分析师、基本面分析师、消息面分析师等各司其职。

查看分析报告

分析完成后生成专业报告，支持导出为 Markdown / Word / PDF 格式。

❓ 常见问题

Q: 支持哪些大模型？

支持 OpenAI（GPT-4 等）、Google Gemini、DeepSeek、通义千问等多种大模型。可在配置管理中心动态添加和切换。

Q: 数据源从哪里获取？

支持 Tushare、AkShare、BaoStock 三大数据源，涵盖 A股、港股、美股的行情、财务、新闻等数据。

Q: 可以用来实盘交易吗？

本项目定位为学习与研究平台，不提供实盘交易功能。分析结果仅供参考，不构成投资建议。

Q: 对电脑配置有什么要求？

推荐 8GB 以上内存。使用 Docker 部署需要安装 Docker Desktop。本地源码安装需要 Python 3.10+。