RuoYi AI


Logo

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

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

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

快速启动

  1. 克隆项目

    1. git clone https://github.com/alanpeng/ruoyi-ai-docker-deploy
    2. cd ruoyi-ai-docker-deploy

  2. 启动全套应用

    1. docker-compose up -d

  3. 访问应用界面

    • 用户界面：http://your-server-ip:8081
    • 管理员界面：http://your-server-ip:8082

目录

系统体验

源码地址

[1]gitee

配套文档

核心功能与技术亮点

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. 企业级扩展与商业化支持

  • 即时通讯集成：支持对接个人微信、企业微信及微信公众号，实现消息自动回复、用户管理与智能客服。
  • 支付系统：集成易支付、微信支付、Stripe 国际信用卡支付，满足商业化场景需求。

    5. 多媒体处理与创新功能

    • AI 绘画：集成 DALL·E-3、MidJourney、Stable Diffusion，支持文生图、图生图及风格化创作，适用于营销素材生成与创意设计。
    • PPT 制作：根据文本输入自动生成结构化幻灯片，支持自定义模板(需要使用三方平台 如：文多多)。

项目演示

mcp支持

drawing drawing drawing drawing

管理端

drawing drawing drawing drawing

用户端

drawing drawing drawing drawing

小程序端

drawing drawing

开发环境

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

项目结构

  • RuoYi-AI
  1. ├─ ruoyi-admin                         // 管理模块
  2. │  └─ RuoYiApplication                 // 启动类
  3. │  └─ RuoYiServletInitializer          // 容器部署初始化类
  4. │  └─ resources                        // 资源文件
  5. │      └─ i18n/messages.properties     // 国际化配置文件
  6. │      └─ application.yml              // 框架总配置文件
  7. │      └─ application-dev.yml          // 开发环境配置文件
  8. │      └─ application-prod.yml         // 生产环境配置文件
  9. │      └─ banner.txt                   // 框架启动图标
  10. │      └─ logback-plus.xml             // 日志配置文件
  11. │      └─ ip2region.xdb                // IP区域地址库
  12. ├─ ruoyi-common                        // 通用模块
  13. │  └─ ruoyi-common-bom                 // common依赖包管理
  14.    └─ ruoyi-common-chat                // 聊天模块
  15. │  └─ ruoyi-common-core                // 核心模块
  16. │  └─ ruoyi-common-doc                 // 系统接口模块
  17. │  └─ ruoyi-common-encrypt             // 数据加解密模块
  18. │  └─ ruoyi-common-excel               // excel模块
  19. │  └─ ruoyi-common-idempotent          // 幂等功能模块
  20. │  └─ ruoyi-common-json                // 序列化模块
  21. │  └─ ruoyi-common-log                 // 日志模块
  22. │  └─ ruoyi-common-mail                // 邮件模块
  23. │  └─ ruoyi-common-mybatis             // 数据库模块
  24. │  └─ ruoyi-common-oss                 // oss服务模块
  25. │  └─ ruoyi-common-pay                 // 支付模块
  26. │  └─ ruoyi-common-ratelimiter         // 限流功能模块
  27. │  └─ ruoyi-common-redis               // 缓存服务模块
  28. │  └─ ruoyi-common-satoken             // satoken模块
  29. │  └─ ruoyi-common-security            // 安全模块
  30. │  └─ ruoyi-common-sensitive           // 脱敏模块
  31. │  └─ ruoyi-common-sms                 // 短信模块
  32. │  └─ ruoyi-common-tenant              // 租户模块
  33. │  └─ ruoyi-common-translation         // 通用翻译模块
  34. │  └─ ruoyi-common-web                 // web模块
  35. ├─ ruoyi-modules                       // 模块组
  36. │  └─ ruoyi-demo                       // 演示模块
  37. │  └─ ruoyi-system                     // 业务模块
  38. ├─ .run                 // 执行脚本文件
  39. ├─ .editorconfig        // 编辑器编码格式配置
  40. ├─ LICENSE              // 开源协议
  41. ├─ pom.xml              // 公共依赖
  42. ├─ README.md            // 框架说明文件

注意事项

  • vben模板
  1. Q：vben5 的模板默认是没有的吗？
  3. 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平台！

如何参与开源项目

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

  1. Fork 这个项目
  2. 创建你的功能分支 (git checkout -b feature/dev)
  3. 提交你的更改 (git commit -m 'Add some dev')
  4. 推送到分支 (git push origin feature/dev)
  5. 打开拉取请求

项目文档

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

鸣谢

🌿 第三方生态

附：技术讨论群

进群学习

输入图片说明

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

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

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

drawing