rclip

rclip - Alat Pencarian Foto Baris Perintah yang Didukung AI

[Blog] [Demo di YouTube] [Makalah]

rclip adalah alat pencarian foto baris perintah yang didukung oleh jaringan saraf CLIP OpenAI yang mengagumkan.

Instalasi

Linux

sudo snap install rclip

Opsi alternatif (AppImage dan pip )

Jika distribusi Linux Anda tidak mendukung snap, Anda dapat menggunakan salah satu opsi instalasi alternatif:

AppImage (x86_64 mandiri yang dapat dieksekusi)

Di Linux x86_64, Anda dapat menginstal rclip sebagai executable mandiri.

1. Unduh AppImage dari rilis terbaru.

2. Jalankan perintah berikut:

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

Menggunakan pip

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

macOS

brew install yurijmikhalevich/tap/rclip

Opsi alternatif ( pip )

pip install rclip

jendela

1. Unduh "*.msi" dari rilis terbaru.
2. Instal rclip dengan menjalankan penginstal.

Opsi alternatif ( pip )

pip install rclip

Penggunaan

 cd photos && rclip " search query "

Saat Anda menjalankan rclip untuk pertama kalinya di direktori tertentu, ia akan mengekstrak fitur dari foto, yang memerlukan waktu. Berapa lama waktu yang dibutuhkan tergantung pada CPU Anda dan jumlah gambar yang akan Anda cari. Butuh waktu sekitar satu hari untuk memproses 73 ribu foto di NAS saya, yang menjalankan Intel Celeron J3455 versi lama, 7 menit untuk mengindeks 50 ribu gambar di MacBook saya dengan CPU M1 Max, dan tiga jam untuk memproses 1,28 juta gambar di MacBook yang sama.

Untuk demonstrasi detailnya, tonton videonya: https://www.youtube.com/watch?v=tAJHXOkHidw.

Pencarian gambar serupa

Anda dapat menggunakan gambar lain sebagai kueri dengan meneruskan jalur file atau bahkan URL ke file gambar tersebut, dan rclip akan menemukan gambar yang paling mirip dengan yang Anda gunakan sebagai kueri. Jika Anda mereferensikan gambar lokal melalui jalur relatif, Anda harus mengawalinya dengan ./ . Misalnya:

 cd photos && rclip ./cat.jpg

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

Lihat video ini untuk demo penelusuran gambar-ke-gambar: https://www.youtube.com/watch?v=1YQZKeCBxWM.

Menggabungkan beberapa kueri

Anda dapat menambah dan mengurangi kueri gambar dan teks satu sama lain; berikut adalah beberapa contoh penggunaan:

 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 "

Jika Anda ingin melihat bagaimana kinerja kueri ini ketika dijalankan pada 1,28 juta gambar kumpulan data ImageNet-1k, lihat demonya di YouTube: https://www.youtube.com/watch?v=MsTgYdOpgcQ.

Bagaimana cara melihat pratinjau hasilnya?

Jika Anda menggunakan salah satu dari iTerm2, Konsole (versi 22.04 dan lebih tinggi), wezterm, Mintty, atau mlterm, yang perlu Anda lakukan hanyalah meneruskan argumen --preview (atau -p ) ke rclip :

rclip -p kitty

Menggunakan terminal atau penampil yang berbeda

Jika Anda menggunakan terminal lain atau ingin melihat hasilnya di penampil pilihan Anda, Anda dapat meneruskan keluaran rclip ke terminal tersebut. Misalnya, di Linux, perintah di bawah ini akan membuka 5 hasil teratas untuk "kitty" di penampil gambar default Anda:

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

Param -f atau --filepath-only membuat rclip mencetak jalur file saja, tanpa skor atau header, sehingga ideal untuk digunakan bersama dengan penampil khusus seperti pada contoh.

Saya lebih suka menggunakan mode thumbnail feh untuk melihat beberapa hasil:

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

Dapatkan bantuan

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

Berkontribusi

Repositori ini mengikuti standar Komitmen Konvensional.

Berjalan secara lokal dari kode sumber

Untuk menjalankan rclip secara lokal dari kode sumber, Anda harus menginstal Python dan Puisi.

Kemudian lakukan:

 # 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

Jika lingkungan puisi aktif, Anda dapat menggunakan rclip secara lokal, seperti yang dijelaskan pada bagian Penggunaan di atas.

Kontributor

Terima kasih kepada orang-orang dan organisasi yang luar biasa ini (kunci emoji):

ramayer

Kaphyon ?

AbId KhAn

Terima kasih kepada Caphyon dan tim Penginstal Lanjutan yang telah bermurah hati menyediakan proyek rclip dengan lisensi Penginstal Lanjutan Profesional untuk membuat penginstal Windows.

Proyek ini mengikuti spesifikasi semua kontributor. Kontribusi apa pun dipersilakan!

Lisensi

MIT