yurijmikhalevich/rclip

Semantic photo search for the command line

What it solves

rclip 은 대용량 로컬 사진 라이브러리를 수동으로 태그를 달거나 클라우드 기반 서비스에 의존하지 않고도 검색할 수 있는 문제를 해결합니다. 사용자는 자연어 설명이나 예시 이미지를 사용해 특정 사진을 찾을 수 있으며, 모든 데이터는 프라이버시가 보장된 오프라인 상태로 유지됩니다.

How it works

이 도구는 OpenCLIP ViT-B/32 AI 모델을 사용해 이미지의 의미적 인덱스를 생성합니다. 사용자가 쿼리를 입력하면 rclip 은 텍스트 또는 이미지 쿼리의 의미 임베딩을 로컬 사진 라이브러리의 인덱싱된 특징과 비교하여 가장 유사한 결과를 찾습니다. 증분 인덱싱을 지원하므로 이후 실행 시 새로 추가되거나 변경된 이미지만 처리해 시간을 절약합니다.

Who it’s for

Linux, macOS(Apple Silicon), Windows 환경의 커맨드라인 사용자로, 로컬 이미지 컬렉션을 프라이빗하고 빠르며 강력하게 검색하고자 하는 분들을 위해 설계되었습니다.

Highlights

  • Multi-modal Search: 자연어 쿼리, 이미지‑이미지 역검색, 텍스트와 이미지를 혼합한 복합 쿼리를 지원합니다.
  • Arithmetic Queries: 가중치 부여 및 항목 차감이 가능합니다(예: "2:golden retriever" + "./pool.jpg" - fruit).
  • Privacy-First: 완전히 오프라인으로 동작하며 클라우드 업로드가 없습니다.
  • Broad Format Support: JPG, PNG, WebP 등 표준 포맷을 인덱싱하고, RAW 파일(ARW, CR2, DNG)도 실험적으로 지원합니다.
  • Terminal Integration: iTerm2, WezTerm 등 호환 터미널에서 인라인 이미지 미리보기를 제공합니다.