한국어 공공·업무 문서를 위한 로컬 데스크톱 RAG 앱입니다. HWP를 포함한 문서를 내 컴퓨터 안에서 색인하고, 하이브리드 검색으로 찾고, 근거를 인용해 답합니다 — 문서 원문은 밖으로 나가지 않습니다.
지원 플랫폼: macOS(Apple Silicon) · Windows 10/11(x86_64)
- HWP가 1급 시민 —
.hwp·.hwpx의 표까지 통째로 이해하는 표-aware 청킹. 정부·공공 문서의 답이 표 안에 있어도 찾습니다. - 완전 로컬 색인 — 임베딩(KURE-v1, ONNX)·검색·저장(SQLite + sqlite-vec)이 전부 내 컴퓨터에서 동작합니다.
- 하이브리드 검색 + 리랭커 — 의미 검색(dense)과 키워드 검색을 RRF로 융합한 뒤 bge-reranker-v2-m3로 재정렬합니다.
- 근거 인용 답변 — OpenAI 호환 로컬 서버(LM Studio 등)를 연결하면 검색 근거를 인용한 답변을 생성합니다.
- 문서 관리 — 중복 문서 자동 그룹, 문서 삭제, 백업/복원, 다크 테마.
- MCP 서버(macOS) — Claude 등 MCP 클라이언트에서 내 문서 검색을 도구로 쓸 수 있습니다.
| 형식 | 확장자 | 비고 |
|---|---|---|
| 한글 | .hwp .hwpx |
표 추출 포함 |
| Word · PowerPoint | .docx .pptx |
OOXML |
.pdf |
디지털 PDF(텍스트 레이어) — 스캔본 OCR 미지원 | |
| 텍스트 | .txt .md |
구형 바이너리(.doc .ppt)와 Excel(.xls .xlsx)은 지원하지 않습니다(안내 후 제외).
Hugging Face — NetMD/simple-rag-app 에서 받습니다.
| 파일 | 플랫폼 | 비고 |
|---|---|---|
Simple-RAG_*_aarch64.dmg |
macOS (Apple Silicon) | Apple 서명·공증 완료 |
Simple-RAG_*_x64-setup.exe |
Windows 10/11 (x86_64) | 무서명 — 아래 안내 참조 |
Windows에서 처음 실행하면 "Windows의 PC 보호" 경고가 나올 수 있어요. [추가 정보]를 누른 뒤 [실행]을 누르면 실행돼요. 아직 서명 인증서를 붙이지 않아서 나오는 안내예요.
첫 실행 시 온보딩에서 임베딩·리랭커 모델(약 4.6GB)을 자동으로 내려받습니다.
검색·근거 확인은 그 자체로 완결이고, 답변 생성은 OpenAI 호환 서버를 연결하면 켜집니다.
- LM Studio를 설치하고 Gemma 4 E2B 공식 GGUF(Q4_K_M) 를 로드한 뒤 로컬 서버를 시작합니다.
- Simple-RAG 설정 → 생성 프리셋에 서버 주소를 입력합니다(예:
http://127.0.0.1:1234/v1).
cd app && npm install
npm run tauri build # scripts/build-sidecars.sh가 자동 선행됩니다- 요구: Rust(stable) · Node.js 26 · (Windows) MSVC Build Tools + Git Bash
- 빌드 중 lindera 한국어 사전과 ONNX Runtime 프리빌트를 내려받으므로 네트워크가 필요합니다.
- 릴리스는 태그 push로 GitHub Actions가 빌드·서명·공증까지 수행합니다(
.github/workflows/release.yml).
GitHub Issues에 남겨 주세요.
- 프로젝트: MIT License
- 서드파티 의존성 748개의 라이선스 전문: THIRD_PARTY_LICENSES.md
- 모델·사전 자산 요약 고지: NOTICE — 임베딩·리랭커 모델(MIT·Apache-2.0)과 한국어 사전(mecab-ko-dic, Apache-2.0) 포함.