ComfyUI カスタムノード: プロンプトリスト JSON

このリポジトリは、ComfyUI 用のカスタムノードを提供し、ポジティブおよびネガティブなプロンプトを構造化された JSON 形式で管理できるようにします。このノードは、新しいプロンプトリストの作成、ランダムなプロンプト選択、コンソールへのプロンプト詳細のログ出力に対応し、ワークフローへスムーズに統合できます。

機能

- 📂 JSONベースのプロンプト管理: プロンプトは個別の JSON ファイルに保存され、編集および取得が容易です。

- 🔄 プロンプトの追加または更新: 新しいプロンプトリストの作成、既存プロンプトの更新、必要に応じて上書きが可能です。

- 🎲 ランダムなプロンプト選択: 既存のリストから簡単にランダムにプロンプトを選択できます。

- 🖥️ コンソールログ出力: デバッグまたは検証のため、フォーマットされた出力でプロンプトの詳細をオプションでコンソールにログ出力します。

- 🛠️ 自動ファイル管理: 必要なディレクトリとファイルを自動的に作成します。

インストール

1. このリポジトリを ComfyUI のカスタムノードディレクトリにクローンまたはダウンロードしてください：

   git clone https://github.com/TKRLAB/ComfyUI_Prompt_List_JSON.git

2. ComfyUI を再起動してカスタムノードを読み込みます。

代替方法

1. ComfyUI マネージャーを使用してインストールしてください。

使用方法

ノード入力

- プロンプトリスト: 既存のプロンプトリストを選択するか、新しいリストを作成します。

- 新しいリスト名: 新しいリストの名前を指定します（新規作成時に使用）。

- プロンプト名（新規プロンプトで必須）: プロンプトの一意の名前。

- ポジティブプロンプト（新規プロンプトで必須）: プロンプトのポジティブな説明。

- ネガティブプロンプト（オプション）: プロンプトのネガティブな説明。

- ランダム（ブール値、デフォルト False）: リストからランダムにプロンプトを選択するかどうか。

- 上書き（ブール値、デフォルト False）: 同じ名前の既存のプロンプトを上書きするかどうか。

- コンソールログ（ブール値、デフォルト False）: デバッグ用にプロンプトの詳細をコンソールに出力します。

ノード出力

- ポジティブプロンプト: 保存または取得されたポジティブプロンプト。

- ネガティブプロンプト: 保存または取得されたネガティブプロンプト。

- フルリスト: JSON文字列形式の全プロンプトリスト。

使用例ワークフロー

1. 次の入力でプロンプトを追加または更新します：

- プロンプトリスト: test.json

- 新しいリスト名: test

- プロンプト名: girl on helmet

- ポジティブプロンプト: concept art Girl in black thin, oily latex, black motorcycle helmet, black glass on helmet, pours a bucket of yellow paint on himself, paint dripping down his body, yellow silk long scarf, sexy, dynamics. Black mirrors in the background, reflections. digital artwork, illustrative, painterly, matte painting, highly detailed

- ネガティブプロンプト: photo, photorealistic, realism, ugly

- 上書き: True

- コンソールログ: True

- ランダム: True

2. プロンプトは指定された JSON ファイルに保存され、ログ出力が有効であればその詳細がコンソールに表示されます。

ファイル構造

プロンプトは以下の形式で個別の JSON ファイルに保存されます：

{
    "SunsetScene": {
        "positive": "A breathtaking sunset over the mountains",
        "negative": "Low quality, blurry"
    }
}

プログラムによるプロンプト追加

このノードをプログラムから使用することもできます。例：

from your_module import ComfyUI_Prompt_JSON
manager = ComfyUI_Prompt_JSON()
positive, negative, full_list = manager.process(
    **{
        "Prompt List": "New List",
        "New List Name": "NaturePrompts",
        "Prompt Name": "SunsetScene",
        "Positive Prompt": "A breathtaking sunset over the mountains",
        "Negative Prompt": "Low quality, blurry",
        "Random": False,
        "Overwrite": True,
        "Console Log": True
    }
)

エラーハンドリング

- 必須フィールド（例：Prompt Name や Positive Prompt）が欠けている場合、ValueError を発生させます。

- コンソールに詳細なエラーメッセージを表示してデバッグを支援します。

ライセンス

このプロジェクトは GNU General Public License v3.0 の下でライセンスされています。LICENSE をご確認ください。

ComfyUI で Prompt List JSON ノードをお楽しみください！ 🎨