Aix-DB

Aix-DB 作为一个基于 LangChain/LangGraph 构建的多智能体协作型数据分析平台，支持通用问答、Text2SQL 数据问答、表格问答、深度搜索、数据可视化等能力，结合 RAG 检索与自研的 MCP 多智能体协作架构提供端到端的数据洞察。通过 Docker 部署后，您可以访问提供的 Web 管理界面（默认 http://localhost:18080）进行系统配置与监控，并通过后端 API 与数据库、对象存储等数据源进行对接。若需要数据分析对话、自动生成 SQL、以及可视化结果，系统会以对话形式与用户交互，自动从连接的数据源中检索、生成并呈现分析结果。要启动服务，请使用上述 Docker 运行命令，完成容器创建后即可通过前端界面或 API 进行交互；后端通过 Sanic 提供 RESTful 接口，并集成 Neo4j、FAISS/Chroma、MinIO 等组件以支持检索、向量化与存储。

Prerequisites:

• Docker • Docker Compose (可选)
• 至少 4GB RAM（推荐 8GB 及以上）
• 适用于 Linux/macOS/Windows 的 Docker 运行环境

Installation steps:

1. 安装 Docker：按照官方文档安装 Docker 版本并启动服务。
2. 拉取并运行 Aix-DB（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=
     -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.3
3. 可选：使用 Docker Compose 快速部署：
   1. git clone https://github.com/apconw/Aix-DB.git
   2. cd Aix-DB/docker
   3. cp .env.template .env # 根据需要调整环境变量
   4. docker-compose up -d
4. 访问与配置：
   • Web 管理界面：http://localhost:18080 默认账号 admin / 123456
   • PostgreSQL 数据库：localhost:15432 / aix_db / 用户 aix_db / 密码 1

本地开发与调试时，可以在 docker-compose 环境中单独启动依赖（PostgreSQL、MinIO 等），并根据 .env.dev 文件自定义数据库、对象存储等连接信息。若需要构建源码环境，请参考仓库文档中的“本地开发”章节。

提示与常见问题：

• 启动容器后，确保端口未被防火墙阻塞，18080、18088、15432 等端口对外暴露。
• LANGFUSE 相关环境变量用于密钥和基础 URL，请在生产环境中填写实际值以确保鉴权与调用安全。
• 数据卷映射路径请根据宿主机实际结构调整，确保 volume 目录存在且具有写权限。
• 如遇依赖服务启动慢，可增加 SERVER_WORKERS 或提升机器资源，确保 LLM、向量检索和数据库操作的并发性。
• 使用 Docker Compose 部署时，请确保 .env 文件中变量正确对应到服务配置，避免连接失败。
• 访问前端界面时若出现鉴权问题，请核对管理员账号和初始密码。