VisioNomicon

Sigunomicon

Visionomicon是一種功能強大的基於Python的命令行實用工具，旨在使用GPT-4O的功能重命名圖像文件。描述性文件名是根據用戶給定模板和圖像內容生成的。

特徵

• 基於GPT-4V生成的文件名重命名圖像文件
• 基於用戶給定的結構的靈活名稱生成
• 能夠為重命名的圖像創建映射文件
• 根據生成的映射文件執行重命名
• 撤消重命名以恢復原始文件名
• 使用GPT-4O生成名稱的驗證步驟
• 在驗證或錯誤時支持多次重試嘗試
• 受支持的文件類型： .png ， .jpeg ， .jpg ， .webp ， .gif （未動畫）

先決條件

• Python 3.6+
• 訪問具有GPT-4O功能的OpenAI API（需要API密鑰）

安裝

您可以通過PIP通過以下命令安裝軟件包：

pip install VisioNomicon

另外，您可以通過下載源分佈並運行以下命令來手動安裝軟件包：

1. 從“版本”頁面下載最新的源分發。
2. 提取文件並導航到提取的目錄。
3. 運行以下命令以安裝：

pip install . 

用法

要使用Visionomicon，您需要將OPENAI_API_KEY環境變量設置為OpenAI API鍵。通常可以使用以下命令來完成：

 export OPENAI_API_KEY= ' your_api_key_here '

用所需的標誌和參數運行腳本：

VisioNomicon [OPTIONS]

或一個單個命令：

OPENAI_API_KEY= ' your_api_key_here ' VisioNomicon [OPTIONS] 

選項

• -f ， --files ：指定圖像的文件路徑以創建映射
• -o ， --output ：指定使用原始文件和新文件路徑創建的JSON映射文件。默認為$XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json
• -x ， --execute ：根據現有映射文件執行重命名。在沒有值的情況下調用此數字使用$XDG_DATA_HOME/visionomicon中的最新創建的映射
• -ox ， --mapex ：一個步驟中的地圖和執行重命名
• -u ， --undo ：使用映射文件將重命名為原始文件名。在沒有值的情況下調用此數字使用$XDG_DATA_HOME/visionomicon中的最新創建的映射
  • 重要的是要注意，如果執行映射後，文件名或位置更改，您將無法撤消
• -t ， --template ：定義用於重命名圖像文件的模板，而無需文件擴展名。建議使用方括號來定義文件名的元素。默認為[SubjectDescription]_[MainColor/ColorScheme]_[StyleOrFeel]_[CompositionElement]
• -e ， --validation-retries ：指定名稱驗證的重試數（默認為3）
• -v ， --error-retries ：在發生OpenAI錯誤時指定重試的數量（默認為3）
• -E ， --ignore-validation-fail ：如果達到驗證重試限制，請映射到原始名稱而不是返回錯誤
• -V ， --ignore-error-fail ：如果達到了錯誤重試限制，請映射到原始名稱而不是返回錯誤
• -b ， --create-batch ：通過OpenAI API創建批處理作業。
• -B ， --retrieve-batch ：通過OpenAI API檢索批處理作業輸出。創建批處理作業後24小時運行此操作。

示例命令

VisioNomicon -f image1.jpg image2.png -ox

這是最直接的用法。為圖像創建映射文件，放置在默認位置（ $XDG_DATA_HOME/visionomicon/mapping-%Y-%m-%d-%H-%M-%S.json ）。此後，立即執行此文件，重命名文件。

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

此命令將根據提供的模板為image1.jpg和image2.png創建重命名映射文件，並將映射輸出到mapping.json 。

隨後，您可以執行映射，重命名文件。

VisioNomicon -x mapping.json

如果您願意，使用-ox ：

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

限制

• GPT-4O在可以處理的文件類型中受到限制（.png，.jpeg，.jpg，.webp，non-Animated .gif）和大小（最高20MB）
• 有了一些模板，它可能很挑剔，並不是真正產生您可能期望的文件名

貢獻

歡迎捐款。請先開開一個問題，以討論您想更改或添加的內容。

執照

該項目是根據GLP-3.0許可證開源的。

免責聲明

該工具與OpenAI不關聯。該功能可能會根據對API的更新或OpenAI提供的服務條款進行更改。