ageerle/ruoyi-ai

어떤 프로젝트인가요?

핵심 기능

• 01DeepSeek, Zhipu, OpenAI 등 여러 모델에 연결하는 다중 LLM 제공자 관리
• 02Milvus, Weaviate 또는 Qdrant 기반의 로컬 RAG 지식 베이스
• 03SSE 스트리밍 실행을 지원하는 드래그 앤 드롭 방식의 비주얼 워크플로 디자이너
• 04MCP 프로토콜 연동 및 Skills 기반 도구 확장
• 05Langchain4j 기반 Supervisor 모드 멀티 에이전트 오케스트레이션
• 06백엔드, 관리자 패널, 사용자 프런트엔드를 위한 Docker Compose 배포

활용 사례

• RAG를 활용해 사내 문서를 기반으로 한 기업용 챗봇 구축
• 수동 검토 단계가 포함된 비주얼 워크플로로 승인 또는 알림 프로세스 자동화
• 관리자 패널과 사용자 계정이 내장된 Java 기반 AI 어시스턴트 플랫폼 운영

빠른 시작

1. 1

   v3.1.0 릴리스를 클론합니다

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

   환경 파일을 만들고 이미지 버전을 고정합니다

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

   GHCR에서 미리 빌드된 이미지를 가져옵니다

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

   모든 서비스를 백그라운드에서 시작합니다

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

사용 전 알아둘 점

• !원클릭 배포를 실행하려면 Docker와 Docker Compose가 필요합니다.
• !기본 Compose 파일은 MySQL, Redis, Weaviate, MinIO 포트를 외부에 공개하므로 프로덕션 환경에서는 비밀번호를 변경해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ruoyi-ai은(는) 무엇인가요?

다중 LLM 제공자 관리, RAG 지식 베이스, 비주얼 워크플로와 멀티 에이전트 오케스트레이션을 지원하는 Java/Spring Boot 풀스택 AI 어시스턴트 플랫폼입니다. RuoYi AI는 Spring Boot 3와 Langchain4j를 기반으로 구축된 엔터프라이즈 지향 AI 에이전트 플랫폼입니다. 하나의 관리자 인터페이스에서 DeepSeek, Zhipu, OpenAI, Bailian 등 여러 LLM 제공자를 연결할 수 있으며, Coze, Dify, FastGPT, RAGFlow 같은 플랫폼과도 연동됩니다.

ruoyi-ai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ruoyi-ai은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ruoyi-ai은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ruoyi-ai의 마지막 커밋은 2026년 10월 21일입니다.

ruoyi-ai은(는) 어디에 사용할 수 있나요?

RAG를 활용해 사내 문서를 기반으로 한 기업용 챗봇 구축 수동 검토 단계가 포함된 비주얼 워크플로로 승인 또는 알림 프로세스 자동화 관리자 패널과 사용자 계정이 내장된 Java 기반 AI 어시스턴트 플랫폼 운영

ruoyi-ai는 어떻게 설치하나요?

v3.1.0 릴리스를 클론합니다: git clone --depth 1 --branch v3.1.0 https://github.com/ageerle/ruoyi-ai.git 환경 파일을 만들고 이미지 버전을 고정합니다: cp docs/docker/ruoyi-ai/.env.example docs/docker/ruoyi-ai/.env GHCR에서 미리 빌드된 이미지를 가져옵니다: 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

ruoyi-ai은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ageerle/ruoyi-ai