An out-of-the-box full-stack AI platform supporting multi-agent collaboration, Supervisor mode orchestration, and multiple decision models, with advanced RAG technology and visual workflow orchestration capabilities
中文 | 📖 Documentation | 🚀 Live Demo | 🐛 Report Issues | 💡 Feature Requests
| Service | URL | Login Method |
|---|---|---|
| Short Drama Demo | drama.ruoyiai.chat | QR code login |
| User Frontend Demo | web.ruoyiai.chat | QR code login |
| Coding Demo | code.ruoyiai.chat | QR code login |
| Module | Current Capabilities |
|---|---|
| Model Management | Multi-model integration (DeepSeek/Zhipu/MIMO/Bailian/OpenAI), multi-modal understanding, Coze/DIFY/FastGPT/RAGFlow platform integration |
| Knowledge Management | Local RAG + Vector DB (Milvus/Weaviate/Qdrant) + Document parsing |
| Tool Management | MCP protocol integration, Skills capability + Extensible tool ecosystem |
| Workflow Orchestration | Visual workflow designer, drag-and-drop node orchestration, SSE streaming execution, currently supports model calls, email sending, manual review, and other nodes |
| Multi-Agent | Agent framework based on Langchain4j, Supervisor mode orchestration, supports multiple decision models, can flexibly combine tools and skills |
| Module | GitHub Repository | Gitee Repository | GitCode Repository |
|---|---|---|---|
| 🔧 Backend | ruoyi-ai | ruoyi-ai | ruoyi-ai |
| 🎨 User Frontend | ruoyi-web | ruoyi-web | ruoyi-web |
| 🛠️ Admin Panel | ruoyi-admin | ruoyi-admin | ruoyi-admin |
| 🎬 Drama | ruoyi-drama | ruoyi-drama | ruoyi-drama |
| 🤖 Copilot | ruoyi-copilot | ruoyi-copilot | ruoyi-copilot |
| 📱 Mini-App | ruoyi-uniapp | ruoyi-uniapp | ruoyi-uniapp |
| Project Name | GitHub Repository | Gitee Repository |
|---|---|---|
| element-plus-x | element-plus-x | element-plus-x |
- Backend: Spring Boot 3.5.8 + Langchain4j
- Data Storage: MySQL 8.0 + Redis + Vector Databases (Milvus/Weaviate/Qdrant)
- Frontend: Vue 3 + Vben Admin + element-plus-x
- Security: Sa-Token + JWT dual-layer security
- Document Processing: PDF, Word, Excel parsing, intelligent image analysis
- Real-time Communication: WebSocket real-time communication, SSE streaming response
- System Monitoring: Comprehensive logging system, performance monitoring, service health checks
This project provides two Docker deployment methods:
Use docker-compose-all.yaml to start all services at once (including backend, admin panel, user frontend, and dependencies):
- Docker Engine（Linux/macOS）或 Docker Desktop（Windows）
- Docker Compose V2
# Clone the v3.1.0 release
git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai
# Pin the image version. Public GHCR images do not require docker login.
cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env
sed -i 's/^RUIYI_VERSION=.*/RUIYI_VERSION=v3.1.0/' docs/docker/ruoyi-ai/.env
# Pull pre-built images from GHCR and start all services
docker compose --env-file docs/docker/ruoyi-ai/.env \
-f docs/docker/ruoyi-ai/docker-compose-all.yaml pull
docker compose --env-file docs/docker/ruoyi-ai/.env \
-f docs/docker/ruoyi-ai/docker-compose-all.yaml up -d
# Check service status
docker compose --env-file docs/docker/ruoyi-ai/.env \
-f docs/docker/ruoyi-ai/docker-compose-all.yaml ps
# Access services (replace SERVER_IP with the server address)
# Admin Panel: http://SERVER_IP:25666 (admin / admin123)
# User Frontend: http://SERVER_IP:25137
# Backend API: http://SERVER_IP:26039If you are using Windows with Docker Desktop, you can use PowerShell to execute the following commands:
# Clone the v3.1.0 release
git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git
cd ruoyi-ai
# Create the environment configuration file
Copy-Item docs\docker\ruoyi-ai\.env.example docs\docker\ruoyi-ai\.env
# Pin the image version
(Get-Content docs\docker\ruoyi-ai\.env) `
-replace '^RUIYI_VERSION=.*', 'RUIYI_VERSION=v3.1.0' |
Set-Content docs\docker\ruoyi-ai\.env
# Check the environment configuration
Get-Content docs\docker\ruoyi-ai\.env
# Pull pre-built images from GHCR and start all services
docker compose --env-file docs\docker\ruoyi-ai\.env `
-f docs\docker\ruoyi-ai\docker-compose-all.yaml pull
docker compose --env-file docs\docker\ruoyi-ai\.env `
-f docs\docker\ruoyi-ai\docker-compose-all.yaml up -d
# Check service status
docker compose --env-file docs\docker\ruoyi-ai\.env `
-f docs\docker\ruoyi-ai\docker-compose-all.yaml psThe default Compose file also publishes MySQL (23306), Redis (26379),
Weaviate (28080), and MinIO (29000/29090). For production deployments,
change the default MySQL and MinIO passwords and expose only the application
ports through the firewall or a reverse proxy.
To upgrade to another published release, update RUIYI_VERSION in
docs/docker/ruoyi-ai/.env, then run docker compose pull and
docker compose up -d with the same --env-file and -f options. Do not use
docker compose down -v unless you intend to delete persistent data volumes.
If you need to build backend services from source, follow these steps:
# Enter backend project directory
cd ruoyi-ai
# Start backend service (build from source)
docker-compose up -d --build
# Wait for backend service to start
docker-compose logs -f backend# Enter admin panel project directory
cd ruoyi-admin
# Build and start admin panel
docker-compose up -d --build
# Access admin panel
# URL: http://localhost:5666# Enter user frontend project directory
cd ruoyi-web
# Build and start user frontend
docker-compose up -d --build
# Access user frontend
# URL: http://localhost:5137| Service | One-click Port | Step-by-step Port | Description |
|---|---|---|---|
| Admin Panel | 25666 | 5666 | Admin backend access |
| User Frontend | 25137 | 5137 | User frontend access |
| Backend Service | 26039 | 6039 | Backend API service |
| MySQL | 23306 | 23306 | Database service |
| Redis | 26379 | 6379 | Cache service |
| Weaviate | 28080 | 28080 | Vector database |
| MinIO API | 29000 | 9000 | Object storage API |
| MinIO Console | 29090 | 9090 | Object storage console |
Want to learn more about installation, deployment, configuration, and secondary development?
- Model and API Key configuration in ruoyi-admin (Chinese)
- Dify Cloud setup for local development (Chinese)
We warmly welcome community contributions! Whether you are a seasoned developer or just getting started, you can contribute to the project 💪
- Fork the project to your account
- Create a branch (
git checkout -b feature/new-feature-name) - Commit your changes (
git commit -m 'Add new feature') - Push to the branch (
git push origin feature/new-feature-name) - Create a Pull Request
💡 Tip: We recommend submitting PRs to GitHub, we will automatically sync to other code hosting platforms
This project is licensed under the MIT License. See the LICENSE file for details.
Thanks to the following excellent open-source projects for their support:
- Langchain4j - Powerful Java LLM development framework
- RuoYi-Vue-Plus - Mature enterprise-level rapid development framework
- Vben Admin - Modern Vue admin template
Thanks to the following sponsors for supporting this project:
Visit Atlas Cloud · Coding Plan Promotion A full-modal AI inference platform that gives developers a unified AI API, supporting video generation, image generation, and LLMs. Connect once to access 300+ curated models.
Sign up to claim 25 million tokens — go now Enjoy ByteDance's in-house Doubao models plus full-power open-source SOTA models, covering text, VLM, and image generation — all modalities in one stop: Seed-2.1, Seedream-5.0, GLM-5.2, DeepSeek, and more. Not just for coding — it can also tackle complex long-horizon Agent tasks!
 Scan to add author on WeChat Join group for learning |
 Douyin Video Tutorials Open Douyin, scan & follow to watch video tutorials |
 QQ Tech Exchange Group Technical discussion |
⭐ Star to Support • Fork to Contribute • 📚 中文 • 📖 Complete Documentation
Built with ❤️, maintained by the RuoYi AI open-source community