RuoYi AI

✨ 核心亮点

模块	现有能力
模型管理	多模型接入(OpenAI/DeepSeek/通义/智谱)、多模态理解、Coze/DIFY/FastGPT平台集成
知识管理	本地RAG + 向量库(Milvus/Weaviate/Qdrant) + 文档解析
工具管理	Mcp协议集成、Skills能力 + 可扩展工具生态
流程编排	可视化工作流设计器、节点拖拽编排、SSE流式执行,目前已经支持模型调用,邮件发送,人工审核等节点
多智能体	基于Langchain4j的Agent框架、Supervisor模式编排,支持多种决策模型

🚀 快速体验

在线演示

平台	地址	账号
用户端	web.pandarobot.chat	admin / admin123
管理后台	admin.pandarobot.chat	admin / admin123

项目源码

项目模块	GitHub 仓库	Gitee 仓库	GitCode 仓库
🔧 后端服务	ruoyi-ai	ruoyi-ai	ruoyi-ai
🎨 用户前端	ruoyi-web	ruoyi-web	ruoyi-web
🛠️ 管理后台	ruoyi-admin	ruoyi-admin	ruoyi-admin

合作项目

项目名称	GitHub 仓库	Gitee 仓库
element-plus-x	element-plus-x	element-plus-x

🛠️ 技术架构

核心框架

• 后端架构：Spring Boot 4.0 + Spring ai 2.0 + Langchain4j

• 数据存储：MySQL 8.0 + Redis + 向量数据库（Milvus/Weaviate/Qdrant）

• 前端技术：Vue 3 + Vben Admin + element-plus-x

• 安全认证：Sa-Token + JWT 双重保障

• 文档处理：PDF、Word、Excel 解析，图像智能分析

• 实时通信：WebSocket 实时通信，SSE 流式响应

• 系统监控：完善的日志体系、性能监控、服务健康检查

🐳 Docker 部署

本项目提供两种 Docker 部署方式：

方式一：一键启动所有服务（推荐）

使用 docker-compose-all.yaml 可以一键启动所有服务（包括后端、管理端、用户端及依赖服务）：

# 克隆仓库
git clone https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai

# 启动所有服务（从镜像仓库拉取预构建镜像）
docker-compose -f docker-compose-all.yaml up -d

# 查看服务状态
docker-compose -f docker-compose-all.yaml ps

# 访问服务
# 管理端: http://localhost:25666 (admin / admin123)
# 用户端: http://localhost:25137
# 后端API: http://localhost:26039

方式二：分步部署（源码编译）

如果您需要从源码构建后端服务，请按照以下步骤操作：

第一步：部署后端服务

# 进入后端项目目录
cd ruoyi-ai

# 启动后端服务（源码编译构建）
docker-compose up -d --build

# 等待后端服务启动完成
docker-compose logs -f backend

第二步：部署管理端

# 进入管理端项目目录
cd ruoyi-admin

# 构建并启动管理端
docker-compose up -d --build

# 访问管理端
# 地址: http://localhost:5666

第三步：部署用户端（可选）

# 进入用户端项目目录
cd ruoyi-web

# 构建并启动用户端
docker-compose up -d --build

# 访问用户端
# 地址: http://localhost:5137

服务端口说明

服务	一键启动端口	分步部署端口	说明
管理端	25666	5666	管理后台访问地址
用户端	25137	5137	用户前端访问地址
后端服务	26039	6039	后端 API 服务
MySQL	23306	23306	数据库服务
Redis	26379	6379	缓存服务
Weaviate	28080	28080	向量数据库
MinIO API	29000	9000	对象存储 API
MinIO Console	29090	9090	对象存储控制台

镜像仓库

所有镜像托管在阿里云容器镜像服务：

crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai

可用镜像：

• mysql:v3 - MySQL 数据库（包含初始化 SQL）
• redis:6.2 - Redis 缓存
• weaviate:1.30.0 - 向量数据库
• minio:latest - 对象存储
• ruoyi-ai-backend:latest - 后端服务
• ruoyi-ai-admin:latest - 管理端前端
• ruoyi-ai-web:latest - 用户端前端

常用命令

# 停止所有服务
docker-compose -f docker-compose-all.yaml down

# 查看服务日志
docker-compose -f docker-compose-all.yaml logs -f [服务名]

# 重启某个服务
docker-compose -f docker-compose-all.yaml restart [服务名]

📚 使用文档

想要深入了解安装部署、功能配置和二次开发？

👉 完整使用文档

遇到知识库或 RAG 回答异常问题？

👉 RAG 回答异常排查手册

---

🤝 参与贡献

我们热烈欢迎社区贡献！无论您是资深开发者还是初学者，都可以为项目贡献力量 💪

贡献方式

1. Fork 项目到您的账户
2. 创建分支 (git checkout -b feature/新功能名称)
3. 提交代码 (git commit -m '添加某某功能')
4. 推送分支 (git push origin feature/新功能名称)
5. 发起 Pull Request

💡 小贴士：建议将 PR 提交到 GitHub，我们会自动同步到其他代码托管平台

📄 开源协议

本项目采用 MIT 开源协议，详情请查看 LICENSE 文件。

🙏 特别鸣谢

感谢以下优秀的开源项目为本项目提供支持：

• Spring AI Alibaba Copilot - 基于spring-ai-alibaba 的智能编码助手
• Langchain4j - 强大的 Java LLM 开发框架
• RuoYi-Vue-Plus - 成熟的企业级快速开发框架
• Vben Admin - 现代化的 Vue 后台管理模板

🌐 生态伙伴

• PPIO 派欧云 - 提供高性价比的 GPU 算力和模型 API 服务
• 优云智算 - 万卡RTX40系GPU+海内外主流模型API服务，秒级响应，按量计费，新客免费用。

💬 社区交流

---

RuoYi AI 快速上手指南

RuoYi AI 是一款开箱即用的企业级全栈 AI 助手平台，支持多智能体协同、RAG 知识库、可视化流程编排及多种大模型接入。本指南将帮助您快速在本地部署并体验核心功能。

1. 环境准备

在开始部署前，请确保您的开发环境满足以下要求：

• 操作系统：Linux / macOS / Windows (需安装 WSL2 或 Docker Desktop)
• 容器引擎：Docker 20.10+ 及 Docker Compose v2.0+
• 网络环境：
  • 需能访问阿里云容器镜像仓库（项目默认镜像源）。
  • 若需调用外部大模型（如 OpenAI/DeepSeek），请确保网络通畅或配置代理。
• 硬件建议：
  • 内存：建议 8GB 以上（运行向量数据库及多个微服务需要较多内存）。
  • 磁盘：预留至少 10GB 空间用于存储镜像及数据。

2. 安装步骤

本项目推荐使用 Docker Compose 一键启动 模式，该方式会自动拉取预构建的镜像并启动所有依赖服务（后端、前端、MySQL、Redis、向量库等）。

第一步：克隆项目代码

建议使用 Gitee 或 GitCode 国内镜像加速下载：

# 方式 A：使用 Gitee (推荐国内用户)
git clone https://gitee.com/ageerle/ruoyi-ai.git
cd ruoyi-ai

# 方式 B：使用 GitHub
# git clone https://github.com/ageerle/ruoyi-ai.git
# cd ruoyi-ai

第二步：一键启动所有服务

执行以下命令拉取镜像并启动全套服务：

docker-compose -f docker-compose-all.yaml up -d

注意：首次运行需下载多个镜像（约 2-3GB），请耐心等待。若下载缓慢，请检查 Docker 镜像加速器配置。

第三步：验证服务状态

查看容器运行状态，确保所有服务均为 Up 状态：

docker-compose -f docker-compose-all.yaml ps

3. 基本使用

服务启动完成后，您可以通过浏览器访问管理后台和用户端进行体验。

访问地址与账号

平台	访问地址	默认账号	默认密码
管理后台	http://localhost:25666	admin	admin123
用户端	http://localhost:25137	admin	admin123

快速功能体验

1. 配置大模型：
   • 登录 管理后台 (:25666)。
   • 进入「模型管理」模块，添加您的 API Key（支持 OpenAI、DeepSeek、通义千问、智谱 AI 等）。
2. 构建知识库 (RAG)：
   • 在管理后台进入「知识管理」，上传 PDF/Word/Txt 文档。
   • 系统会自动解析并存入向量数据库（Weaviate/Milvus）。
3. 创建智能应用：
   • 进入「流程编排」或「多智能体」模块。
   • 拖拽节点设计工作流（例如：用户提问 -> 检索知识库 -> 大模型总结 -> 输出回答）。
   • 保存并发布后，即可在 用户端 (:25137) 进行对话测试。

常用运维命令

# 查看实时日志（排查问题用）
docker-compose -f docker-compose-all.yaml logs -f backend

# 停止所有服务
docker-compose -f docker-compose-all.yaml down

# 重启特定服务（例如重启后端）
docker-compose -f docker-compose-all.yaml restart backend

如需深入了解二次开发或高级配置，请访问 完整使用文档。