apconw/Aix-DB
JavaScriptAix-DB 基于 LangChain/LangGraph 框架，结合 MCP Skills 多智能体协作架构，实现自然语言到数据洞察的端到端转换。
npm install aix-db
Aix-DB - 大模型数据助手
基于大语言模型和RAG技术的智能数据分析系统，实现对话式数据分析（ChatBI），快速实现数据提取与可视化
项目介绍
Aix-DB 基于 LangChain/LangGraph 框架，结合 MCP Skills 多智能体协作架构，实现自然语言到数据洞察的端到端转换。
核心能力：智能问答 · 数据问答（Text2SQL） · 表格问答 · 深度问数 · 数据可视化 · MCP 多智能体 · Skill 模式
产品特点：📦 开箱即用 · 🔒 安全可控 · 🔌 易于集成 · 🎯 越问越准 · 🧩 Skill 模式 · 🐾 OpenClaw 智能集成
演示视频
| 🎯 Skill 模式 | 💬 标准模式 |
|---|---|
| 🧩 Skill 技能中心 | 🐾 OpenClaw 模式 |
💰 赞助商展示
| Doloffer | IP数据云 |
|---|---|
 |
 |
系统架构
分层架构设计：
- 前端层：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
命令行工具（CLI）
通过终端直接发起自然语言数据查询，支持图表渲染输出。
# 安装
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！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 提交 Pull Request
Star History
开源许可
本项目采用 Apache License 2.0 开源许可证。