Skip to content
apconwPublic

About

Aix-DB 基于 LangChain/LangGraph 框架,结合 MCP Skills 多智能体协作架构,实现自然语言到数据洞察的端到端转换。

Topics

Resources

Security policy

Stars

2.3k stars

Watchers

22 watching

Forks

Repository files navigation

Aix-DB

Aix-DB - 大模型数据助手

基于大语言模型和RAG技术的智能数据分析系统,实现对话式数据分析(ChatBI),快速实现数据提取与可视化

Release Version GitHub Stars License Docker Pulls

简体中文 | English

项目介绍

Aix-DB 基于 LangChain/LangGraph 框架,结合 MCP Skills 多智能体协作架构,实现自然语言到数据洞察的端到端转换。

核心能力:智能问答 · 数据问答(Text2SQL) · 表格问答 · 深度问数 · 数据可视化 · MCP 多智能体 · Skill 模式

产品特点:📦 开箱即用 · 🔒 安全可控 · 🔌 易于集成 · 🎯 越问越准 · 🧩 Skill 模式 · 🐾 OpenClaw 智能集成

Aix-DB Pro 商业版

让数据分析从一句提问开始,让业务洞察沉淀为报告与看板。

Aix-DB Pro 面向企业业务分析场景,将自然语言问数、图表分析、报告中心与数据看板融于一体。从日常数据查询到经营指标追踪,用对话探索数据,让分析成果持续复用。

  • 对话式数据分析:用自然语言提问,结合明细表格与可视化图表查看结果、继续追问。
  • 智能数据看板:集中呈现核心指标、同比环比与趋势,通过对话补充和调整图表。
  • 报告中心:集中管理分析报告,支持预览、下载、分享与回溯原始对话。
  • 丰富的可视化表达:覆盖指标卡、趋势图、分布图、热力图等多种业务分析视角。
商务合作与 POC 体验:个人微信二维码 商务合作 & 体验 POC,请添加我的微信

微信号:weber812
添加时请备注:商务合作 / POC 体验

欢迎交流企业数据分析需求、预约商业版演示,探讨业务场景验证与落地方案。

商业版支持的数据库

MySQL PostgreSQL Oracle SQL Server

ClickHouse Apache Hive Apache Doris StarRocks

达梦 DM 金仓 KingbaseES V8 GaussDB 主备版 MogDB

GBase 8a GBase 8c(MySQL 协议) 崖山 YashanDB 虚谷 Xugu

PolarDB MySQL PolarDB PostgreSQL OceanBase(MySQL 模式) TiDB

TDSQL MySQL TDSQL PostgreSQL AnalyticDB MySQL AnalyticDB PostgreSQL

Hologres Greenplum SelectDB GaussDB DWS

Databend MaxCompute

商业版产品预览

Aix-DB Pro 首页:普通模式与报告模式,自然语言发起数据分析
统一分析入口 · 从业务问题开启数据探索

商业版数据看板:销售额、订单数、客户数与物流指标
数据看板
核心指标、同比环比与业务趋势一屏掌握
商业版看板对话:通过自然语言补充和调整图表
对话式看板编辑
边看边问,用自然语言完善分析视角
商业版报告中心:报告时间线、预览、下载与分享
报告中心
沉淀分析成果,让报告可查阅、可分享
商业版数据问答:出货明细统计与月度金额数量趋势
数据问答与图表分析
从明细到趋势,在对话中持续深入分析
展开查看完整看板长图 · 更多图表与分析场景

商业版完整看板:指标卡、折线图、饼图、热力图、散点图、箱线图、漏斗图及明细表

以上为商业版界面展示,点击图片可查看原图。

演示视频

🎯 Skill 模式 💬 标准模式
2.7.1.2.mp4
default.mp4
🧩 Skill 技能中心 🐾 OpenClaw 模式
default.mp4
4.11.1.mp4

💰 赞助商展示

Doloffer IP数据云
doloffer IP数据云
APIMart 感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,通过此注册链接注册即可开用。

系统架构

系统架构图

分层架构设计:

  • 前端层:Vue 3 + TypeScript 构建的现代化 Web 界面,集成 ECharts 和 AntV 可视化组件
  • API 网关层:基于 Sanic 的高性能异步 API 服务,提供 RESTful 接口和 JWT 认证
  • 智能服务层:LLM 服务、Text2SQL Agent、RAG 检索引擎、MCP 多智能体协作
  • 数据存储层:支持多种数据库类型,包括关系型数据库、向量数据库、图数据库和文件存储

支持的数据源

数据问答核心流程

步骤 模块 说明
1 用户输入 用户以自然语言提出数据查询问题
2 LLM 意图理解 大模型解析问题意图,抽取关键实体和查询条件
3 RAG 知识检索 Embedding + BM25 混合检索,结合 Neo4j 图谱获取相关表结构和业务知识
4 SQL 生成 Text2SQL 引擎生成 SQL 语句,并进行语法校验和优化
5 数据库执行 在目标数据源执行 SQL,支持 8+ 种数据库类型
6 可视化展示 自动生成 ECharts/AntV 图表,直观呈现分析结果

快速开始

使用 Docker 部署(推荐)

docker run -d \
  --name aix-db \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e SERVER_HOST=0.0.0.0 \
  -e SERVER_PORT=8088 \
  -e SERVER_WORKERS=2 \
  -e LANGFUSE_TRACING_ENABLED=false \
  -e LANGFUSE_SECRET_KEY= \
  -e LANGFUSE_PUBLIC_KEY= \
  -e LANGFUSE_BASE_URL= \
  -e VITE_ENABLE_PAGE_AGENT=false \
  -e LLM_MAX_TOKENS=65536 \
  -p 18080:80 \
  -p 18088:8088 \
  -p 15432:5432 \
  -p 9000:9000 \
  -p 9001:9001 \
  -v ./volume/pg_data:/var/lib/postgresql/data \
  -v ./volume/minio/data:/data \
  -v ./volume/logs/supervisor:/var/log/supervisor \
  -v ./volume/logs/nginx:/var/log/nginx \
  -v ./volume/logs/aix-db:/var/log/aix-db \
  -v ./volume/logs/minio:/var/log/minio \
  -v ./volume/logs/postgresql:/var/log/postgresql \
  --add-host host.docker.internal:host-gateway \
  crpi-7xkxsdc0iki61l0q.cn-hangzhou.personal.cr.aliyuncs.com/apconw/aix-db:1.2.4

使用 Docker Compose

git clone https://github.com/apconw/Aix-DB.git
cd Aix-DB/docker
cp .env.template .env  # 复制环境变量模板,按需修改(推荐开启 VITE_ENABLE_PAGE_AGENT=true)
docker-compose up -d

访问系统

Web 管理界面

PostgreSQL 数据库

  • 连接地址:localhost:15432
  • 数据库名:aix_db
  • 用户名:aix_db
  • 密码:1

本地开发

① 克隆项目

git clone https://github.com/apconw/Aix-DB.git
cd Aix-DB

② 启动依赖中间件(PostgreSQL、MinIO 等)

cd docker
docker-compose up -d

③ 配置环境变量

编辑项目根目录下的 .env.dev,按需修改数据库连接、MinIO 地址等配置(默认配置可直接使用)

④ 安装 Python 依赖(需要 Python 3.11)

# 方式一:pip
pip install -r requirements.txt

# 方式二:uv(推荐,更快)
uv venv --python 3.11
source .venv/bin/activate
uv sync

⑤ 启动后端服务

# Windows PowerShell 专属命令:设置环境变量+运行脚本,一行执行  增加字符兼容性,解决有些机器错误问题。
$env:PYTHONUTF8=1; python serv.py

⑥ 启动前端开发服务器(另开终端)

cd web
npm install
npm run dev

命令行工具(CLI)

npm version

通过终端直接发起自然语言数据查询,支持图表渲染输出。

# 安装
npm install -g @apconw/aix-db-cli

# 登录(浏览器完成认证,token 有效期 7 天)
aix-db-cli login

# 查看可用数据源
aix-db-cli datasources

# 数据问答
aix-db-cli chat "有哪些数据表?" --datasource 48
aix-db-cli chat "查询销售额趋势" --datasource 48 --stream

详细文档见 aix-db-cli/README.md。

技术栈

后端:Sanic · SQLAlchemy · LangChain/LangGraph · Neo4j · FAISS/Chroma · MinIO

前端:Vue 3 · TypeScript · Vite 5 · Naive UI · ECharts · AntV

AI 模型:OpenAI · Anthropic · DeepSeek · Qwen · Ollama

🤝 成为赞助者

成为赞助者,可以将您的产品展示在这里,每天获得大量曝光!

联系方式:微信 weber812(备注:赞助合作)

贡献指南

欢迎提交 Issue 和 Pull Request!

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 提交 Pull Request

Star History

Star History Chart

开源许可

本项目采用 Apache License 2.0 开源许可证。

About

Aix-DB 基于 LangChain/LangGraph 框架,结合 MCP Skills 多智能体协作架构,实现自然语言到数据洞察的端到端转换。

Topics

Resources

Security policy

Stars

2.3k stars

Watchers

22 watching

Forks

Releases

Packages

Contributors

Languages