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 など対応端末でインライン画像プレビューを提供。