개요

Docufinder 저장소의 앱 이름은 Anything이며, 파일명을 몰라도 문서 안의 내용을 검색할 수 있게 만드는 로컬 우선 데스크톱 검색 도구다. HWP/HWPX·Word·PowerPoint·Excel·PDF·이미지·텍스트·메일 파일을 등록 폴더에서 자동 인덱싱하고, 본문 검색·파일명 검색·미리보기·문서 비교를 제공한다. 선택 기능으로 Gemini API를 연결해 문서 근거와 페이지를 표시하는 질의응답과 온라인 요약을 사용할 수 있으며, AI를 끄면 검색과 인덱싱은 로컬에서 동작한다. 저장소 README 기준 Windows x64와 Apple Silicon macOS를 지원하고, React 19 프론트엔드와 Rust/Tauri 백엔드로 구성된다.

핵심 포인트

  • 본문 검색: SQLite FTS5 기반 키워드 검색으로 수천 개 문서의 내용을 찾고, 파일명 검색은 인메모리 캐시로 처리한다.
  • 검색 모드: 키워드·파일명·스마트 검색·Anything 질의 모드를 제공하며, 구문·제외·확장자·경로·수정일·근접 검색 연산자를 지원한다.
  • 문서 형식: HWP5·HWP3·HWPX, DOCX, PPTX, XLSX·XLS, PDF, 이미지, TXT·MD, EML을 지원한다. HWP/HWPX 파싱에는 kordoc 엔진을 사용한다고 README에 적혀 있다.
  • 로컬 처리: 키워드·시맨틱 검색, 임베딩, OCR, 파일 인덱싱은 로컬 처리로 설명되어 있다. AI 질의응답이나 온라인 요약을 켠 경우에만 관련 문서 청크 또는 문서 텍스트가 Gemini API로 전송된다.
  • 실시간 동기화: 파일 추가·수정·삭제를 감시해 수동 재인덱싱 없이 인덱스를 갱신한다.
  • 미리보기·비교: 원본 레이아웃 미리보기, 전체화면 확대, 문서 내 찾기, 서로 다른 버전의 문서 비교를 제공한다.
  • 선택적 오프라인 요약: 온라인 Gemini 요약 외에 로컬 TextRank 요약 경로를 제공한다고 README는 설명한다.

아키텍처

  • Frontend: React 19, TypeScript 5.9, Tailwind CSS 4
  • Desktop shell: Tauri 2.10
  • Backend: Rust 2021, Clean Architecture
  • 검색: SQLite FTS5, usearch HNSW 벡터 검색, RRF 하이브리드 병합
  • 한국어 처리: Lindera 형태소 분석
  • 임베딩·OCR: ONNX Runtime, KoSimCSE-roberta, PaddleOCR ONNX
  • 스토리지: SQLite와 usearch 인덱스
  • AI: Gemini API 기반 RAG 질의응답·온라인 요약

README의 구조상 React는 UI 계층을 담당하고, Tauri IPC가 Rust 백엔드와 연결된다. Rust 쪽은 파서·인덱서·검색 엔진을 분리하고, FTS5·벡터 검색·파일 감시를 결합해 키워드와 의미 기반 검색을 함께 제공하는 형태다.

설치 및 대상 환경

  • Windows: Releases에서 Anything_<버전>_x64-setup.exe를 다운로드한다. WebView2가 없는 환경은 런타임 설치 프로그램을 먼저 설치해야 한다.
  • macOS: Apple Silicon 전용 DMG를 사용한다. README는 macOS 11 Big Sur 이상을 요구하며 Intel Mac은 지원하지 않는다고 설명한다.
  • 공통: RAM 8GB 이상, 디스크 여유 공간 1GB 이상을 권장하며 최초 실행 시 검색 모델 다운로드를 위해 인터넷 연결이 필요하다.
  • 라이선스: Business Source License 1.1. README 기준 비프로덕션 사용은 자유롭고, 프로덕션·상용 사용은 별도 라이선스가 필요하며 2030-04-15 이후 Apache License 2.0으로 전환된다.

도입 시 주의점

  • AI 기능을 끄면 로컬 검색 도구로 사용할 수 있지만, 시맨틱 검색·OCR 모델의 초기 다운로드와 로컬 저장 공간은 필요하다.
  • Gemini 질의응답·온라인 요약을 활성화하면 관련 텍스트가 외부 API로 전송되므로 문서 보안 정책을 확인해야 한다.
  • BSL 1.1은 일반적인 MIT·Apache-2.0과 사용 조건이 다르므로 상용 도입 전 라이선스 조항을 직접 확인해야 한다.
  • GitHub API 스냅샷(2026-07-13) 기준 저장소는 공개 상태이며 Rust 프로젝트로 분류되고, 477 stars·61 forks가 표시됐다. 수치는 이후 변할 수 있다.

관련 노트

원문