UmiAI ComfyUI Wildcards Node
세부 정보
파일 다운로드
모델 설명
UmiAI Github
📘 UmiAI 와일드카드 프로세서
ComfyUI 프롬프트를 위한 "로직 엔진"
UmiAI는 정적인 프롬프트를 동적이고 컨텍스트 인식 가능한 워크플로우로 변환합니다. 이는 지속적인 변수, 조건적 로직, 네이티브 LoRA 로딩, 외부 데이터 가져오기 기능을 직접 프롬프트 텍스트 상자에 도입합니다.
## ✨ 주요 기능
* 🔋 네이티브 LoRA 로딩: 텍스트 안에 <lora:filename:1.0>을 직접 입력하세요. 노드가 내부적으로 모델을 패치하므로 외부 LoRA 로더 노드가 필요 없습니다.
* 🛠️ Z-Image 지원: Z-Image 형식 LoRA(QKV Fusion)를 자동으로 감지하고 실시간으로 수정합니다.
* 🧠 지속적인 변수: 한 번 정의하면 $hair={Red|Blue}) 어디서든 재사용할 수 있습니다 ($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
## 🔌 연결 가이드 ("Passthrough" 방식)
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. Convert width to input 및 Convert height to input를 선택하세요.
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.
```