chrisryugj/Docufinder

Anything – 100 % 로컬 문서 검색 엔진

무엇인가요 – PC의 파일을 인덱스하고 파일 이름뿐만 아니라 내용으로 검색할 수 있는 데스크톱 애플리케이션 (Windows & macOS Apple Silicon). 핵심 검색 기능은 완전히 오프라인으로 작동하며, 필요 시 LLM 서비스(Gemini, OpenAI 호환 서버(Ollama, vLLM, LiteLLM 등)에 연결하여 자연어 기반 Q&A 및 문서 요약을 수행할 수 있습니다.

주요 기능

기능	작동 방식
풀텍스트 검색	폴더를 등록하고 SQLite FTS5 인덱스와 벡터 인덱스(usearch HNSW)를 생성합니다. 수천 개의 파일에서도 밀리초 단위로 검색 결과를 반환합니다.
파일명 검색	메모리 내 캐시를 통해 "Everything 스타일"의 즉각적인 파일명 검색을 제공하며, 정렬 가능한 열 보기 기능을 지원합니다.
AI Q&A (옵션)	사용자의 자연어 질문과 관련성 높은 텍스트 조각을 Gemini 또는 OpenAI 호환 엔드포인트로 전송합니다. 답변은 출처 문서와 페이지 번호와 함께 표시되며, Markdown으로 저장할 수 있습니다.
AI 요약 (옵션)	파일을 오른쪽 클릭 → 요약; 선택한 LLM이 문서 유형에 적합한 간결한 요약을 생성합니다.
실시간 동기화	파일이 추가, 수정, 삭제될 때 파일 시스템 감시기가 인덱스를 자동으로 업데이트합니다.
미리보기 및 레이아웃 보기	결과를 클릭하여 미리보기를 엽니다. HWP/HWPX(rhwp를 통해), PDF(페이지 이미지), DOCX/PPTX/XLSX를 진짜 레이아웃으로 렌더링합니다. 암호 보호된 HWP/HWPX는 미리보기에서 암호를 입력하여 열 수 있습니다.
내보내기	검색 결과나 전체 문서를 Markdown 형식으로 저장; 다른 앱으로 파일을 드래그 앤 드롭; 동일 문서의 두 버전을 옆으로 비교할 수 있습니다.
OCR 및 수식 탐지	선택적 OCR(PaddleOCR)로 스캔된 PDF 및 이미지에서 텍스트를 추출합니다. OCR 옵션 활성화 시 LaTeX 수식도 인식 가능합니다.
라이트 빌드	네트워크 코드 없이 작동하는 Windows 전용 바이너리로, 오프라인 환경(네트워크 차단)에 적합합니다 (AI, OCR, 자동 업데이트 없음).

지원 포맷 – HWP/HWPX(구 HWP3 포함), DOCX, PPTX, XLSX/XLS, PDF, 일반적인 이미지 형식, TXT/MD, EML 이메일 파일. 한국어 처리는 Lindera 형태소 분석을 사용하며, 임베딩은 KoSimCSE-roberta ONNX 모델로 생성됩니다.

설치

• Windows – Anything_<ver>_x64-setup.exe (약 380MB)를 다운로드합니다. Microsoft Edge WebView2가 설치되어 있지 않은 경우, MicrosoftEdgeWebView2RuntimeInstallerX64.exe도 다운로드하여 먼저 설치하세요. 제한된 기업용 PC를 위한 "라이트" 설치 프로그램(Anything.Lite_…_x64-setup.exe)도 제공됩니다.
• macOS (Apple Silicon) – .dmg를 다운로드하고 Applications 폴더로 드래그한 후, 오른쪽 클릭 → 열기 (또는 xattr로 제한 해제)로 실행합니다. Intel 맥은 지원되지 않습니다. Apple Silicon만 지원됩니다.
• 최소 하드웨어 사양: 8GB RAM (16GB 권장), 최소 1GB 이상의 여유 디스크 공간. 모든 핵심 파서, OCR 모델, 검색 엔진은 로컬에서 실행되며, 첫 실행 이후 백그라운드 다운로드는 필요하지 않습니다 (옵션 AI/세미틱 모델은 각각 약 106MB).

AI 통합

• 설정 → AI에서 활성화하고 Google Gemini 또는 OpenAI 호환 엔드포인트(자체 호스팅 LLM(Ollama, vLLM, LiteLLM 등) 포함)의 API 키를 입력하세요.
• 비활성화 시 순수한 로컬 검색 도구로 작동하며, 기기에서 네트워크 트래픽이 전혀 발생하지 않습니다.
• AI 활성화 시 유일한 외부 트래픽은 사용자의 질문과 선택된 텍스트 조각이며, 응답은 설정된 LLM에서 반환됩니다.

아키텍처 개요

React 19 + TypeScript + Tailwind   ← UI
Tauri 2 IPC                         ← 브리지
Rust 백엔드 (클린 아키텍처)   ← 파서, 인덱서, 검색 엔진
  ├─ 파서: hwpx (kordoc), docx, pdf/ocr, txt, eml …
  ├─ 인덱서: SQLite FTS5 (키워드), usearch HNSW (세미틱)
  └─ 검색: 키워드 + 하이브리드 RRF 병합
SQLite + ONNX 런타임 (임베딩, OCR)은 로컬에 저장됨

라이선스 – Business Source License 1.1 (비생산용 무료; 상용 배포에는 유료 라이선스 필요). 2030년 4월 15일 이후 코드는 자동으로 Apache 2.0 라이선스로 전환됩니다. 제3자 컴포넌트(PDFium, ONNX Runtime, PaddleOCR, Node.js, kordoc 등)는 THIRD_PARTY_NOTICES.md에 나열되어 있습니다.

누가 도움을 받을 수 있나요?

• 클라우드에 업로드하지 않고도 대규모 한국어 문서(계약서, 보고서, 회의록 등) 내 정보를 찾고 싶은 전문가.
• 데이터 보안 정책이 엄격한 기업에서 내부 문서에 대해 옵션 기반 AI 지원 Q&A를 원하는 기업.
• 리치 미리보기, 내보내기, 차이 비교 기능을 갖춘 Windows 네이티브, Electron 대체 데스크톱 UI를 선호하는 파워 유저.

---

위 모든 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.