VisioNomicon

Visionomicon

Visionomicon adalah alat utilitas baris perintah berbasis python yang kuat yang dirancang untuk mengganti nama file gambar menggunakan kemampuan GPT-4O. Nama file deskriptif dihasilkan berdasarkan templat yang diberikan pengguna dan konten gambar.

Fitur

• Ubah nama file gambar berdasarkan nama file yang dihasilkan dari GPT-4V
• Pembuatan nama fleksibel berdasarkan struktur yang diberikan pengguna
• Kemampuan membuat file pemetaan untuk ganti nama gambar
• Jalankan penggantian nama berdasarkan file pemetaan yang dihasilkan
• Batalkan penggantian nama untuk kembali ke nama file asli
• Langkah verifikasi untuk nama yang dihasilkan menggunakan GPT-4O
• Dukungan untuk beberapa upaya coba lagi jika terjadi validasi atau kesalahan
• Jenis file yang didukung: .png , .jpeg , .jpg , .webp , .gif (non-animasi)

Prasyarat

• Python 3.6+
• Akses ke OpenAI API dengan kemampuan GPT-4O (diperlukan kunci API)

Instalasi

Anda dapat menginstal paket menggunakan PIP melalui perintah berikut:

pip install VisioNomicon

Atau, Anda dapat menginstal paket secara manual dengan mengunduh distribusi sumber dan menjalankan perintah berikut:

1. Unduh distribusi sumber terbaru dari halaman rilis.
2. Ekstrak file dan navigasikan ke direktori yang diekstraksi.
3. Jalankan perintah berikut untuk menginstal:

pip install . 

Penggunaan

Untuk menggunakan Visionomicon, Anda perlu mengatur variabel lingkungan OPENAI_API_KEY ke kunci API openai Anda. Ini umumnya dapat dilakukan dengan perintah seperti berikut:

 export OPENAI_API_KEY= ' your_api_key_here '

Jalankan skrip dengan bendera dan argumen yang diinginkan:

VisioNomicon [OPTIONS]

Atau dalam satu perintah tunggal:

OPENAI_API_KEY= ' your_api_key_here ' VisioNomicon [OPTIONS] 

Opsi

• -f , --files : tentukan jalur file gambar untuk membuat pemetaan
• -o , --output : Tentukan file pemetaan JSON yang akan dibuat dengan jalur file asli dan baru. Default ke $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json
• -x , --execute : Execute Renaming berdasarkan file pemetaan yang ada. Memanggil ini tanpa nilai menggunakan pemetaan yang paling baru dibuat dalam $XDG_DATA_HOME/visionomicon
• -ox , --mapex : peta dan eksekusi penggantian nama dalam satu langkah
• -u , --undo : Kembalikan nama ke nama file asli menggunakan file pemetaan. Memanggil ini tanpa nilai menggunakan pemetaan yang paling baru dibuat dalam $XDG_DATA_HOME/visionomicon
  • Penting untuk dicatat, jika nama file atau lokasi berubah setelah menjalankan pemetaan, Anda tidak akan dapat membatalkan
• -t , --template : Tentukan templat untuk mengganti nama file gambar, tanpa ekstensi file. Disarankan untuk menggunakan tanda kurung persegi untuk menentukan elemen nama file. Default ke [SubjectDescription]_[MainColor/ColorScheme]_[StyleOrFeel]_[CompositionElement]
• -e , --validation-retries : Tentukan jumlah retries untuk validasi nama (default ke 3)
• -v , --error-retries : Tentukan jumlah retries jika terjadi kesalahan openai (default ke 3)
• -E , --ignore-validation-fail : Jika batas validasi retries tercapai, peta file ke nama asli alih-alih mengembalikan kesalahan
• -V , --ignore-error-fail : Jika kesalahan retries dicapai, peta file ke nama asli alih-alih mengembalikan kesalahan
• -b , --create-batch : Buat pekerjaan batch melalui OpenAI API.
• -B , --retrieve-batch : Ambil output pekerjaan batch melalui OpenAI API. Jalankan ini 24 jam setelah membuat pekerjaan batch.

Contoh Perintah

VisioNomicon -f image1.jpg image2.png -ox

Ini adalah penggunaan yang paling mudah. File pemetaan dibuat untuk gambar, ditempatkan di lokasi default ( $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json ). Segera setelah itu, file ini dieksekusi, mengganti nama file.

VisioNomicon -f image1.jpg image2.png -o mapping.json -t " [Object]_[Color]_[Style] "

Perintah ini akan membuat file pemetaan ganti nama untuk image1.jpg dan image2.png berdasarkan templat yang disediakan dan output pemetaan ke mapping.json .

Selanjutnya, Anda dapat menjalankan pemetaan, mengganti nama file.

VisioNomicon -x mapping.json

Ini juga dapat dilakukan dalam satu perintah tunggal jika Anda mau, menggunakan -ox :

VisioNomicon -f image1.jpg image2.png -ox mapping.json -t " [Object]_[Color]_[Style] " 

Batasan

• GPT-4O terbatas pada jenis file yang dapat ditangani (.png, .jpeg, .jpg, .webp, .gif yang tidak dianimasikan), dan ukurannya (hingga 20MB)
• Dengan beberapa templat itu bisa sangat rewel, tidak benar -benar menghasilkan nama file yang mungkin Anda harapkan

Berkontribusi

Kontribusi dipersilakan. Harap buka masalah terlebih dahulu untuk membahas apa yang ingin Anda ubah atau tambahkan.

Lisensi

Proyek ini bersumber terbuka di bawah lisensi GLP-3.0.

Penafian

Alat ini tidak berafiliasi dengan openai. Fungsionalitas dapat berubah berdasarkan pembaruan API atau ketentuan layanan yang disediakan oleh OpenAI.