qchen34--tradingagents
wehub-resource-sync
160 行
3.7 KiB
Markdown
160 行
3.7 KiB
Markdown
# 个性化多智能体金融分析工具
|
||
|
||
## 基于TradingAgents底层框架打造
|
||
|
||
- 【2026-04】搭建Webui仪表盘作为观察大盘数据的入口，个股分析作为TradingAgents分析工具的入口
|
||
- 【2026-04】后续预告：交易策略工具搭建中，包括回测，开仓信号，平仓信号等
|
||
|
||
基于 TradingAgents 多智能体框架，提供：
|
||
|
||
- 交互式 CLI 分析流程
|
||
- Streamlit WebUI（市场总览、个股分析、报告回看、持仓管理）
|
||
- 本地报告与快照持久化能力
|
||
|
||
> 仅用于研究与学习，不构成任何投资建议。
|
||
|
||
---
|
||
|
||
## 当前功能（WebUI）
|
||
|
||
WebUI 入口：`app.py`
|
||
|
||
一级页面（当前实现）：
|
||
|
||
1. **仪表盘**
|
||
- 指数、宏观代理、板块 Top3、Top10 新闻
|
||
- LLM 新闻立场与摘要
|
||
- LLM 大盘总结
|
||
- 手动刷新并写入快照（latest + history）
|
||
2. **个股分析**
|
||
- 启动分析任务、查看运行进度与日志
|
||
- 展示最新报告摘要
|
||
- 内嵌历史报告浏览
|
||
3. **策略**
|
||
- 当前为占位页（后续实现）
|
||
4. **股票筛选**
|
||
- 搜索/排序/查看 ticker
|
||
- 跳转股票详情页
|
||
5. **股票详情**
|
||
- 概览指标、最新分析引导、历史报告
|
||
6. **持仓**
|
||
- 本地持仓录入、同 ticker 合并、均价重算
|
||
|
||
产品规格文档见：`docs/webui_prd.md`
|
||
|
||
---
|
||
|
||
## 项目结构（核心目录）
|
||
|
||
```text
|
||
TradingAgents/
|
||
├── app.py # WebUI 入口
|
||
├── web/
|
||
│ ├── pages/ # 各页面实现
|
||
│ ├── services/ # 数据拉取/存储/LLM 服务
|
||
│ ├── theme.py # 全局主题样式
|
||
│ ├── sidebar_nav.py # 侧栏导航
|
||
│ ├── history.py # 报告历史扫描
|
||
│ └── report_viewer.py # 报告渲染
|
||
├── tradingagents/ # 多智能体核心框架
|
||
├── cli/ # CLI 入口与交互
|
||
├── docs/ # 文档
|
||
├── data/ # 本地运行数据（建议忽略运行产物）
|
||
├── reports/ # Web 分析报告输出（运行产物）
|
||
├── results/ # CLI 结果输出（运行产物）
|
||
└── eval_results/ # 评估日志输出（运行产物）
|
||
```
|
||
|
||
---
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
git clone https://github.com/qchen34/TradingAgents.git
|
||
cd TradingAgents
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
---
|
||
|
||
## 环境变量
|
||
|
||
至少配置一个 LLM Provider 的 Key（按需）：
|
||
|
||
```bash
|
||
export OPENAI_API_KEY=...
|
||
export SILICONFLOW_API_KEY=...
|
||
export GOOGLE_API_KEY=...
|
||
export ANTHROPIC_API_KEY=...
|
||
export XAI_API_KEY=...
|
||
export OPENROUTER_API_KEY=...
|
||
export ALPHA_VANTAGE_API_KEY=...
|
||
```
|
||
|
||
也可使用 `.env`：
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
---
|
||
|
||
## 启动方式
|
||
|
||
### 1) 启动 WebUI
|
||
|
||
```bash
|
||
streamlit run app.py
|
||
```
|
||
|
||
### 2) 启动 npm 前端 + Python API
|
||
|
||
```bash
|
||
# API
|
||
python -m uvicorn backend.api.main:app --host 127.0.0.1 --port 8000 --reload
|
||
|
||
# Frontend（新终端）
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
### 3) 一键并行启动（Streamlit + FastAPI + Next.js）
|
||
|
||
```bash
|
||
bash scripts/start_dual_stack.sh
|
||
```
|
||
|
||
### 或
|
||
### 4) 启动 CLI
|
||
|
||
```bash
|
||
python -m cli.main
|
||
# 或（安装后）
|
||
tradingagents
|
||
```
|
||
|
||
---
|
||
|
||
## 运行数据与输出目录说明
|
||
|
||
以下目录/文件通常为运行自动生成，建议加入 `.gitignore`：
|
||
|
||
- `eval_results/`
|
||
- `reports/`
|
||
- `results/`
|
||
- `data/dashboard/history/`
|
||
- `data/dashboard/latest.json`
|
||
- `data/cache/`
|
||
- `data/portfolio.json`
|
||
|
||
如果你希望仓库“干净可复现”，建议只保留代码与文档，运行产物不入库。
|
||
|
||
|
||
|
||
|
||
## 引用
|
||
|
||
本项目底层引用Tauric Research的TradingAgents框架：https://github.com/TauricResearch/TradingAgents |