당신이 설정할 수 있는 가장 간단한 셀프 호스팅 RAG (Apache 2.0, 20K stars)

대부분의 RAG 도구들은 단순함과 강력함 사이에서 하나를 선택하도록 만듭니다. MaxKB는 강력해지려고 노력하는 대신, 단순해지려고 노력하며 그 목표를 완벽히 달성했습니다. GitHub 별(star) 20K 개 이상. Apache 2.0 라이선스. 영어 콘텐츠가 거의 없습니다. 여기 가이드를 소개합니다.

MaxKB란 무엇인가? MaxKB (Max Knowledge Base)는 1Panel 팀이 만든 지식 베이스 질의응답 (Q&A) 시스템입니다. Ollama를 포함하여 모든 OpenAI 호환 API에 연결할 수 있으며, 문서를 업로드하고, 질문을 던지며, 채팅 위젯을 어떤 웹사이트에도 임베드(embed)할 수 있습니다. 마지막 부분이 핵심 기능(killer feature)입니다. MaxKB는 어떤 HTML 페이지에도 채팅 위젯을 떨어뜨릴 수 있는 JavaScript 스니펫(snippet)을 생성합니다. 단 하나의 스크립트 태그만 있으면 됩니다. iframe도 필요 없고, 백엔드 변경도 필요 없습니다. Apache 2.0 라이선스이므로 제한 없이 상용 제품에 임베드할 수 있습니다.

설정은 3개의 명령어로 5분 이내에 완료됩니다. 레포지토리(repo)를 클론(clone)하고, .env.example을 .env로 복사한 다음, docker compose up -d를 실행하세요. localhost:8081 접속 → admin / admin123 입력 → Settings → Model Provider → Ollama → http://ollama:11434 로 설정합니다. 지식 베이스를 생성하고, PDF를 업로드한 뒤, 질문을 시작하세요. 이것이 설정의 전부입니다. 전체 docker-compose: maxkb-english-guide

위젯 임베드 (Embed Widget)
MaxKB는 JavaScript 스니펫을 생성합니다. 이를 어떤 HTML 페이지에든 넣으면 오른쪽 하단에 채팅 위젯이 나타납니다. iframe도 필요 없고, 백엔드 변경도 필요 없습니다. 이것이 MaxKB를 다른 RAG 도구들 사이에서 독특하게 만드는 점입니다. 임베드되도록 설계되었습니다. 경로: Application → 본인의 앱 → Embed → 스크립트 태그 복사 → 모든 HTML 페이지에 붙여넣기.

API
Python, JavaScript, curl, n8n 등 HTTP를 사용하는 모든 환경에서 작동합니다. Bearer 토큰과 함께 /api/application/{app_id}/chat/completions로 질문을 POST 하세요. {"content": "the answer"}를 반환합니다. 레포지토리에 전체 Python + JavaScript 예제가 포함되어 있습니다.

MaxKB vs 대안들

구분	MaxKB	WeKnora	FastGPT	RAGFlow
설정 시간 ⚡	3분	5분	10분	15분
라이선스	Apache 2.0	MIT	커스텀*	Apache 2.0
위젯 임베드	✅	❌	❌	❌
자율 에이전트 (Autonomous agent)	❌	✅	✅	❌
PDF 표 파싱 (PDF table parsing)	기본 (Basic)	기본 (Basic)	좋음 (Good)	매우 우수 (Excellent)
상용 임베드	✅	✅	❌	✅

*FastGPT는 SaaS 재판매를 금지합니다.

다음과 같은 경우 MaxKB를 선택하세요: 5분 만에 작동하는 지식 베이스가 필요한 경우, 위젯 임베드가 필요한 경우, Apache 2.0 라이선스가 중요한 경우.

다음과 같은 경우에는 다른 도구를 선택하세요: 복잡한 PDF가 필요한 경우 → RAGFlow · 파이프라인 빌더 (pipeline builder)가 필요한 경우 → FastGPT · 멀티홉 추론 (multi-hop reasoning)이 필요한 경우 → WeKnora

지원되는 LLM 제공업체 (Supported LLM Providers)
MaxKB는 다음과 같은 모든 OpenAI 호환 API와 함께 작동합니다: Ollama (로컬, 무료), OpenAI, GroGro, Together, 또는 LiteLLM 프록시를 통한 Anthropic.

전체 가이드 (Full Guide) → github.com/retrovirusretro/maxkb-english-guide
더 넓은 시리즈의 일부: → chinese-ai-tools-english-guide

MaxKB는 40페이지에 달하는 문서를 읽지 않고도 RAG를 빠르게 작동시키고 싶은 사람들에게 제가 추천하는 도구입니다.