hsliuping/TradingAgents-CN - 项目详情

项目介绍快速开始学习路径贡献者 17 增长趋势代码统计生态关系项目时间线项目竞品依赖分析上榜历史

5分钟快速启动 TradingAgents-CN

通过 Docker 快速部署并启动 TradingAgents-CN 平台，体验多智能体股票分析功能。

环境要求

支持的操作系统

Windows macOS Linux

运行环境

Docker >= 20.10 必需

Docker Compose >= 2.0 必需

所需工具

Git

克隆项目代码

必需

操作步骤

克隆项目代码

从 GitHub 获取项目源代码。

克隆仓库到本地

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

进入项目目录

cd TradingAgents-CN

预期结果：项目目录 `TradingAgents-CN` 被成功创建。

如果网络较慢，可以尝试使用镜像源或直接下载 ZIP 包。

配置环境变量

复制环境变量模板文件，为后续启动做准备。

复制环境变量文件

cp .env.example .env

预期结果：当前目录下生成 `.env` 文件。

首次体验可以暂时使用默认配置，无需修改 `.env` 文件。

启动 Docker 服务

使用 Docker Compose 一键启动所有服务（后端、前端、数据库）。

在后台启动所有容器

docker-compose up -d

预期结果：终端显示正在拉取镜像和启动容器，最终显示容器状态为 `Up`。

首次运行需要下载镜像，时间取决于网络速度，请耐心等待。

访问 Web 界面

在浏览器中打开平台前端界面。

预期结果：打开浏览器，访问 http://localhost:5173，看到 TradingAgents-CN 的登录/注册界面。

如果端口 5173 被占用，请检查 `.env` 文件中的 `VITE_APP_PORT` 配置，并访问对应的端口。

验证成功

通过以下方式确认平台已成功运行：

Docker 容器全部处于运行状态（`docker-compose ps`）。

浏览器能正常访问 http://localhost:5173 并看到登录界面。

可以使用默认账号（如 admin/admin123）登录系统。

快速提示

配置

首次启动后，建议先在平台内配置一个可用的 LLM API Key（如 OpenAI 或 DeepSeek），否则无法进行股票分析。

调试

使用 `docker-compose logs -f [service_name]` 可以实时查看特定服务（如 app, frontend）的日志，便于调试。

其他

项目数据默认存储在 Docker 卷中。彻底删除项目时，记得使用 `docker-compose down -v` 来清理数据卷。

常见问题

访问 http://localhost:5173 时页面无法打开或连接被拒绝。

1. 检查 Docker 服务是否运行：`docker-compose ps`。 2. 检查前端容器日志：`docker-compose logs frontend`。 3. 确认宿主机防火墙是否放行了对应端口。

启动容器时提示端口冲突（如 5173 端口已被占用）。

修改项目根目录下 `.env` 文件中的 `VITE_APP_PORT` 变量，将其改为一个未被占用的端口（如 5174），然后重新运行 `docker-compose up -d`。

登录后无法进行股票分析，提示“模型未配置”或类似错误。

这是正常现象，因为尚未配置 AI 模型。请进入平台的管理后台或设置页面，添加一个可用的 LLM API 密钥（如 OpenAI、Gemini 或 DeepSeek）。

下一步

配置 AI 模型

在平台设置中添加你的 LLM API Key，以启用智能分析功能。

同步股票数据

按照文档指引，配置并同步 A 股、港股或美股的基础数据，确保分析结果准确。

阅读详细使用指南

访问项目文档或公众号，学习平台的全部功能和使用技巧。