UmiAI ComfyUI Wildcards Node
詳細
ファイルをダウンロード
モデル説明
📘 UmiAI ワイルドカードプロセッサー
ComfyUI プロンプト用の「ロジックエンジン」。
UmiAIは静的なプロンプトを、コンテキストに応じた動的なワークフローに変換します。永続変数、条件ロジック、ネイティブLoRA読み込み、外部データ取得を直接プロンプト入力ボックスに導入します。
## ✨ 主な機能
* 🔋 ネイティブLoRA読み込み： テキスト内に <lora:filename:1.0> と直接入力してください。ノードが内部でモデルをパッチ処理し、外部のLoRAローダーノードは不要です。
* 🛠️ Z-Image サポート： Z-Image形式のLoRA（QKV Fusion）を自動検出・修正します。
* 🧠 永続変数： $hair={Red|Blue} のように1度定義すれば、どこでも $hair として再利用でき、一貫性を保ちます。
* 🔀 条件ロジック： [if keyword : True Text | False Text] の論理ゲート。衣装とジャンルの一致を確実にします。
* 🌍 グローバルプリセット： wildcards/globals.yaml から定義された変数をすべてのプロンプトに自動読み込みます。
* 🎨 Danbooru 統合： char:name と入力すると、Danbooruから視覚タグを自動取得します。
* 📏 解像度制御： プロンプト内に @@width=1024@@ と記述することで、画像サイズを文脈に応じて制御できます。
---
2. ⚠️ 重要： フォルダ名を ComfyUI-UmiAI に変更してください（すでにそうではない場合）。
3. 依存関係をインストール：
pip install -r requirements.txt
## 🔌 接続ガイド（「パストスルー」方式）
UmiAIノードは「中心ブレイン」として機能します。LoRAを自動適用するため、モデルとCLIPをこのノードを通す必要があります。
### 1. メインチェーン
1. Checkpoint Loader（モデル＆CLIP） ➔ UmiAIノード（入力）
2. UmiAIノード（モデル＆CLIP） ➔ KSampler または Positive Prompt
### 2. プロンプト接続
* Text Output ➔ CLIP Text Encode（Positive）
* Negative Output ➔ CLIP Text Encode（Negative）
### 3. 解像度接続（重要！）
ノードが画像サイズを制御できるようにするには（例：@@width=1024@@）：
1. Empty Latent Image ノードを右クリックします。
2. 「Widthを入力に変換」 と 「Heightを入力に変換」 を選択します。
3. UmiAIのWidth/Height出力をLatentノードに接続します。
> ⚠️ バッチサイズに関する注意：
> 変異体を生成するには、ComfyUIのExtra Optionsメニュー内の 「Queue Batch」 設定を使用してください。ウィジェットのバッチサイズは使用しないでください。
---
## ⚡ 構文クイックリファレンス
| 機能 | 構文 | 例 |
| :--- | :--- | :--- |
| LoRA読み込み | <lora:name:str> | <lora:pixel_art:0.8> |
| ランダム選択 | {a\|b\|c} | {Red\|Blue\|Green} |
| 変数定義 | $var={opts} | $hair={Red\|Blue} |
| 変数使用 | $var | A photo of $hair hair. |
| 論理ゲート | [if Key : A \| B] | [if Cyberpunk : Techwear \| Armor] |
| Danbooru | char:name | char:frieren |
| 順次選択 | {~a\|b\|c} | {~Front\|Side\|Back} |
| サイズ設定 | @@w=X, h=Y@@ | @@width=1024, height=1536@@ |
| コメント | // または # | // This is a comment |
---
## 🔋 LoRA と Z-Image システム
複数のLoRAローダーノードを連結する必要はなくなりました。UmiAIが内部で処理します。
### 基本的な使い方
<lora: と入力するとオートコンプリートメニューが表示されます。
### Z-Image 自動検出
Z-Image LoRA（QKVの不一致のため特別なローダーが必要な場合）を使用している場合、UmiAIが自動で処理します。
1. 標準構文でファイルを読み込み：<lora:z-image-anime:1.0>
2. ノードがキーの形式を検出し、QKV Fusionパッチを即座に適用します。
### 動的LoRA
ワイルドカードやロジックを使って、生成ごとにLoRAを切り替えることができます：
// ランダムにスタイルLoRAを選択
{ lora:anime\_style:1.0 | lora:realistic\_v2:0.8 }
---
## 📂 ワイルドカードの作成
UmiAIは wildcards/ フォルダ内のファイルを読み込みます。
### 1. 単純なテキストリスト（.txt）
wildcards/colors.txt を作成：
Red
Blue
Green
使用方法： __ と入力して __colors__ を選択。
### 2. 高度なタグリスト（.yaml）
wildcards/styles.yaml を作成（LoRAをここに隠せます！）：
Cyberpunk:
Tags: lora:neon\_city:0.8
Prompts: ["neon lights", "chrome", "high tech"]
使用方法： < と入力して <[Cyberpunk]> を選択。
---
## 🚀 例：「コンテキスト認識」キャラクター
ロジック、変数、内部LoRA読み込みをテストするため、以下のプロンプトをノードにコピーしてください。
```text
// 1. 変数とスタイルの定義
$genre={High Fantasy|Cyberpunk}
$view={~Portrait|Landscape}
// 2. 論理：ジャンル/ビューに応じてLoRAと解像度を設定
[if Cyberpunk: lora:cyberpunk\_v3:0.8][if Fantasy: lora:rpg\_tools:1.0]
[if Portrait: @@width=1024, height=1536@@][if Landscape: @@width=1536, height=1024@@]
// 3. メインプロンプト
(Masterpiece), A $view of a warrior, female.
// 4. コンテキスト論理（ジャンル変数に応じて衣装が変化）
She is wearing [if Fantasy: plate armor | [if Cyberpunk: tech jacket]].
The background is a $genre landscape.
```