# MetricBot

**Repository Path**: zhenglv123456/metric-bot

## Basic Information

- **Project Name**: MetricBot
- **Description**: MetricBot是基于指标模型的AI数据分析智能体开源项目，通过Text2MQL2SQL等指标语义模型实现sql生成和chatBI。持续迭代的核心功能有指标口径问答、chatBI、sql智能生成、指标资产&血缘可视化、指标预警等

- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-11-18
- **Last Updated**: 2025-11-25

## Categories & Tags

**Categories**: ai

**Tags**: None

## README

# MetricBot

### 介绍
MetricBot是基于指标模型的AI数据分析智能体单体应用开源项目，通过Text2MQL2SQL等指标语义模型实现sql生成和chatBI。持续迭代的核心功能有指标口径问答、chatBI、sql智能生成、指标资产&血缘可视化、指标预警等。

如果该项目对您有帮助，请帮忙点个Star吧！！！



## 软件架构
项目是基于dcluster开源指标数据中台+python重构的敏捷轻量级指标AI智能体单体应用。 \
前端：基于python实现的flet构建 \
后端：python实现 \
特性：支持跨平台部署，一份代码同时支持windows、linux等平台部署


##  使用场景

适用于希望快速敏捷进行指标资产管理、AI智能生成sql、ChatBi问答、指标口径问答的数据业务各场景。

| 场景          | 描述                            | 典型用户类型             |
| ----------- | ----------------------------- | ------------------ |
| **指标管理**  | 统一定义业务指标口径和指标语义，构建指标资产字典。 | 数据工程师、数据分析师、数据产品、业务人员     |
| **智能指标口径问答** | 通过AI快速查询用户需要的指标语义数据，快速定位指标口径。    | 数据工程师、数据分析师、数据产品、业务人员    |
| **智能生成sql**  | 针对众多临时取数需求，想要快速生成通用sql模板，在此基础上进行修改，提升取数效率。   | 数据工程师、数据分析师、数据产品、业务人员  |
| **智能可视化图表生成ChatBI** | 希望输入自然语言查询出可视化图表数据。 | 数据工程师、数据分析师、数据产品、业务人员  |
| **指标资产血缘追踪** | 希望对指标资产可以进行可视化血缘查询管理。 | 数据工程师、数据分析师、数据产品、业务人员  |   

## ✅ 已有功能一览

| 模块   | 描述                                                                                        |
|------|-------------------------------------------------------------------------------------------|
| 指标管理 | 管理指标语义定义，支持指标模板下载、导入，支持指标新增、删除、导出。  |
| 模型管理 | 管理大模型配置，支持新增、修改、删除。  |
| 数据源管理 | 管理数据源配置，支持新增、修改、删除。  |
| AI指标口径问答 | 通过自然语言查询相关指标定义口径信息，返回相关的指标口径。  |
| AI生成SQL | 通过自然语言生成SQL查询模板。  |
| AI生成数据 | 通过自然语言生成数据可视化图表。  |


## 🚧 未来计划

| 模块   | 描述                                                                                        |
|------|-------------------------------------------------------------------------------------------|
| 指标资产 | 指标资产血缘可视化展示和查询。  |
| 模型管理 | 新增更多大模型支持。  |
| 数据源管理 | 新增更多数据源支持。  |
| AI指标口径问答 | 优化用户体验。  |
| AI生成SQL | 持续迭代优化。  |
| AI生成数据 | 持续迭代优化。  |
| 指标预警 | 设置指标目标预警管理。  |
| 数据分析 | AI数据分析。  |
| 指标归因 | 指标归因拆解分析。  |

## 快速开始 🚀

下载一键启动包，解压直接使用（路径不要有 **中文**、**特殊字符**、**空格**）

### Windows
- 夸克网盘（MetricBot 1.1.0 最新版本20251125）: https://pan.quark.cn/s/313bba81260c
- java8 window 安装包：https://pan.quark.cn/s/815bef8137b5

下载后，需要先安装java,然后配置JAVA_HOME \
确认Java环境配置好后，直接点击exe文件即可启动。

java环境配置文档（已配置忽略）：\
使用指南文档：

#### 其他系统

还没有制作，后续更新


## 功能配图
|![数据源管理.png](imgs/%E6%95%B0%E6%8D%AE%E6%BA%90%E7%AE%A1%E7%90%86.png) | ![大模型管理.png](imgs/%E5%A4%A7%E6%A8%A1%E5%9E%8B%E7%AE%A1%E7%90%86.png) |
|-|----------------------------------------------|
 |![AI问数折线图.png](imgs/AI%E9%97%AE%E6%95%B0%E6%8A%98%E7%BA%BF%E5%9B%BE.png)   |![top折线图.png](imgs/top%E6%8A%98%E7%BA%BF%E5%9B%BE.png)   |
| ![指标管理.png](imgs/%E6%8C%87%E6%A0%87%E7%AE%A1%E7%90%86.png)| ![AI指标口径问答.png](imgs/AI%E6%8C%87%E6%A0%87%E5%8F%A3%E5%BE%84%E9%97%AE%E7%AD%94.png) |
| ![AI数据生成.png](imgs/AI%E6%95%B0%E6%8D%AE%E7%94%9F%E6%88%90.png) | ![AI生成sql.png](imgs/AI%E7%94%9F%E6%88%90sql.png) |




## 协议

该项目支持个人和企业使用，如果您有商业化需求，请联系商业化授权。