Узлы OmniChar для ComfyUI: один .char для H3, FLUX.2 и Krea 2
OmniChar выпускает официальный пакет узлов для ComfyUI, который загружает переносимый файл .char и переиспользует персонажа в MiniMax H3, FLUX.2 и Krea 2.
.char, в котором хранятся референсные изображения персонажа, зафиксированное описание и, если он есть, обученный LoRA, а затем передаёт эту идентичность в модели изображений и видео прямо внутри обычного графа. В пакете заявлена поддержка 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, разбивают refs через узел Character References Split или через отдельный узел Character Reference на каждый слот. Модели редактирования, которые читают референсы как латенты, например 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
Приложение Studio: omnichar/OmniChar
Сайт: omnichar.org
Python SDK: pip install omnichar-sdk
Базовые модели: Comfy-Org/MiniMax-H3, black-forest-labs/FLUX.2-klein-9b
Комментарии
Войдите через GitHub, чтобы участвовать в обсуждении.