一、开源项目简介

MetricBot

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

二、开源协议

使用AGPL-3.0开源协议

三、界面展示

功能配图

四、功能概述

使用场景

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

✅ 已有功能一览

 未来计划

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

五、技术选型

软件架构

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

快速开始

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

Windows

• 夸克网盘（MetricBot 1.2.0 最新版本20251204-特性：包体积优化、指标资产、可视化图表、分页表格、text2sql优化）: 详细内容请查看 README.md 文档
• java8 window 安装包：详细内容请查看 README.md 文档
• flet 初始化包：详细内容请查看 README.md 文档

第一次使用时，需要先下载初始化包，有些网络下下载很慢，提前准备好了，下载后放到C:\Users\~\ 具体的用户目录下解压,出现.flet目录则代表初始化好了；
下载后，需要先安装java,然后配置JAVA_HOME；
确认Java环境配置好后，直接点击exe文件即可启动。(初始化和JAVA_HOME配置一次就行)

java环境配置文档（已配置忽略）：
使用指南文档：
操作指南案例一：详细内容请查看 README.md 文档

其他系统

还没有制作，后续更新