Show GN: OpenDocuments – 흩어진 조직 문서를 자연어로 검색하는 오픈소스 RAG 플랫폼
(github.com/joungminsung)팀 문서가 GitHub, Notion, Drive, Confluence 등에 흩어져 있어서 찾기 힘든 문제를 해결하려고 만든 self-hosted RAG 플랫폼입니다.
문서 소스를 연결하면 파싱/청킹/임베딩해서 인덱싱하고, 자연어로 질문하면 출처와 함께 답변합니다.
- 커넥터: GitHub, Notion, GDrive, S3, Confluence, Swagger, 웹 크롤러, Tavily 웹 검색
- 파일 포맷: PDF, DOCX, XLSX, HTML, Jupyter, 소스코드, 이메일 등 12종
- LLM: Ollama로 로컬 실행 가능 (데이터 유출 없음). OpenAI/Claude/Gemini/Grok도 지원
- 검색: 벡터 + 키워드 하이브리드, 리랭킹, 할루시네이션 가드
- 한국어-영어 교차 검색
- MCP 서버로 Claude Code/Cursor 연동
- Web UI, CLI 17개 커맨드, TypeScript SDK
- 플러그인 시스템 (파서/커넥터/모델/미들웨어)
- Docker 배포 지원
스택: TypeScript, Hono, React, SQLite, LanceDB, Turborepo
테스트 51 스위트 / ~300개
MIT 라이선스입니다.
v0.2.0 업데이트 안내드립니다.
이번 버전의 핵심은 설치 허들 제거와 실사용성 개선입니다.
원터치 Ollama 통합 - 설치 여부 자동 감지 → 없으면 OS별 자동 설치 → 임베딩 모델 자동 풀링까지 한 번에. docker compose up 한 줄이면 로컬 LLM 포함 전체 스택이 올라갑니다.
멀티턴 대화 - 이전 버전은 단발성 질의만 가능했는데, 이제 문맥을 유지하면서 연속 대화가 됩니다.
보안 패치 10건+ - FTS5 SQL 인젝션, 경로 순회, OAuth state 고정 공격, ReDoS 등 커뮤니티 피드백 + 자체 감사로 잡아낸 것들 일괄 수정했습니다.
그 외: .env 자동 로딩, 모델 연결 실패 시 3회 재시도 + 구체적 에러 메시지, 플러그인 API 문서 전면 확장.
릴리즈 노트: https://github.com/joungminsung/OpenDocuments/releases/
npm 패키지 배포가 누락되어 있었습니다. 클론 후 설치가 안 되셨던 분들 죄송합니다. 지금은 정상 배포 완료했으니 Readme의 변경 된 명령어로 다시 시도해주시면 감사하겠습니다.