3.2.122658.3 MB
MIT
strict
core22
Semantic photo search for the command line
rclip is a command-line semantic photo search tool powered by OpenCLIP's top-performing ViT-B/32 model. Search a local photo library with natural-language queries, similar image search, or mixed text and image queries directly from the terminal. It builds on the CLIP architecture introduced by OpenAI.
Usage:
The first time you run rclip in a directory, it extracts features from your images to build the search index. How long this takes depends on your CPU and the number of images you search. It took about a day to process 73,000 photos on a NAS with an old Intel Celeron J3455.
For a detailed demonstration, watch the video: https://www.youtube.com/watch?v=tAJHXOkHidw.
You can also use an image as the query by passing a file path or image URL. You can also combine and subtract image and text queries. Check out the project's README on GitHub for more usage examples: https://github.com/yurijmikhalevich/rclip#readme.
Usage:
cd photos && rclip "search query"The first time you run rclip in a directory, it extracts features from your images to build the search index. How long this takes depends on your CPU and the number of images you search. It took about a day to process 73,000 photos on a NAS with an old Intel Celeron J3455.
For a detailed demonstration, watch the video: https://www.youtube.com/watch?v=tAJHXOkHidw.
You can also use an image as the query by passing a file path or image URL. You can also combine and subtract image and text queries. Check out the project's README on GitHub for more usage examples: https://github.com/yurijmikhalevich/rclip#readme.
Update History
3.2.0 (224) → 3.2.1 (226)10 Jun 2026, 00:15 UTC
3.1.0 (222) → 3.2.0 (224)9 Jun 2026, 23:45 UTC
3.0.10 (220) → 3.1.0 (222)8 Jun 2026, 23:00 UTC
3.0.9 (218) → 3.0.10 (220)8 Jun 2026, 01:45 UTC
3.0.8 (216) → 3.0.9 (218)22 May 2026, 03:45 UTC
3.0.7 (214) → 3.0.8 (216)15 May 2026, 07:45 UTC
3.0.5 (212) → 3.0.7 (214)11 May 2026, 07:30 UTC
3.0.3 (208) → 3.0.5 (212)10 May 2026, 12:15 UTC
3.0.1 (206) → 3.0.3 (208)10 May 2026, 06:45 UTC
3.0.0 (204) → 3.0.1 (206)4 May 2026, 03:45 UTC
2.1.6 (188) → 3.0.0 (204)4 May 2026, 02:31 UTC
2.1.5 (184) → 2.1.6 (188)6 Apr 2026, 12:22 UTC
2.1.5 (184) → 2.1.6 (188)6 Apr 2026, 03:57 UTC
6 Aug 2023, 07:52 UTC
9 Jun 2026, 23:47 UTC
13 Dec 2025, 09:47 UTC