NetMD/simple-rag-app

Simple-RAG v0.1.0 — 첫 공개 버전

Simple-RAG는 HWP를 포함한 업무 문서를 내 컴퓨터 안에서 색인하고, 질문하면 근거 발췌와 함께 답을 찾아 주는 로컬 문서 검색·질의응답 데스크톱 앱입니다.

지원 플랫폼: macOS(Apple Silicon) · Windows 10/11(x86_64)

소스 코드: https://github.com/NetMD/Simple-RAG

다운로드

파일	대상	상태
Simple-RAG_0.1.0_aarch64.dmg	macOS(Apple Silicon)	서명·Apple 공증 완료본 — 경고 없이 실행됩니다
Simple-RAG_0.1.0_x64-setup.exe	Windows 10/11(x86_64)	무서명 — 아래 "처음 실행할 때" 안내를 참조하세요
SHA256SUMS-macos.txt · SHA256SUMS-windows.txt	공통	내려받은 파일이 손상되거나 바뀌지 않았는지 확인하는 값(체크섬)

SHA-256 체크섬:

c96c074b485fe481ef8a6924feac5c5fccddb3b72846ea6f7fc33a391f7124cf  Simple-RAG_0.1.0_aarch64.dmg
5e6f5c80e4ab9c6984a3c93f35ca812e8276b6c0a3f111762d3cde9941294324  Simple-RAG_0.1.0_x64-setup.exe

처음 실행할 때 (Windows)

Windows에서 처음 실행하면 "Windows의 PC 보호" 경고가 나올 수 있어요. [추가 정보]를 누른 뒤 [실행]을 누르면 실행돼요. 아직 서명 인증서를 붙이지 않아서 나오는 안내예요.

자세한 설치 절차는 Windows-설치-안내.md를 참조하세요.

주요 기능

• 문서 추가(색인): 한글(.hwp/.hwpx) · Word(.docx) · PowerPoint(.pptx) · PDF · 텍스트(.md/.txt) — 파일·폴더를 섞어 넣을 수 있습니다.
• 하이브리드 검색: 의미 기반 검색과 키워드 검색을 함께 쓰고, 정밀 재정렬로 상위 결과를 고릅니다. 근거 발췌와 표 원문 보기를 제공합니다.
• 근거 인용 답변: 검색된 근거에 출처를 붙여 답변을 만들어 줍니다(실시간 표시).
• 문서함 관리: 내용이 거의 같은 문서를 자동으로 묶어 주고, 문서별 열기·삭제를 지원합니다.
• 데이터 관리: 백업·복원·초기화, 저장 폴더·용량 확인.
• 화면 테마: 시스템 따라가기 · 라이트 · 다크.
• 외부 AI 연동(MCP) (macOS 전용)과 명령줄(CLI) 검색 도구.

전체 변경 내역은 CHANGELOG.md를 참조하세요.

시스템 요구 사항

• macOS: Apple Silicon(M 시리즈) 전용.
• Windows: Windows 10/11 64비트(x86_64). 화면 표시에 Microsoft Edge WebView2가 필요합니다 — 보통 기본 탑재되어 있고, 없으면 설치 중 자동으로 내려받습니다(인터넷 연결 필요).
• 첫 실행: 검색용 모델 2종(임베딩·리랭커)을 자동으로 내려받습니다(인터넷 연결 필요).
• 답변 생성(선택): LM Studio 등 OpenAI 호환 로컬 서버에 연결해 사용합니다.
  • 권장 생성 모델: Gemma 4 E2B (공식 GGUF, Q4_K_M 양자화)
  • 최소 환경: RAM 8GB 이상 (모델 파일 약 3.4GB · 다운로드는 사용자 실행)

알려진 제한

• Windows 설치 파일은 아직 무서명입니다 — 처음 실행할 때 SmartScreen 경고가 나올 수 있습니다(위 안내 참조 · 체크섬 파일 제공).
• 외부 AI 연동(MCP)은 macOS 전용입니다. 앱 안내 문구 그대로: "Windows에서는 아직 쓸 수 없어요 — macOS 전용 기능이에요". 검색·문서함·답변 등 나머지 기능은 Windows에서 그대로 쓸 수 있습니다.
• 스캔본(이미지) PDF는 지원하지 않습니다 — 이미지에서 글자를 읽어내는 기능(OCR)이 아직 없어, 안내와 함께 거부합니다.
• 암호가 걸린 문서는 지원하지 않습니다.
• 옛 형식(.doc/.ppt)과 Excel(.xls/.xlsx)은 지원하지 않습니다 — 안내와 함께 거부합니다.
• 텍스트 파일(.md/.txt)은 UTF-8 인코딩만 지원합니다.

문제 보고

문제가 생기면 아래 주소에 남겨 주세요(앱의 설정 화면에도 같은 주소가 표시됩니다):

https://github.com/NetMD/Simple-RAG/issues