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 部署（推荐） ```bash 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 ```bash 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` ### 本地开发 **① 克隆项目** ```bash git clone https://github.com/apconw/Aix-DB.git cd Aix-DB ``` **② 启动依赖中间件**（PostgreSQL、MinIO 等） ```bash cd docker docker-compose up -d ``` **③ 配置环境变量** 编辑项目根目录下的 `.env.dev`，按需修改数据库连接、MinIO 地址等配置（默认配置可直接使用） **④ 安装 Python 依赖**（需要 Python 3.11） ```bash # 方式一：pip pip install -r requirements.txt # 方式二：uv（推荐，更快） uv venv --python 3.11 source .venv/bin/activate uv sync ``` **⑤ 启动后端服务** ```bash # Windows PowerShell 专属命令：设置环境变量+运行脚本，一行执行增加字符兼容性，解决有些机器错误问题。 $env:PYTHONUTF8=1; python serv.py ``` **⑥ 启动前端开发服务器**（另开终端） ```bash cd web npm install npm run dev ``` ## 命令行工具（CLI） [![npm version](https://img.shields.io/npm/v/@apconw/aix-db-cli)](https://www.npmjs.com/package/@apconw/aix-db-cli) 通过终端直接发起自然语言数据查询，支持图表渲染输出。 ```bash # 安装 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](./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](https://api.star-history.com/svg?repos=apconw/Aix-DB&type=Date)](https://star-history.com/#apconw/Aix-DB&Date) ## 开源许可本项目采用 [Apache License 2.0](./LICENSE) 开源许可证。