rclip - AI驱动的命令行照片搜索工具

rclip是一款由OpenAI出色的CLIP神经网络驱动的命令行照片搜索工具。

安装

Linux

sudo snap install rclip

<details> <summary>其他安装选项（AppImage和<code>pip</code>）</summary>

如果您的Linux发行版不支持snap，您可以使用以下替代安装选项：

AppImage（独立的x86_64可执行文件）

在Linux x86_64上，您可以将rclip安装为独立的可执行文件。

从最新的发布版本下载AppImage。
执行以下命令：

chmod +x <下载的AppImage文件名>
sudo mv <下载的AppImage文件名> /usr/local/bin/rclip

使用<code>pip</code>

pip install --extra-index-url https://download.pytorch.org/whl/cpu rclip

</details>

macOS

brew install yurijmikhalevich/tap/rclip

<details> <summary>其他安装选项（<code>pip</code>）</summary>

pip install rclip

</details>

Windows

从最新的发布版本下载"*.msi"文件。
运行安装程序安装rclip。

<details> <summary>其他安装选项（<code>pip</code>）</summary>

pip install rclip

</details>

使用方法

cd photos && rclip "搜索查询"

当您第一次在特定目录中运行rclip时，它会提取照片的特征，这需要一些时间。具体时间取决于您的CPU和要搜索的图片数量。在我运行旧版Intel Celeron J3455的NAS上处理73000张照片大约需要一天时间，在我的M1 Max CPU的MacBook上索引50000张图片需要7分钟，而在同一台MacBook上处理128万张图片需要3小时。

详细演示请观看视频：https://www.youtube.com/watch?v=tAJHXOkHidw。

相似图片搜索

您可以通过传递文件路径甚至图片文件的URL作为查询，rclip将找到与您用作查询的图片最相似的图片。如果您通过相对路径引用本地图片，您必须在路径前加上./。例如：

cd photos && rclip ./cat.jpg

# 或使用URL
cd photos && rclip https://raw.githubusercontent.com/yurijmikhalevich/rclip/main/tests/e2e/images/cat.jpg

观看此视频了解图片到图片搜索的演示：https://www.youtube.com/watch?v=1YQZKeCBxWM。

组合多个查询

您可以将图片和文本查询相加减，以下是一些使用示例：

cd photos && rclip horse + stripes
cd photos && rclip apple - fruit
cd photos && rclip "./new york city.jpg" + night
cd photos && rclip "2:golden retriever" + "./swimming pool.jpg"
cd photos && rclip "./racing car.jpg" - "2:sports car" + "2:snow"

如果您想看看这些查询在128万张图片的ImageNet-1k数据集上的表现，请查看YouTube上的演示：https://www.youtube.com/watch?v=MsTgYdOpgcQ。

如何预览结果？

如果您使用的是 iTerm2、Konsole（22.04及更高版本）、wezterm、Mintty 或 mlterm 中的任何一个，您只需要向 rclip 传递 --preview（或 -p）参数即可：

rclip -p kitty

<details> <summary>使用其他终端或查看器</summary>

如果您使用的是其他终端或想在您选择的查看器中查看结果，您可以将 rclip 的输出传递给它。例如，在 Linux 上，以下命令将在您的默认图像查看器中打开"kitty"的前5个结果：

rclip -f -t 5 kitty | xargs -d '\n' -n 1 xdg-open

-f 参数或 --filepath-only 使 rclip 只打印文件路径，不包括分数或标题，这使得它非常适合与自定义查看器一起使用，如示例所示。

我更喜欢使用 feh 的缩略图模式来预览多个结果：

rclip -f -t 5 kitty | feh -f - -t

</details>

获取帮助

https://github.com/yurijmikhalevich/rclip/discussions/new/choose

贡献

本仓库遵循 Conventional Commits 标准。

从源代码本地运行

要从源代码本地运行 rclip，您必须安装 Python 和 Poetry。

然后执行：

# 克隆源代码仓库
git clone git@github.com:yurijmikhalevich/rclip.git

# 安装依赖项和 rclip
cd rclip
poetry install

# 激活新的 poetry 环境
poetry shell

如果 poetry 环境处于激活状态，您可以按照上面使用部分的描述在本地使用 rclip。

贡献者 ✨

感谢这些优秀的人和组织（表情符号键）：

<table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/ramayer"><img src="https://avatars.githubusercontent.com/u/72320?v=4?s=100" width="100px;" alt="ramayer"/><br /><sub><b>ramayer</b></sub></a><br /><a href="https://github.com/yurijmikhalevich/rclip/commits?author=ramayer" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://www.caphyon.com"><img src="https://avatars.githubusercontent.com/u/15829334?v=4?s=100" width="100px;" alt="Caphyon"/><br /><sub><b>Caphyon</b></sub></a><br /><a href="#infra-Caphyon" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> </tr> </tbody> </table>

感谢 Caphyon 和 Advanced Installer 团队慷慨地为 rclip 项目提供 Professional Advanced Installer 许可证，用于创建 Windows 安装程序。

本项目遵循 all-contributors 规范。欢迎任何形式的贡献！