VisioNomicon

VisionMicon

VisionMiconは、GPT-4oの機能を使用して画像ファイルの名前を変更するように設計された強力なPythonベースのコマンドラインユーティリティツールです。記述ファイル名は、指定されたテンプレートと画像の内容に基づいて生成されます。

特徴

• 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]

または1つのコマンドで：

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 ：1つのステップで変更をマップして実行する
• -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] "

このコマンドは、提供されたテンプレートに基づいてmapping.jsonにマッピングを出力し、 image1.jpgとimage2.pngの名前のマッピングファイルを作成します。

その後、マッピングを実行して、ファイルの名前を変更できます。

VisioNomicon -x mapping.json

これは、 -oxを使用して、1つのコマンドで実行することもできます。

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

制限

• GPT-4Oは、処理できるファイルタイプ（.png、.jpeg、.jpg、.webp、nonimated .gif）に制限され、サイズ（最大20MB）
• いくつかのテンプレートでは、非常に気味が悪く、実際に期待されるファイル名を生成することはありません

貢献

貢献は大歓迎です。最初に問題を開いて、何を変更したり追加したいかを話し合ってください。

ライセンス

このプロジェクトは、GLP-3.0ライセンスに基づいてオープンソースされています。

免責事項

このツールはOpenaiと提携していません。機能は、APIの更新またはOpenAIが提供するサービス条件に基づいて変更される場合があります。