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 等兼容终端提供内联图片预览。