README.md

---
license: mit
language:
  - ko
tags:
  - rag
  - desktop-app
  - korean
  - hwp
pretty_name: Simple-RAG
---

# 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](https://huggingface.co/NetMD/simple-rag-app/blob/main/Windows-%EC%84%A4%EC%B9%98-%EC%95%88%EB%82%B4.md)를 참조하세요.

## 주요 기능

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

전체 변경 내역은 [CHANGELOG.md](https://github.com/NetMD/Simple-RAG/blob/main/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