ruoyi-ai
快速搭建属于自己的 AI 助手平台
全新升级,开箱即用,简单高效
探索本项目的文档 »
项目预览
·
报告 Bug
·
提出新特性
快速启动
拉取镜像(最低配置 2H2G):
script/deploy/deploy 目录下执行: docker-compose up -d
通过脚本启动(最低配置 4H4G):
确认系统内已经安装好以下软件
- docker
- docker-compose
- git
- unzip
克隆项目
git clone https://github.com/ageerle/ruoyi-ai cd ruoyi-ai/script/deploy/one-step-script
启动部署脚本
中文界面部署脚本(拉取 gitee 仓库):
./deploy-cn.sh
按照脚本提示一步步操作,如果是一台新服务器,选择默认配置,直接回车即可。
耐心等待安装完成...
英文界面部署脚本(拉取 github 仓库):
./deploy-en.sh
如果在执行部署脚本过程中不需要在本地重新构建编译服务软件包以及重新封装容器镜像,则需要在脚本交互提出以下问题时选择 D 按键进行直接部署,否则就会执行全新的编译构建及容器封装之后再执行部署:
已将模板文件复制到部署目录。 正在使用您的配置更新 .env 文件... 已使用您的配置更新 .env 文件。 正在使用您的配置更新 docker-compose.yaml 文件... 已使用您的配置更新 docker-compose.yaml 文件。 === 构建或部署选项 === 您想构建新镜像 (B) 还是直接使用现有镜像部署 (D)?[B/d]:
访问应用界面
- 用户界面:
http://your-server-ip:8081
- 管理员界面:
http://your-server-ip:8082
- 用户界面:
目录
系统体验
- 用户端:https://web.pandarobot.chat
- 演示账号: demo 密码:demo123
- 管理端:https://admin.pandarobot.chat
- 演示账号: admin 密码:admin123
源码地址
[1]github
- 前端服务-用户端: https://github.com/ageerle/ruoyi-web
- 前端服务-管理端: https://github.com/ageerle/ruoyi-admin
- 后端服务:https://github.com/ageerle/ruoyi-ai
[2]gitcode
- 前端服务-用户端:https://gitcode.com/ageerle/ruoyi-web
- 前端服务-管理端: https://gitcode.com/ageerle/ruoyi-admin
- 后端服务:https://gitcode.com/ageerle/ruoyi-ai
配套文档
核心功能与技术亮点
1. 全栈式开源系统
- 全套开源系统:提供完整的前端应用、后台管理,基于 MIT 协议,开箱即用。
2. 本地化 RAG 方案
- 基于 Langchain4j 框架,支持 Milvus/Weaviate/Qdrant 向量库,结合 BGE-large-zh-v1.5 本地向量化模型 实现高效文档检索与知识库构建。
- 支持 本地 LLM 接入,结合私有知识库实现安全可控的问答系统,避免依赖云端服务的隐私风险。
- 支持 ollama、vLLm 等平台部署模型。
3. 多模态 AI 引擎与工具集成
- 智能对话:支持 OpenAI GPT-4、Azure、ChatGLM 等主流模型,内置 SSE/WebSocket 协议实现低延迟交互,兼容 扣子、DIFY 等平台 API 调用。
- Spring AI MCP 支持:通过注解快速定义本地工具,支持调用 MCP 广场 的海量 MCP Server 服务,扩展模型能力边界。
4. 企业级扩展与商业化支持
- 即时通讯集成:支持对接个人微信、企业微信及微信公众号,实现消息自动回复、用户管理与智能客服。
- 支付系统:集成易支付、微信支付、Stripe 国际信用卡支付,满足商业化场景需求。
5. 多媒体处理与创新功能
- AI 绘画:集成 DALL·E-3、MidJourney、Stable Diffusion,支持文生图、图生图及风格化创作,适用于营销素材生成与创意设计。
- PPT 制作:根据文本输入自动生成结构化幻灯片,支持自定义模板(需要使用三方平台 如:文多多)。
项目演示
任务规划
任务规划演示
mcp 支持




用户端




管理端




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

项目结构
- 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
鸣谢
🌿 第三方生态
附:技术讨论群
技术交流(如需进群请添加小助手)

进群学习
🏠 小助手 wx:ruoyi-ai(加人备注:ruoyi-ai) 🏠 小助手 qq:1603234088 (加人备注:ruoyi-ai)
👏👏👏 ruoyi-ai 官方交流群(qq 区)
