MaxKB
무엇인가
MaxKB는 Max Knowledge Brain의 약자로, 조직이 가진 문서를 검색 가능한 지식으로 바꿔 LLM 질의응답에 연결하는 서버 애플리케이션이다. 사내 지식베이스, 고객 상담, 교육·연구용 질의응답처럼 답변의 근거가 필요한 영역에 배치된다.
어떻게 동작하나
동작은 지식 처리와 실행의 두 갈래로 나뉜다. 지식 쪽은 문서 직접 업로드나 온라인 문서 자동 크롤링으로 입력을 받아 자동 텍스트 분할과 벡터화를 거쳐 PostgreSQL + pgvector에 저장한다. 실행 쪽은 워크플로 엔진이 노드를 연결해 처리 순서를 정하고, 함수 라이브러리와 MCP 도구 호출로 외부 기능을 붙인다. 검색된 벡터는 프롬프트에 컨텍스트로 주입되어 대형 모델의 환각을 줄인다. 프론트엔드는 Vue.js, 백엔드는 Python/Django, LLM 연결 계층은 LangChain으로 구성된다.
무엇과 다른가
같은 기능을 직접 만들면 LangChain으로 분할·임베딩·검색 파이프라인을 짜고, 벡터 저장소를 세우고, 관리 UI와 권한을 따로 붙여야 한다. MaxKB는 이 조각들을 하나의 애플리케이션으로 묶는다. 모델 계층은 특정 제공자에 고정되지 않아 DeepSeek·Llama·Qwen 같은 사설 모델과 OpenAI·Claude·Gemini·MiniMax 같은 공개 모델을 같은 방식으로 지정한다.
어떻게 쓰나
Docker 컨테이너로 실행하며 웹 인터페이스는 8080 포트에서 열린다. 기본 관리자 계정은 admin / MaxKB@123.. 이다. 서드파티 업무 시스템에는 코드를 쓰지 않고 임베드해 기존 시스템에 질의응답 기능을 붙인다.
전제와 한계
라이선스는 GPLv3다. 저장소로 PostgreSQL과 pgvector 확장을 쓰고, 입출력에서 텍스트·이미지·오디오·비디오를 네이티브로 다룬다. Docker 이미지 pull이 실패하는 환경을 위해 오프라인 설치 문서를 별도로 제공한다.
관련 논문 5
유사 도구
- ragflow비정형 문서를 파싱·청킹해 검색 증강 생성 파이프라인과 에이전트 워크플로를 한 엔진에서 돌리는 오픈소스 RAG 서버다.
- onyxLLM 애플리케이션 계층으로, RAG·웹 검색·코드 실행·에이전트를 갖춘 셀프호스팅 AI 채팅 플랫폼이다. 50개 이상 커넥터로 사내 데이터를 색인한다.
- difyLLM 애플리케이션을 워크플로·RAG·에이전트·모델 관리·관측까지 한 워크스페이스에서 만들고, 클라우드나 셀프호스팅으로 배포하는 오픈소스 플랫폼이다.
- Langchain-ChatchatLangChain 위에 지식베이스 검색과 Agent를 얹어 오픈소스 LLM만으로 오프라인 질의응답을 구성하는 Python 애플리케이션이다.
- haystack검색·라우팅·메모리·생성을 명시적 파이프라인과 에이전트 워크플로로 조립하는 Python LLM 오케스트레이션 프레임워크다.
- FastGPTLLM 위에 지식베이스 RAG 검색과 시각적 워크플로 편집을 얹어 질의응답 시스템을 구성하는 TypeScript 플랫폼이다.