ageerle/ruoyi-ai

RuoYi AI – 企业级 AI 助手平台

是什么

• 一个全栈、开源的平台，支持构建和运行具有多智能体协作、RAG（检索增强生成）和可视化工作流编排的 AI 助手。
• 基于 Spring Boot 3（后端）和 Vue 3（前端）构建，并集成了 Java 的 LLM 框架 Langchain4j。

核心能力

领域	功能
模型管理	连接到众多 LLM 提供商（OpenAI、DeepSeek、Zhipu、MIMO、百度百炼）和多模态模型；还可插件化外部服务，如 Coze、DIFY、FastGPT、RAGFlow。
知识管理	使用向量库（Milvus、Weaviate、Qdrant）的本地 RAG 管道，并内置 PDF、Word、Excel、图片的文档解析器。
工具管理	用于工具调用的 MCP 协议，可扩展的“技能”生态。
工作流编排	拖拽式可视化设计器；节点可调用模型、发送邮件、暂停以供人工审核等；结果通过 SSE 流式输出。
多智能体	基于 Langchain4j 的智能体框架，具有 Supervisor 模式，可将任务路由到不同的决策模型并动态组合工具。

技术栈

• 后端：Spring Boot 3.5.8 + Langchain4j
• 前端：Vue 3 + Vben Admin + Element-Plus-X
• 数据：MySQL 8、Redis、向量数据库（Milvus/Weaviate/Qdrant）、MinIO（对象存储）
• 安全：Sa-Token + JWT
• 实时：WebSocket + Server-Sent Events

如何运行

• 一键 Docker – docker compose -f docker-compose-all.yaml up -d 启动后端、管理 UI、用户 UI 以及所有依赖服务（MySQL、Redis、Weaviate、MinIO）。端口已预先映射（例如，管理 UI 25666，用户 UI 25137，API 26039）。
• 分步构建 – 如果需要自定义代码，请从源码构建每个服务，并使用单独的 docker-compose 文件。

主要仓库

• ruoyi-ai – 后端服务
• ruoyi-web – 用户端前端
• ruoyi-admin – 管理面板
• ruoyi-drama、ruoyi-copilot、ruoyi-uniapp – 演示应用和小程序

典型用例

• 通过 RAG 检索公司知识的企业内部助手。
• 多智能体任务自动化（例如，编程辅助、短剧生成、邮件草稿撰写）。
• 使用可视化设计器快速构建 AI 增强的工作流原型。

开始使用

1. 克隆仓库并检出 v3.1.0 标签。
2. 复制示例 .env 文件，设置 RUIYI_VERSION=v3.1.0。
3. 运行上述 Docker compose 命令。
4. 打开管理 UI（http://<host>:25666，默认凭据 admin/admin123）配置模型 API 密钥和向量库。
5. 探索在线演示（短剧、用户前端、编程），查看现成的示例。

文档与社区

• 完整文档：https://doc.ruoyiai.chat/
• 在线演示：https://web.ruoyiai.chat/ （二维码登录）
• 社区聊天：微信、抖音、QQ（二维码在 README 中）

许可证

• MIT 许可证

重要性 RuoYi AI 将大多数项目需要分别集成的组件——LLM 接入、向量搜索、工具调用和可视化工作流 UI——打包成一个可部署的单一栈。这使得企业无需编写大量胶水代码即可实用地部署 AI 助手。