编辑 | blame | 历史 | 原始文档

RuoYi AI

Logo

快速搭建属于自己的 AI 助手平台

全新升级，开箱即用，简单高效
探索本项目的文档 »

项目预览 · 报告Bug · 提出新特性

1. 全栈式开源系统

全套开源系统：提供完整的前端应用、后台管理以及小程序应用，基于MIT协议，开箱即用。
2. 本地化 RAG 方案
基于 Langchain4J 框架，支持 Milvus/Weaviate/Qdrant 向量库，结合 BGE-large-zh-v1.5 本地向量化模型实现高效文档检索与知识库构建。
支持本地 LLM 接入，结合私有知识库实现安全可控的问答系统，避免依赖云端服务的隐私风险。
3. 多模态 AI 引擎与工具集成
智能对话：支持 OpenAI GPT-4、Azure、ChatGLM 等主流模型，内置 SSE/WebSocket 协议实现低延迟交互，兼容扣子、DIFY 等平台 API 调用。
Spring AI MCP 工具链：通过注解快速定义本地工具，支持调用 MCP 广场的海量 MCP Server 服务，扩展模型能力边界。
4. 企业级扩展与商业化支持
即时通讯集成：支持对接个人微信、企业微信及微信公众号，实现消息自动回复、用户管理与智能客服37。
支付系统：集成易支付、微信支付、Stripe 国际信用卡支付，满足商业化场景需求。
5. 多媒体处理与创新功能
AI 绘画：集成 DALL·E-3、MidJourney、Stable Diffusion，支持文生图、图生图及风格化创作，适用于营销素材生成与创意设计34。
PPT 制作：根据文本输入自动生成结构化幻灯片，支持自定义模板(需要使用三方平台如：文多多)。

项目演示

mcp支持

管理端

用户端

小程序端

开发环境

jdk 17
mysql 5.7、8.0
redis 版本必须 >= 5.X
maven 3.8+
nodejs 20+ & pnpm

附-部署配套视频：https://www.bilibili.com/video/BV1jDXkYWEba

项目结构

RuoYi-AI

├─ ruoyi-admin                         // 管理模块
│  └─ RuoYiApplication                 // 启动类
│  └─ RuoYiServletInitializer          // 容器部署初始化类
│  └─ resources                        // 资源文件
│      └─ i18n/messages.properties     // 国际化配置文件
│      └─ application.yml              // 框架总配置文件
│      └─ application-dev.yml          // 开发环境配置文件
│      └─ application-prod.yml         // 生产环境配置文件
│      └─ banner.txt                   // 框架启动图标
│      └─ logback-plus.xml             // 日志配置文件
│      └─ ip2region.xdb                // IP区域地址库
├─ ruoyi-common                        // 通用模块
│  └─ ruoyi-common-bom                 // common依赖包管理
   └─ ruoyi-common-chat                // 聊天模块
│  └─ ruoyi-common-core                // 核心模块
│  └─ ruoyi-common-doc                 // 系统接口模块
│  └─ ruoyi-common-encrypt             // 数据加解密模块
│  └─ ruoyi-common-excel               // excel模块
│  └─ ruoyi-common-idempotent          // 幂等功能模块
│  └─ ruoyi-common-json                // 序列化模块
│  └─ ruoyi-common-log                 // 日志模块
│  └─ ruoyi-common-mail                // 邮件模块
│  └─ ruoyi-common-mybatis             // 数据库模块
│  └─ ruoyi-common-oss                 // oss服务模块
│  └─ ruoyi-common-pay                 // 支付模块
│  └─ ruoyi-common-ratelimiter         // 限流功能模块
│  └─ ruoyi-common-redis               // 缓存服务模块
│  └─ ruoyi-common-satoken             // satoken模块
│  └─ ruoyi-common-security            // 安全模块
│  └─ ruoyi-common-sensitive           // 脱敏模块
│  └─ ruoyi-common-sms                 // 短信模块
│  └─ ruoyi-common-tenant              // 租户模块
│  └─ ruoyi-common-translation         // 通用翻译模块
│  └─ ruoyi-common-web                 // web模块
├─ ruoyi-modules                       // 模块组
│  └─ ruoyi-demo                       // 演示模块
│  └─ ruoyi-system                     // 业务模块
├─ .run                 // 执行脚本文件
├─ .editorconfig        // 编辑器编码格式配置
├─ LICENSE              // 开源协议
├─ pom.xml              // 公共依赖
├─ README.md            // 框架说明文件

注意事项

vben模板
Q：vben5 的模板默认是没有的吗？
A：vben模板是收费的请联系vben-vue-plus作者获取。

版本控制

该项目使用Git进行版本管理。您可以在repository参看当前可用版本。

版权说明

该项目使用了MIT授权许可，详情请参阅 LICENSE.txt

项目现状

目前，项目还处于早期阶段，距离成熟还有很长的路要走。由于个人精力有限，项目的发展速度受到了一定的限制。为了加快项目的进度，我真诚地希望更多人能够参与到项目中来。无论是经验丰富的开发者，还是刚刚入门的小白，我都热烈欢迎你们提交Pull Request（PR）👏👏👏。即使代码修改得很少，或者存在一些错误，都没有关系。我会认真审核每一位贡献者的代码，并和大家一起完善项目⛽️⛽️⛽️。

开发计划

主题	方向	时间节点
前端简化版	与element-plus-x框架合作，推出基于该框架的前端简化版	2025.5
agent2agent	Agent2Agent协议支持	2025.6
流程编排	通过可视化界面和灵活的配置方式，快速构建AI应用	2025.7

感谢

最后，我要感谢RuoYi-Vue-Plus、chatgpt-java、chatgpt-web-midjourney-proxy等优秀框架。正是因为这些项目的开源和共享，我才能够在这个基础上进行开发，使我们的项目能够取得今天的成果。再次感谢这些项目及其背后的开发者们！

希望更多志同道合的朋友能够加入我们，共同推动这个项目的发展。让我们一起努力，将这个项目打造成一个真正成熟、实用的AI平台！

如何参与开源项目

贡献使开源社区成为一个学习、激励和创造的绝佳场所。你所作的任何贡献，我们都非常感谢！🙏

Fork 这个项目
创建你的功能分支 (git checkout -b feature/dev)
提交你的更改 (git commit -m 'Add some dev')
推送到分支 (git push origin feature/dev)
打开拉取请求
pr请提交到GitHub上，会定时同步到gitee

项目文档

项目文档基于vitepress构建
按照如何参与开源项目拉取https://github.com/ageerle/ruoyi-doc
安装依赖：npm install
启动项目：npm run docs:dev
主页路径：docs/guide/introduction/index.md

鸣谢

🌿 第三方生态

PPIO 派欧云：一键调用高性价比的开源模型 API 和 GPU 容器

附：技术讨论群

进群学习

🏠 wx：ruoyi-ai（加人备注：ruoyi-ai）
1cc0022eeb5c266041b6e2212cf5253

🏠 qq：1603234088 （加人备注：ruoyi-ai）

👏👏👏 ruoyi-ai官方交流1群（qq区）：1034554687

RuoYi AI

快速搭建属于自己的 AI 助手平台

目录

系统体验

源码地址

配套文档

核心功能与技术亮点