rclip

rclip: herramienta de búsqueda de fotografías mediante línea de comandos impulsada por IA

[Blog] [Demostración en YouTube] [Artículo]

rclip es una herramienta de búsqueda de fotografías de línea de comandos impulsada por la increíble red neuronal CLIP de OpenAI.

Instalación

linux

sudo snap install rclip

Opciones alternativas (AppImage y pip )

Si su distribución de Linux no es compatible con Snap, puede utilizar una de las opciones de instalación alternativas:

AppImage (ejecutable x86_64 autónomo)

En Linux x86_64, puede instalar rclip como un ejecutable autónomo.

1. Descargue AppImage de la última versión.

2. Ejecute los siguientes comandos:

chmod +x < downloaded AppImage filename >
sudo mv < downloaded AppImage filename > /usr/local/bin/rclip

Usando pip

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

macos

brew install yurijmikhalevich/tap/rclip

Opción alternativa ( pip )

pip install rclip

ventanas

1. Descargue "*.msi" de la última versión.
2. Instale rclip ejecutando el instalador.

Opción alternativa ( pip )

pip install rclip

Uso

 cd photos && rclip " search query "

Cuando ejecuta rclip por primera vez en un directorio en particular, extraerá características de las fotos, lo que lleva tiempo. El tiempo que tomará depende de su CPU y de la cantidad de imágenes que buscará. Me tomó aproximadamente un día procesar 73 mil fotos en mi NAS, que ejecuta un antiguo Intel Celeron J3455, 7 minutos para indexar 50 mil imágenes en mi MacBook con una CPU M1 Max y tres horas para procesar 1,28 millones de imágenes en el mismo macbook.

Para ver una demostración detallada, mire el vídeo: https://www.youtube.com/watch?v=tAJHXOkHidw.

Búsqueda de imágenes similares

Puede utilizar otra imagen como consulta pasando una ruta de archivo o incluso una URL al archivo de imagen, y rclip encontrará las imágenes más similares a la que utilizó como consulta. Si está haciendo referencia a una imagen local a través de una ruta relativa, debe anteponerle ./ . Por ejemplo:

 cd photos && rclip ./cat.jpg

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

Mire este video para ver la demostración de búsqueda de imagen a imagen: https://www.youtube.com/watch?v=1YQZKeCBxWM.

Combinando múltiples consultas

Puede sumar y restar consultas de imágenes y texto entre sí; Aquí hay algunos ejemplos de uso:

 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 "

Si desea ver cómo funcionan estas consultas cuando se ejecutan en el conjunto de datos ImageNet-1k de 1,28 millones de imágenes, consulte la demostración en YouTube: https://www.youtube.com/watch?v=MsTgYdOpgcQ.

¿Cómo previsualizo los resultados?

Si está utilizando iTerm2, Konsole (versión 22.04 y superior), wezterm, Mintty o mlterm, todo lo que necesita hacer es pasar el argumento --preview (o -p ) a rclip :

rclip -p kitty

Usando un terminal o visor diferente

Si está utilizando cualquier otro terminal o desea ver los resultados en el visor de su elección, puede pasarle la salida de rclip . Por ejemplo, en Linux, el siguiente comando abrirá los 5 mejores resultados para "kitty" en su visor de imágenes predeterminado:

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

El parámetro -f o --filepath-only hace que rclip imprima solo las rutas de los archivos, sin puntuaciones ni el encabezado, lo que lo hace ideal para usarlo junto con un visor personalizado como en el ejemplo.

Prefiero usar el modo de miniatura de feh para obtener una vista previa de varios resultados:

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

obtener ayuda

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

Contribuyendo

Este repositorio sigue el estándar de compromisos convencionales.

Ejecutando localmente desde el código fuente

Para ejecutar rclip localmente desde el código fuente, debe tener Python y Poetry instalados.

Entonces haz:

 # clone the source code repository
git clone [email protected]:yurijmikhalevich/rclip.git

# install dependencies and rclip
cd rclip
poetry install

# activate the new poetry environment
poetry shell

Si el entorno de poesía está activo, puede usar rclip localmente, como se describe en la sección Uso anterior.

Colaboradores

Gracias a estas maravillosas personas y organizaciones (clave emoji):

ramayer

cafión ?

AbId Khan

Gracias a Caphyon y al equipo de Advanced Installer por proporcionar generosamente al proyecto rclip la licencia Professional Advanced Installer para crear el instalador de Windows.

Este proyecto sigue la especificación de todos los contribuyentes. ¡Las contribuciones de cualquier tipo son bienvenidas!

Licencia

MIT