OmniChar ComfyUI 노드: H3, FLUX.2, Krea 2에서 하나의 .char 파일 사용하기
OmniChar가 휴대용 .char 파일을 로드해 MiniMax H3, FLUX.2, Krea 2 워크플로에서 하나의 캐릭터 정체성을 재사용하는 공식 ComfyUI 노드 팩을 공개했습니다.
.char 파일을 읽어, 일반 그래프 안에서 해당 정체성을 이미지 및 비디오 모델에 전달합니다. 이 팩은 MiniMax H3, Krea 2, FLUX.2 dev, FLUX.2 Klein 9B / 4B 지원을 명시하고 있습니다.
캔버스 위의 OmniChar 노드: Load Character, Decode Character, 그리고 해석된 캐릭터를 샘플러에 전달하는 참조 노드들.
.char 파일이 담고 있는 것
.char는 이미지가 아니라 캐릭터를 설명합니다. 참조 사진, 이에 고정된 설명, 그리고 보통 학습된 LoRA를 보관하므로, 참조를 받는 모든 모델에서 동일한 인물을 재현할 수 있습니다. 캐릭터는 ComfyUI/models/characters/에 저장되며, 로더는 해당 폴더에 있는 항목을 그대로 나열합니다.
참조는 역할별로 그룹화됩니다. Encode Character는 얼굴, 신체, 의상 샷을 각각 세 개의 슬롯으로 분류하므로, 얼굴이 항상 첫 번째 참조가 되고 프롬프트 번호도 그 순서를 따릅니다. Decode Character는 파일을 프롬프트와 해석된 참조 목록으로 되돌리며, 이것이 샘플러가 실제로 보는 값입니다.
노드
| 노드 | 입력 | 출력 |
|---|---|---|
| Load Character | char, char_path | char |
| Decode Character | char, style, clip, prompt, arch, max_references, size_from, fit | conditioning, references, refs, sheet, prompt |
| Character Reference | refs, index | image, role, count |
| Character References Split | refs | image_0 ~ image_4, count |
| Character Reference Latent | conditioning, refs, vae | conditioning |
| Apply Character LoRA | model, clip, char, strength, arch, min_key_coverage | model, clip |
| Encode Character | name, description, resolution, face/body/cloths (각각 세 개의 슬롯) | char |
| Save Character | char, filename, overwrite | path |
참조를 전달하는 방식은 모델에 따라 다릅니다. 단일 배치를 받는 모델은 references를 읽습니다. MiniMax H3를 비롯해 번호가 매겨진 참조 슬롯을 가진 모델은 Character References Split 노드를 통해 또는 슬롯마다 하나의 Character Reference 노드를 사용해 refs를 분할합니다. FLUX.2처럼 참조를 잠재 데이터로 읽는 편집 모델은 refs를 포지티브와 네거티브 조건화 양쪽에 연결된 Character Reference Latent 노드로 전달합니다.
팩에 포함된 워크플로
저장소에는 세 가지 예제 그래프가 포함되어 있습니다. 얼굴, 신체, 의상 참조로 .char를 만드는 그래프, FLUX.2 Klein 9B로 이미지를 생성하는 그래프, MiniMax H3로 비디오를 생성하는 그래프입니다.
MiniMax H3 참조 정체성 예제: 왼쪽에는 분리된 참조 슬롯, 오른쪽에는 생성된 샷.
설치
이 팩은 ComfyUI와 Python 3.10 이상이 필요하며, 리더를 requirements.txt에서 가져옵니다.
cd ComfyUI/custom_nodes
git clone https://github.com/omnichar/ComfyUI-Omnichar
cd ComfyUI-Omnichar
pip install -r requirements.txt이후 ComfyUI를 재시작한 다음, 노드 메뉴에서 Character를 검색하세요. INLINE_CHARACTERS_DIR을 OmniChar Studio의 캐릭터 폴더로 지정하면 스튜디오와 노드가 동일한 .char 파일을 읽습니다.
사용 가능 여부
노드 팩: omnichar/ComfyUI-Omnichar
스튜디오 앱: omnichar/OmniChar
웹사이트: omnichar.org
Python SDK: pip install omnichar-sdk
베이스 모델: Comfy-Org/MiniMax-H3, black-forest-labs/FLUX.2-klein-9b
댓글
GitHub로 로그인하고 토론에 참여하세요.