Repolode
Submit
ageerle

ageerle/ruoyi-ai

Java/Spring Boot full-stack AI assistant platform with multi-provider LLM management, RAG knowledge bases, visual workflows and multi-agent orchestration.

View on GitHubWebsite
Stars
5,817
Forks
1,433
Open issues
12
Last commit
16 days ago

What is it?

RuoYi AI is an enterprise-oriented AI agent platform built on Spring Boot 3 and Langchain4j. It lets teams connect multiple LLM providers such as DeepSeek, Zhipu, OpenAI and Bailian from one admin interface, and integrates with platforms like Coze, Dify, FastGPT and RAGFlow.

For knowledge work, it provides a local RAG pipeline backed by Milvus, Weaviate or Qdrant, with document parsing for PDF, Word and Excel. Tool use is handled through MCP protocol integration and a Skills capability. A visual drag-and-drop workflow designer runs nodes such as model calls, email sending and manual review over SSE streaming, and a Supervisor mode coordinates multiple agents.

The stack includes MySQL, Redis, Vue 3 with Vben Admin, and Sa-Token with JWT for security. The project ships Docker Compose files for one-click deployment of the backend, admin panel and user frontend.

Key features

  • 01Multi-provider LLM management with access to DeepSeek, Zhipu, OpenAI and other models
  • 02Local RAG knowledge base backed by Milvus, Weaviate or Qdrant
  • 03Visual drag-and-drop workflow designer with SSE streaming execution
  • 04MCP protocol integration and Skills-based tool extension
  • 05Supervisor-mode multi-agent orchestration built on Langchain4j
  • 06Docker Compose deployment for backend, admin panel and user frontend

Use cases

  • Building an internal enterprise chatbot over company documents using RAG
  • Automating approval or notification flows with visual workflows that include manual review
  • Running a Java-based AI assistant platform with a built-in admin panel and user accounts

Quick start

  1. 1

    Clone the v3.1.0 release

    git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git
  2. 2

    Create the environment file and pin the image version

    cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env
  3. 3

    Pull pre-built images from GHCR

    docker compose --env-file docs/docker/ruoyi-ai/.env -f docs/docker/ruoyi-ai/docker-compose-all.yaml pull
  4. 4

    Start all services in the background

    docker compose --env-file docs/docker/ruoyi-ai/.env -f docs/docker/ruoyi-ai/docker-compose-all.yaml up -d

Things to know

  • Requires Docker and Docker Compose to run the one-click deployment.
  • The default Compose file exposes MySQL, Redis, Weaviate and MinIO ports, so passwords must be changed for production.

In collections

MCP servers

Topics

#ai#rag#llm#agent#java#spring-boot#workflow#mcp#knowledge

FAQ

What is ruoyi-ai?
Java/Spring Boot full-stack AI assistant platform with multi-provider LLM management, RAG knowledge bases, visual workflows and multi-agent orchestration. RuoYi AI is an enterprise-oriented AI agent platform built on Spring Boot 3 and Langchain4j. It lets teams connect multiple LLM providers such as DeepSeek, Zhipu, OpenAI and Bailian from one admin interface, and integrates with platforms like Coze, Dify, FastGPT and RAGFlow.
Is ruoyi-ai free to use? What license does it have?
ruoyi-ai is open source under the MIT license. Check the license terms before using it in commercial products.
Is ruoyi-ai still maintained?
Actively maintained. The last commit to ruoyi-ai was on Oct 21, 2026.
What can I use ruoyi-ai for?
Building an internal enterprise chatbot over company documents using RAG Automating approval or notification flows with visual workflows that include manual review Running a Java-based AI assistant platform with a built-in admin panel and user accounts
How do I install ruoyi-ai?
Clone the v3.1.0 release: git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git Create the environment file and pin the image version: cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env Pull pre-built images from GHCR: docker compose --env-file docs/docker/ruoyi-ai/.env -f docs/docker/ruoyi-ai/docker-compose-all.yaml pull Start all services in the background: docker compose --env-file docs/docker/ruoyi-ai/.env -f docs/docker/ruoyi-ai/docker-compose-all.yaml up -d
Where can I get ruoyi-ai?
The source code and installation instructions are on GitHub: https://github.com/ageerle/ruoyi-ai

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects