TradingAgents-CN

环境要求

• Python 环境（后端为 FastAPI 应用，用 uvicorn 启动）
• Node.js / npm（前端为 Vue 3，需 npm install 与 npm run dev）
• MongoDB（需开启认证，authSource=admin，并自建管理员账号）
• Redis（需设置密码 requirepass）
• 可选：本机已安装 Docker，用于只跑 MongoDB 与 Redis 两个数据库

安装与启动步骤

1. 1获取项目代码

   从 GitHub 仓库克隆 TradingAgents-CN 并进入项目根目录，后续所有命令都在该目录下执行。

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

   复制

2. 2安装启动数据库

   项目不自带数据库，需先装并启动 MongoDB 与 Redis。这里用 Docker 方式跑两个库，密码与下一步 .env 保持一致；macOS 可用 brew、Ubuntu 可用 apt 安装。

   docker run -d --name ta-mongo -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=ta_pass_2024 mongo:8.0
   docker run -d --name ta-redis -p 6379:6379 redis:7-alpine redis-server --requirepass ta_pass_2024

   复制

3. 3创建配置文件

   复制示例配置生成 .env。Windows 用 copy 命令，Linux / macOS 用 cp 命令，在项目根目录执行。

   cp .env.example .env

   复制

4. 4填写必填配置

   按 .env.example 注释填写 MongoDB、Redis 连接信息与 JWT_SECRET，账号密码要与上一步启动数据库时设置的一致。

5. 5启动后端服务

   在项目根目录用 uvicorn 启动 FastAPI 后端，默认监听 8000 端口，与前端默认代理一致。

   uvicorn app.main:app

   复制

6. 6启动前端

   进入 frontend 目录安装依赖并启动开发服务器，默认访问地址为 http://localhost:3000。

   cd frontend
   npm install
   npm run dev

   复制

关键配置

如何确认成功

后端 8000 端口正常响应，浏览器打开 http://localhost:3000 能访问前端界面即启动成功。

常见问题

注意事项

• 本项目为研究辅助工具，所有 AI 生成内容仅供学习参考，不构成投资建议。
• README 节选中启动步骤从第 3 步开始，第 1、2 步（依赖安装等）未展示，请对照仓库完整文档补齐后再启动。
• 社区版与 Pro 版功能不同，Agent 工作坊、交易系统、定时/批量分析、专业报告导出等属于 Pro 版能力。
• MongoDB 需开启认证并使用 authSource=admin，自行创建管理员账号后再写入 .env。