Aix-DB - 大模型数据助手

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

简体中文 | English

项目介绍

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

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

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

演示视频

🎯 Skill 模式	💬 标准模式
🧩 Skill 技能中心	🐾 OpenClaw 模式

联系我们

无论是项目部署、技术咨询还是商务合作，欢迎随时扫码添加微信沟通：

微信公众号	个人微信
关注公众号获取最新动态	添加时请备注：技术支持&商务合作

🎯 技术社群（365元）	🚀 定制开发（1000元起）
我将亲自远程帮您 环境配置与项目部署（Openclaw&Aix-DB） 提供项目 全部资料（源码、文档、配置模板） 专属技术支持群，每日AI咨询 & 飞书文档 & 社群互助 帮你开通 Claude / Codex / Gemini 账号 项目实战：VibeCoding实操 & 数据问答 Skill开发	按需求定制功能开发 Openclaw 定制化部署 企业级场景适配与对接 一对一技术咨询

📅 定期组织腾讯会议	开展群内答疑，集中解决部署、分享最新技术落地案例实操
🖥️ 典型问题远程演示	针对高频难点，屏幕共享实操讲解，看得懂、学得会
💡 二次开发思路分享	Vibe Coding方式根据自己需求定制开发实战案例分享
🔔 项目更新同步	第一时间发布版本迭代、Bug 修复与新功能进展

🗂️ 数据问答领域	面向企业数据分析场景，提供 Text2SQL、智能报表、数据可视化等端到端解决方案
🤖 OpenClaw 多智能体搭建	基于 OpenClaw 平台，为企业定制多智能体协作系统，实现复杂业务流程的智能化
🎯 特定领域 SKILL 开发	根据行业特点与业务需求，定制开发专属 SKILL 指令集，提升 Agent 在垂直领域的专业能力
💬 方案咨询与交流	无论您有任何技术疑问或业务想法，欢迎随时联系我，一起探讨最适合您的落地方案

系统架构

分层架构设计：

• 前端层：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 管理界面

• 访问地址：http://localhost:18080
• 默认账号：admin
• 默认密码：123456

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

技术栈

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

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

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

贡献指南

欢迎提交 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

开源许可

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

Aix-DB 快速上手指南

Aix-DB 是一款基于大语言模型和 RAG 技术的智能数据分析系统，支持对话式数据查询（ChatBI）、Text2SQL 及数据可视化。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux / macOS / Windows (推荐 WSL2)
• 容器环境：Docker & Docker Compose (部署推荐)
• 开发环境 (如需源码开发)：
  • Python 3.11+
  • Node.js 18+ & npm
  • Git
• 硬件建议：至少 4GB 可用内存（运行依赖中间件），建议 8GB+

2. 安装步骤

方案一：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 部署

适合需要自定义配置或进行集群管理的场景。

# 1. 克隆项目
git clone https://github.com/apconw/Aix-DB.git
cd Aix-DB/docker

# 2. 配置环境变量
cp .env.template .env
# 可选：编辑 .env 文件，推荐开启 VITE_ENABLE_PAGE_AGENT=true

# 3. 启动服务
docker-compose up -d

方案三：本地源码开发

适合需要修改代码或贡献功能的开发者。

1. 克隆项目并启动依赖中间件

git clone https://github.com/apconw/Aix-DB.git
cd Aix-DB
cd docker
docker-compose up -d
cd ..

2. 配置环境变量 编辑根目录下的 .env.dev 文件，确认数据库连接和 MinIO 地址配置无误（默认配置通常可直接使用）。

3. 安装后端依赖 (Python 3.11) 推荐使用 uv 进行快速安装：

uv venv --python 3.11
source .venv/bin/activate  # Windows PowerShell 使用: .venv\Scripts\Activate.ps1
uv sync
# 或使用 pip: pip install -r requirements.txt

4. 启动后端服务

# Windows PowerShell 专属命令（解决编码兼容性问题）
$env:PYTHONUTF8=1; python serv.py

# Linux/Mac 用户直接运行
python serv.py

5. 启动前端服务 新开一个终端窗口：

cd web
npm install
npm run dev

3. 基本使用

访问系统

部署完成后，通过浏览器访问：

• Web 管理界面：http://localhost:18080
• 默认账号：admin
• 默认密码：123456

(若使用本地开发模式，前端地址通常为 http://localhost:5173)

核心操作流程

1. 连接数据源 登录系统后，进入数据源配置页面。Aix-DB 支持 MySQL, PostgreSQL, Oracle, SQL Server, ClickHouse, Doris, StarRocks 以及 CSV/Excel 文件。输入相应的连接信息并测试连接。

2. 发起对话查询 在对话框中输入自然语言问题，例如：

   "显示上个月销售额最高的前 10 个产品" "对比今年和去年的用户增长趋势"

3. 查看结果与可视化 系统将自动执行以下步骤：

   • 意图理解：LLM 解析您的问题。
   • SQL 生成：自动编写并优化 SQL 语句。
   • 数据执行：在您连接的数据库中运行查询。
   • 图表展示：自动生成 ECharts 或 AntV 图表呈现结果。

4. 进阶功能

   • Skill 模式：针对特定业务场景定制指令集，提高回答准确率。
   • 多智能体协作：利用 MCP 架构处理复杂的多步数据分析任务。

验证数据库连接 (可选)

如果您需要直接访问内置的 PostgreSQL 数据库进行调试：

• 地址：localhost:15432
• 库名：aix_db
• 用户：aix_db
• 密码：1