Aix-DB

What it is

Aix-DB 基于 LangChain/LangGraph 框架，结合 MCP Skills 多智能体协作架构，实现自然语言到数据洞察的端到端转换。核心能力包括智能问答、数据问答（Text2SQL）、表格问答、深度问数、数据可视化、MCP 多智能体、Skill 模式。

How it works

Modular architecture with front-end (Vue 3 + TypeScript) and API gateway (Sanic) plus intelligent services (LLM, Text2SQL Agent, RAG, MCP). Data sources include relational, vector, graph databases and files. The process flow from natural language input to SQL generation, database execution, and visualization is outlined in the system architecture diagram and flow.

Getting started

• 快速开始提供 Docker 部署（推荐）和 Docker Compose 设置，以及对系统访问的地址和默认凭据。
• 本地开发包含克隆仓库、启动依赖中间件、配置环境变量、安装 Python 依赖、启动后端服务、启动前端开发服务器等步骤。
• CLI 工具可通过 npm 安装并运行，包括登录、查看数据源、以及 chat 数据问答命令。

使用 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

本地开发

1. 克隆项目并进入
2. 启动依赖中间件（PostgreSQL、MinIO）
3. 配置环境变量，在根目录 .env.dev 进行修改
4. 安装 Python 依赖（Python 3.11）
5. 启动后端服务
6. 启动前端开发服务器

命令行工具（CLI）

# 安装
npm install -g @apconw/aix-db-cli
# 登录
aix-db-cli login
# 查看可用数据源
aix-db-cli datasources
# 数据问答
aix-db-cli chat "有哪些数据表？" --datasource 48
aix-db-cli chat "查询销售额趋势" --datasource 48 --stream

Traction

• Stars: 2207
• Forks: 426
• Open issues: 16

技术栈

后端：Sanic · SQLAlchemy · LangChain/LangGraph · Neo4j · FAISS/Chroma · MinIO 前端：Vue 3 · TypeScript · Vite 5 · Naive UI · ECharts · AntV AI 模型：OpenAI · Anthropic · DeepSeek · Qwen · Ollama

开源许可

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