ComfyUI-PromptRandomChoice

実行のたびに「プロンプトガチャ」を爆速で回す、超軽量なランダム選択ノードじゃ！

「背景や天気を適当に変えて、一晩中回しておきたいのう……」
そんなおぬしの願いを、実行時間 0.010s（注：作者環境で速いとき）という瞬速の魔法で叶えて進ぜよう！

背景・時間帯・天気などを別々にランダム化したい時に便利じゃ。
フロー内に複数個置いても、それぞれ独立して動くぞ。

v0.4.0

Prompt Random Choice Ex を追加したのじゃ。

• Prompt Random Choice
  • フラットな候補リストから1つ選ぶノード
• Prompt Random Choice Ex
  • フラット候補に加えて、{} による入れ子の候補展開に対応したノード
  • 先にすべての葉候補へ展開し、最後に1回だけランダム選択します
  • 展開済み候補リストは options_text が変わるまでキャッシュします

どちらもノードしての出力は同じじゃ。

• selected_text
• selected_text_safe

特徴

• 実行ごとにランダム選択

  • キューを雑に100件積んでも、毎回候補を選び直すぞ。

• 区切りは | または実際の改行

  • | と改行の両方を区切りとして扱うので、混在していても動くぞ。
  • 区切り文字が連続して出現した場合は、候補から取り除かれることに注意じゃ。
    • 明示的に空白文字列を候補として返却させたい場合は、明示的に () と指定するのじゃ。

• 候補の前後の , と空白を自動で整理

  • town,
  • coffee shop,
  • castle, fortress, のような書き方でも大丈夫じゃ。

• 現在の選択結果をタイトル表示

  • 実行時にノードタイトルが Choice: coffee shop のように更新されるぞ。
  • KSamplerのプレビューと見比べやすいのじゃ。

• 複数設置に対応

  • 背景用、時間帯用、天気用など、複数ノードを置いてそれぞれ別々に使えるぞ。

• ファイル名向けの返り値

  • ファイル名向けに安全化した文字列 selected_text_safe を出力するのじゃ。

• 明示的な空候補 () に対応

  • () が選ばれた場合、プロンプト向け出力は空文字に、ファイル名向け出力は empty になるのじゃ。

Prompt Random Choice Ex の追加要素

• フラット候補に加えて、{} による入れ子の候補展開に対応
  • しかも、ComfyUIの標準記法と異なり、{} 内を入れ子にできるのじゃ。
    • {} 内の要素は内側から解釈され、選択項目がカンマで前後に接続される。
  • | と改行の両方を区切りとして扱うので、混在していても動くぞ。
  • 区切り文字が連続して出現した場合は、候補から取り除かれることに注意じゃ。
    • 明示的に空白文字列を候補として返却させたい場合は、明示的に () と指定するのじゃ。

ここは実例を見てもらった方が話が早そうじゃ。

town|zoo{animals{birds|penguins}|aquarium,{fish|jellyfish}}

これは、内部的には次の候補へ展開され、キャッシュされるのじゃ。

town
zoo, animals, birds
zoo, animals, penguins
zoo, aquarium, fish
zoo, aquarium, jellyfish

この5候補から1つが選ばれるのじゃ。
入れ子になった各要素が、すべて等しい確率で出現するように工夫しておるのじゃ。

導入方法

ComfyUIの custom_nodes ディレクトリで、以下のコマンドを打ち込むのじゃ！

git clone https://github.com/ruminar/ComfyUI-PromptRandomChoice.git

使い方

1. Prompt Random Choice ノードを置く
2. options_text に候補を入れる (入力例を参照)
3. 必要に応じて change_every を選ぶ
4. selected_text を Join String Multi などの文字列結合ノードへ繋ぎ、ポジティブプロンプトへ足す
5. キューを好きなだけ積む

※ 設定後は折りたたんで使うのもおすすめなのじゃ。

入力例

改行区切り (改行前の,は任意です)

town,
girl's room,
park,
lake,
flower garden,
castle, fortress,
forest,
grasslands,
sea,
snowy landscape,
mountain,
flower field,
starry sky,
coffee shop,

| 区切り

town|
girl's room|
park|
lake|
flower garden|
castle, fortress|
forest|
grasslands|
sea|
snowy landscape|
mountain|
flower field|
starry sky|
coffee shop|

何も追加しない候補

() は明示的な空候補として扱われます。

()|(full body:0.9)

この例では、何も追加しない場合と、(full body:0.9) を追加する場合をランダムに切り替えられます。

選ばれやすさを調整したい場合

同じ候補を複数回書けば、そのぶん選ばれやすくなります。

day|day|day|sunset|night

昼を多めに出したい、たまに夕方や夜も混ぜたい、という時に便利じゃ。

仕様

• | または実際の改行で分割
• \n という文字列は区切りとして扱わない
• 各候補の前後の空白と , を trim
• 空候補は無視
• () は明示的な空候補として扱う
• change_every が 1 なら毎回選び直す
• change_every が 2 以上なら、その回数ぶん同じ候補を維持する
• 実行時にタイトルへ Choice: lake や Choice: (empty) (2/3) のように表示する

Prompt Random Choice

候補リストから1つ選びます。

town|park|lake|coffee shop

() は明示的な空候補です。

()|(full body:0.9)

Prompt Random Choice Ex

Prompt Random Choice と同じフラットな候補リストをそのまま使えます。

town|park|lake|coffee shop

さらに、候補の中に {} を書くことで、選ばれた候補にだけ追加候補をぶら下げられます。

town|zoo{animals{birds|penguins}|aquarium,{fish|jellyfish}}

この入力は、内部的には次の候補へ展開されます。

town
zoo, animals, birds
zoo, animals, penguins
zoo, aquarium, fish
zoo, aquarium, jellyfish

この5候補から1つが選ばれます。

複数行の Ex 例

zoo{
  animals{
    birds
    penguins
  }
  aquarium{
    fish
    jellyfish
  }
}

出力例:

zoo, animals, birds
zoo, animals, penguins
zoo, aquarium, fish
zoo, aquarium, jellyfish

Ex のルール

• 選択候補の区切り文字は、実際の改行 または |
• 空候補は無視
• () は明示的な空候補
• {} の内部も、実際の改行 または | で候補分割
• {} は最内側からすべての葉候補へ展開
• 展開結果は親要素へ , で接続
• 最終候補リストから最後に1回だけランダム選択
• 展開済み候補リストは options_text が変わるまでキャッシュ
• 展開候補数と展開回数には安全上限があります
• リテラルの { / } をプロンプト文字として使う用途は非対応

出力

• selected_text
  trim後の選択文字列です。
  () が選ばれた場合は空文字 "" になります。

• selected_text_safe
  ファイル名向けに安全化した出力です。
  selected_text が空なら empty を返します。

推奨構成

selected_text を kjnodes の Join String Multi などへ接続し、区切り文字は結合ノード側で管理するのがおすすめじゃ。

複数の Prompt Random Choice / Prompt Random Choice Ex を並べることで、背景・時間帯・天気・構図などを別々にランダム化するのじゃ。

ただし、Ex はすべての要素を1つにまとめるためのノードではなく、zoo の時だけ動物候補を追加するような、親子関係のある候補を扱うためのノードとして使うのがおすすめじゃ。

標準選択記法 {day|night|morning} との違いについて

• ComfyUI標準にも、プロンプト候補をランダムに切り替える構文として {a|b|c} 記法があります。
  この記法は、CLIP Text Encode でプロンプトが処理される段階で解決されます。

• 一方、PromptRandomChoice はその前段で候補を1つに確定し、選ばれた文字列だけを通常の STRING として出力します。
  そのため、選ばれなかった候補は下流へ流れません。

  • この性質により、選択候補の中にLoRAのトリガーワードをより安全に含めることもできます。
    選ばれた候補だけが後続ノードへ渡されるため、標準の {a|b|c} 記法よりも、候補の確定状態をワークフロー上で明示しやすくなります。
    • ※ ただし、LoRA自体のロードON/OFFを切り替えるものではありません。
      ここでいう安全性は、選ばれなかったトリガーワード文字列が下流へ流れない、という意味です。

• 区切り文字は、標準の {a|b|c} 記法と同じ | を使えます。
  そのため、標準記法から {} の中身を抜き出して PromptRandomChoice に持ってきたり、逆に PromptRandomChoice の中身を {} で括ってプロンプト文字列へ戻したりできます。
  出入り自由です。

• また、画像生成の比較では、1回ごとにプロンプト候補が変わると、差分を判断しづらい場合があります。
  PromptRandomChoice では change_every を使うことで、同じ候補を数回維持してから次の候補へ切り替えることができます。

• さらに、PromptRandomChoice の段階で確定した候補はノードタイトルに表示されます。

  • KSamplerのプレビューと見比べながら、現在どの候補が使われているかを確認できます。
  • change_every 指定時には、Choice: lake (2/3) のように進捗も表示されます。

ライセンス

GPL-3.0（ComfyUI本体の掟に従っておるぞ！）

宣伝画像

EX版

コピペ用おすすめ候補リスト

背景

Indoor,
girl's room,
coffee shop,
library,
classroom,
office,
laboratory,
art gallery,
museum,
bookstore,
bakery,
restaurant,
concert hall,
theater,
school hallway,
greenhouse,
observatory,
Outdoor,
City,
town,
park,
rooftop,
train station,
shopping street,
courtyard,
bridge,
riverside,
harbor,
marketplace,
alley,
village,
Nature,
lake,
flower garden,
forest,
grasslands,
sea,
mountain,
flower field,
beach,
island,
cave,
botanical garden,
Traditional,
Fantasy-ish,
Japanese garden,
shrine,
temple,
castle,
fortress,
palace,
ruins,

背景 Ex 版

indoor{
  girl's room
  coffee shop
  library
  classroom
  office
  laboratory
  art gallery
  museum
  bookstore
  bakery
  restaurant
  concert hall
  theater
  school hallway
  greenhouse
  observatory
}
city{
  town
  park
  rooftop
  train station
  shopping street
  courtyard
  bridge
  riverside
  harbor
  marketplace
  alley
  village
}
nature{
  lake
  flower garden
  forest
  grasslands
  sea
  mountain
  flower field
  beach
  island
  cave
  botanical garden
}
traditional{
  japanese garden
  shrine
  temple
}
fantasy-ish{
  castle
  fortress
  palace
  ruins
}

時刻

day|day|day|morning|sunset|night

天候

()|(clear sky:0.9)|(clear sky:0.9)|(clear sky:0.9)|(cloudy sky:0.9)|rain|snow

光

()|soft lighting|warm lighting|natural lighting|(backlighting:0.8)|(dramatic lighting:0.8)|(cinematic lighting:0.8)

姿勢、視線、動作

()|standing|sitting|walking|looking at viewer|waving|hands on hips|jumping|running|skipping|looking up

表情

()|smiling|gentle smile|serious expression|surprised expression|slightly surprised|shy expression|happy expression|smiling, open mouth|slightly open mouth|closed-mouth smile

構図

()|(face close-up:0.9)|upper body|upper body|full body|full body|full body|full body|full body|wide shot|(from side:0.8)|(from above:0.8)|(low angle:0.8)|(from behind, looking back:0.8)