Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Fin-Agent 是一个基于 DeepSeek 等大模型和 Tushare 金融数据的智能金融分析助手。它能够通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取市场指标、选股筛选以及策略回测，并提供投资参考建议。
| Date | Stars |
|---|---|
| 2026-07-31 | 307 |
| 2026-08-03 | 309 |
| 2026-08-06 | 309 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
0.0
growth rate 0.00%/day
# Fin-Agent: 智能金融分析助手
<div align="center">
[](https://www.fin-agent.chat/)
[](https://pypi.org/project/fin-agent/)
[](https://pypi.org/project/fin-agent/)
[](https://github.com/YUHAI0/fin-agent/blob/main/LICENSE)
[](https://github.com/YUHAI0/fin-agent)
[](https://github.com/YUHAI0/fin-agent/commits/main)
[](https://github.com/YUHAI0/fin-agent)
</div>
> 🎉 **桌面版已发布！** 想要更便捷的使用体验？[**点击前往 Fin-Agent Desktop**](https://github.com/YUHAI0/fin-agent-desktop) - 基于 Electron 的图形界面版本，功能更强大，操作更简单！
Fin-Agent 是一个基于 **DeepSeek** 等大模型和 **Tushare** 金融数据的智能金融分析助手。它能够通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取**宏观数据**、市场指标、**选股筛选**以及**策略回测**，并提供投资参考建议。
**全新升级**：
- 🔔 **股价预警**：支持自然语言设置涨跌幅提醒，即时推送到邮箱。
- 📊 **投资组合**：支持模拟持仓管理与即时盈亏统计。
- 👤 **用户画像**：自动记忆投资风格（如保守/激进）、偏好板块等，提供个性化建议。
- 🔍 **智能选股**：通过自然语言描述选股条件，AI 自动筛选符合条件的股票。**特别强调长尾选股功能**，能够挖掘被市场忽视的潜力标的，发现隐藏的投资机会。
## ✨ 主要功能
- **自然语言交互**：直接使用中文与 AI 对话，无需记忆复杂的命令或代码。
- **智能诊断**：结合 LLM 的分析能力，对获取的数据进行解读和总结。
- **全面的 Tushare 支持**：覆盖个股、大盘、**宏观数据**（GDP、CPI、M2、利率）、资金、财务、热点等全方位数据。
- **多模型驱动**：
- **国内主流大模型**: DeepSeek, Kimi (Moonshot), 智谱 (GLM-4), 阿里 (Qwen), 零一万物 (Yi), 硅基流动 (SiliconFlow)。
- **本地模型**: 支持 Ollama, LM Studio 等本地部署的 OpenAI 兼容模型。
- **智能选股器**：通过自然语言描述选股条件（基本面、技术面、行业等），Agent 自动转换为筛选参数并返回结果。
- **策略回测引擎**：基于 Tushare 日线、可插拔策略注册；支持均线、MACD、RSI、KDJ、布林、动量及唐奇安/海龟、ADX 过滤、量价等 **20+** 种内置策略（详见下文「策略回测」），输出收益、回撤与权益曲线。
- **模拟投资组合**：支持模拟持仓管理，记录买入/卖出操作，实时查看组合市值、盈亏情况。
- **股价预警监控**：支持设置股价涨跌幅或目标价监控，触发条件后自动发送邮件提醒。
- **深度技术分析**：内置 MACD、RSI、KDJ、BOLL 等常见指标计算，并支持金叉/死叉、超买/超卖等形态的自动识别。
- **宏观数据查询**：支持 GDP、CPI、M2 货币供应量、利率（如 SHIBOR）等宏观经济指标查询，为自上而下投资分析提供数据支撑。
- **用户画像与偏好记忆**：自动记忆用户的投资风格（如保守/激进）、偏好板块等，提供个性化建议。
## 📦 安装
```bash
pip install fin-agent
```
## 🚀 快速开始
安装完成后，直接在终端运行以下命令启动：
```bash
fin-agent
```
首次运行会自动引导您配置 API Key。
## ⚙️ 配置说明
Fin-Agent 需要以下配置才能完整工作：
1. **Tushare Token**: 用于获取金融数据 ([注册 Tushare](https://tushare.pro/))
2. **LLM 设置**:
- 支持直接配置 API Key 使用在线商业模型。
- 也支持配置 Base URL 使用本地模型（如 Ollama）。
- 启动时会有向导指引您选择模型供应商。
## 💻 命令行参数
Fin-Agent 提供了一些实用的命令行参数来管理配置和版本：
| 命令 | 说明 |
| :--- | :--- |
| `fin-agent` | 启动交互式对话模式（默认） |
| `fin-agent --clear-token` | 清除现有的 API Key 配置。当需要更换 Token 或切换 LLM 提供商时使用。 |
| `fin-agent --upgrade` | 自动检查 PyPI 并升级到 Fin-Agent 的最新版本。如果遇到重大版本更新，会自动清除旧配置。 |
| `fin-agent --worker` | 启动 Worker 模式（仅运行后台调度任务，无聊天界面），用于持续监控预警任务。 |
| `fin-agent -v`, `--version` | 显示当前版本号。 |
| `fin-agent -h`, `--help` | 显示帮助信息和参数说明。 |
## ⏰ 如何启动股价监控
Fin-Agent 的股价预警监控功能需要程序保持运行才能持续生效。
**推荐方式（后台运行）：**
使用 `--worker` 模式启动一个专用的监控进程：
```bash
fin-agent --worker
```
此模式下没有聊天界面，程序会持续运行并在后台每分钟检查一次所有设置的预警条件。一旦触发，会通过配置的邮件发送提醒。
**交互模式：**
如果您正在使用默认的交互模式 (`fin-agent`)，监控功能也会在您与 Agent 对话的间隙自动运行。但如果您退出了交互模式，监控也会停止。
## 💬 场景示例
Fin-Agent 支持丰富的金融分析场景，您可以参考以下对话来探索它的能力：
### 1. 基础信息查询
> **用户**："平安银行属于什么行业？什么时候上市的？"
> **Agent**："平安银行（000001.SZ）属于银行行业，上市日期为 19910403。它是深圳本地的股份制商业银行..."
### 2. 实时行情与走势
> **用户**："现在的贵州茅台股价是多少？最近一周走势如何？"
> **Agent**："贵州茅台当前价格为 1750.00 元，今日下跌 0.5%。回顾过去一周（20240101-20240107），股价整体呈现震荡上行趋势，最高触及 1780 元..."
### 3. 大盘指数分析
> **用户**："今天大盘（上证指数）表现怎么样？"
> **Agent**："今日上证指数收于 3050 点，上涨 0.8%，成交量较昨日有所放大，市场情绪回暖..."
### 4. 估值与基本面
> **用户**："帮我看看万科A现在的估值高吗？"
> **Agent**："万科A当前的市盈率（PE）为 6.5 倍，市净率（PB）为 0.6 倍。与历史水平及同行业相比，当前估值处于较低位置..."
### 5. 财务业绩分析
> **用户**："宁德时代去年的营收和净利润是多少？"
> **Agent**："根据 2023 年年报，宁德时代实现营业收入 4009 亿元，同比增长 22%；净利润 441 亿元，同比增长 43%..."
### 6. 业绩预告筛选
> **用户**："最近有哪些公司发布了业绩预增公告？"
> **Excerpt of 9,360 characters
Read on GitHubWould you bet a product on this? Bounded 0–100 and slow moving.
matched fp:31211e7bab9ff346, llm:Repository description: 'Fin-Agent 是一个基于 DeepSeek 等大模型和 Tushare 金融数据的智能金融分析助手... 通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取市场指标、选股筛选以及策略回测，并提供投资参考建议.'
matched fp:31211e7bab9ff346, llm:Repository description: 'Fin-Agent 是一个基于 DeepSeek 等大模型和 Tushare 金融数据的智能金融分析助手... 通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取市场指标、选股筛选以及策略回测，并提供投资参考建议.'
matched fp:31211e7bab9ff346, llm:Repository description: 'Fin-Agent 是一个基于 DeepSeek 等大模型和 Tushare 金融数据的智能金融分析助手... 通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取市场指标、选股筛选以及策略回测，并提供投资参考建议.'
matched fp:31211e7bab9ff346, llm:Repository description: 'Fin-Agent 是一个基于 DeepSeek 等大模型和 Tushare 金融数据的智能金融分析助手... 通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取市场指标、选股筛选以及策略回测，并提供投资参考建议.'