Aix-DB - 大模型数据助手

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

简体中文 | English

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

核心能力：通用问答 · 数据问答（Text2SQL） · 表格问答 · 深度搜索 · 数据可视化 · MCP 多智能体

产品特点：📦 开箱即用 · 🔒 安全可控 · 🔌 易于集成 · 🎯 越问越准

演示视频

🎯 Skill 模式	💬 标准模式
aix-db.mp4	default.mp4

系统架构

分层架构设计：

• 前端层：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 \
  -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.2

使用 Docker Compose

git clone https://github.com/apconw/Aix-DB.git
cd Aix-DB/docker
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

⑤ 启动后端服务

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

文档

• 配置说明
• API 文档 (启动后访问)

贡献指南

欢迎提交 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 开源许可证。