A 股智能金融情报 Multi-Agent 系统
基于 LangGraph + AkShare + LLM 的开源金融分析平台
FinAgent 是一个面向 A 股市场 的开源 Multi-Agent 智能金融情报系统，通过多个专业 AI Agent 协作完成：
- 📊 市场监控 — 实时异动检测、大单追踪、资金流向分析
- 📰 新闻舆情 — 财经新闻聚合、NLP 情绪分析、事件驱动识别
- 📝 研报自动生成 — 个股/行业深度分析报告（基本面+技术面+资金面三维分析）
- 💼 投资组合分析 — 风险评估、历史回测、组合优化
当前版本聚焦 数据链路准确性验证，通过 RESTful API 提供所有能力
- ✅ 四大 Agent 模块全部可用
- ✅ LangGraph StateGraph 工作流编排
- ✅ FastAPI + Swagger UI 交互
- ✅ MySQL 数据持久化
- ✅ 支持 OpenAI / DeepSeek / 通义千问 多模型切换
- ❌ 前端 Dashboard（规划中）
- ❌ PDF/Word 导出（数据验证通过后加入）
- Python >= 3.11
- MySQL >= 8.0
- uv (推荐) 或 pip
# 克隆项目
git clone https://github.com/your-org/finagent.git
cd finagent
# 创建虚拟环境并安装依赖
uv sync
# 配置环境变量
cp .env.example .env
# 编辑 .env 填入你的 LLM API Key 和数据库信息
# 初始化数据库
python scripts/init_db.py
# 启动服务
uv run python src/main.py服务启动后访问:
- API 文档: http://localhost:8000/docs (Swagger UI)
- ReDoc: http://localhost:8000/redoc
| 层级 | 选型 |
|---|---|
| Multi-Agent 框架 | LangGraph (StateGraph) |
| LLM | OpenAI GPT-4o / DeepSeek / 通义千问 |
| Web 服务 | FastAPI + Uvicorn |
| 数据库 | MySQL 8.x (SQLAlchemy 2.0 async) |
| A 股数据源 | AkShare |
| 数据分析 | Pandas, NumPy, TA-Lib |
| 包管理 | uv |
finagent/
├── src/
│ ├── agents/ # Multi-Agent 核心（4 组 Agent）
│ │ ├── market_monitor/ # 市场监控 Agent
│ │ ├── news_sentiment/ # 新闻舆情 Agent
│ │ ├── report_gen/ # 研报生成 Agent (6-Agent 流水线)
│ │ └── portfolio/ # 投资组合 Agent
│ ├── tools/ # 通用工具层（数据源/LLM/计算器）
│ ├── api/ # FastAPI 路由层
│ ├── models/ # ORM 数据模型
│ └── services/ # 业务服务层
├── tests/ # 测试套件
├── scripts/ # 运维脚本
└── docs/ # 项目文档
# 运行测试
uv run pytest tests/ -v
# 运行特定模块测试
uv run pytest tests/test_agents/test_market_monitor.py -v
# 代码格式化
# (待配置 ruff/pre-commit)本项目生成的所有内容 仅供研究参考，不构成任何投资建议。股市有风险，投资需谨慎。
欢迎提交 Issue 和 Pull Request！详见 贡献指南。