Скачали готовый workflow с Civitai или OpenArt, перетащили в ComfyUI — и половина графа красная. Или граф открылся, но запуск падает на первом же загрузчике с «Value not in list». Это нормально: файл воркфлоу — только граф, то есть ноды, связи и настройки. Кастомных нод, моделей и версий, с которыми работал автор, в нём нет, и каждая из этих частей должна совпасть на вашей машине.
Ниже — чек-лист, как запустить воркфлоу ComfyUI из чужого шаблона. По нему мы сами разбираем воркфлоу, когда клиент присылает ссылку на Civitai, OpenArt или GitHub, и в том же порядке.
Где лежит воркфлоу: JSON, картинка или архив
Скачать workflow для ComfyUI можно в трёх видах:
- Файл
.json. Обычный формат сохранения: весь граф вместе с раскладкой. Перетащите его на холст или откройте через File → Open. - Архив zip. На Civitai воркфлоу — отдельный тип ресурса, и скачивается он обычно архивом: внутри один или несколько
.json, иногда заметки автора и примеры. - Картинка или видео с графом внутри. Встроенные ноды сохранения ComfyUI пишут воркфлоу в метаданные файла: текстовые блоки PNG, анимированный WebP, MP4 и WebM. Перетащите файл на холст — ComfyUI восстановит граф.
Здесь две ловушки. Первая: при пересжатии метаданные теряются — файл пересохранили в редакторе, отправили через мессенджер, сайт сконвертировал его при загрузке. Если ComfyUI открыл картинку просто как картинку, графа в ней уже нет: просите у автора .json или исходный файл.
Вторая: форматов JSON два. Обычный (UI) — тот, что открывают и правят. API-формат (File → Export Workflow (API)) хранит ноды по числовым ID и выбрасывает позиции, цвета и группы — он нужен для запуска из скриптов. В интерфейс он тоже загружается, но без раскладки, поэтому, если автор выложил оба, берите UI-версию.
До установки чего-либо прочитайте описание автора: хорошие авторы перечисляют модели, версии LoRA и пакеты нод, иногда даже версию ComfyUI.
В ComfyUI нет нод: ComfyUI-Manager и его пределы
Красные ноды и сообщение «the following node types were not found» значат, что ComfyUI не знает этих классов нод. Причин две:
- Не хватает встроенной ноды. Воркфлоу собран на более новой версии ComfyUI. Обновите сам ComfyUI.
- Не хватает кастомной ноды. Нужен сторонний пакет нод, который у вас не установлен.
Второй случай закрывает ComfyUI-Manager. Теперь он встроен в ядро ComfyUI: в десктопном приложении включён сразу, а в портативной и ручной установке нужно поставить его зависимости и запускать ComfyUI с флагом --enable-manager. В старом интерфейсе Manager кнопка называется Install Missing Custom Nodes. В новом при открытии воркфлоу с недостающими нодами появляется окно с кнопками Install All и Open Manager, а в списке нод есть фильтр по недостающим.
После установки перезапустите сервер ComfyUI. Обновление вкладки браузера новый Python-код не подгружает.
Чего Manager не решает:
- Он находит только пакеты, которые знает. Если нода так и осталась ненайденной, ищите имя её класса на GitHub.
- Два пакета могут регистрировать ноды с одинаковым именем. Нужен тот, которым пользовался автор.
- Пакет может стоять и всё равно не загружаться. Строка
(IMPORT FAILED)рядом с папкой пакета в логе запуска значит, что его импорт упал, а трейсбек выше объясняет причину.
Версии, зависимости Python и закреплённые коммиты
У каждого пакета нод свой requirements.txt, и pip ставит его в то же окружение Python, где живёт ComfyUI. Один пакет может поднять или откатить библиотеку, на которую рассчитывают другие: частые виновники — numpy, transformers, opencv. Пакетам с компилируемым кодом ещё нужны сборки под ваши версии PyTorch и CUDA.
Вторая ловушка — время. Воркфлоу сохранён на той версии пакета, что была у автора в ту неделю; в сегодняшней могли переименовать вход или добавить виджет. Значения виджетов хранятся по порядку, поэтому один новый виджет сдвигает остальные значения в чужие поля. Граф открывается, но проверка падает или результат тихо меняется.
Поэтому мы закрепляем версии. Для пакета из git:
cd ComfyUI/custom_nodes
git clone https://github.com/<author>/<repo>.git
cd <repo>
git checkout <commit> # коммит, на котором собран воркфлоу
pip install -r requirements.txt # в окружении Python, где стоит ComfyUIЕсли работаете через Manager, перед экспериментами нажмите Save snapshot (Update All сохраняет снимок сам). Restore возвращает это состояние при следующем запуске ComfyUI; для пакетов, поставленных не через git, восстановление неполное.
И помните: кастомная нода — обычный Python-код, который выполняется с правами ComfyUI. В 2024 году пакет ComfyUI_LLMVISION тянул вредоносные зависимости, которые воровали пароли из браузера. Ставьте пакеты из репозиториев, код которых можно посмотреть.
Нет моделей: какая папка, какой файл, какая версия
Нода-загрузчик хранит имя файла, обычно без ссылки и без хеша. ComfyUI ищет это имя в папке своего типа:
Папка в ComfyUI/models/ | Что в ней лежит | Типичная нода-загрузчик |
|---|---|---|
checkpoints | Полные чекпойнты: модель, текстовый энкодер и VAE в одном файле | Load Checkpoint |
diffusion_models (старое имя unet) | Только диффузионная модель, например веса Flux или WAN | Load Diffusion Model |
text_encoders (старое имя clip) | Текстовые энкодеры: CLIP, T5 и подобные | Load CLIP, Load CLIP (Dual) |
vae | VAE | Load VAE |
loras | LoRA | Load LoRA |
controlnet | ControlNet и T2I-адаптеры | Load ControlNet Model |
clip_vision | Энкодеры изображений | Load CLIP Vision |
upscale_models | Апскейлеры типа ESRGAN | Load Upscale Model |
embeddings | Эмбеддинги textual inversion | Указываются в промпте |
Кастомные загрузчики иногда читают свои папки — смотрите README пакета. Если модели лежат в другом месте, дополнительные каталоги подключаются через extra_model_paths.yaml. После добавления файлов нажмите r в интерфейсе, чтобы обновить списки, или перезапустите ComfyUI.
Как найти точный файл
Имя файла в ноде — главная зацепка, и оно не уникально. Одна модель часто существует в нескольких версиях и точностях (fp16, fp8, pruned) с почти одинаковыми именами. Как действуем мы:
- Начинаем с описания автора и списка ресурсов на странице воркфлоу.
- На странице модели выбираем точную версию. На Civitai ID выбранной версии виден в адресе страницы (
?modelVersionId=). - Сверяем хеши. Civitai и Hugging Face показывают SHA256 файла; свою копию проверяем командой
sha256sum model.safetensors(Linux). - Есть файл, но непонятно, что это? Civitai находит модель по хешу:
https://civitai.com/api/v1/model-versions/by-hash/<sha256>вернёт модель и версию, если файл есть на Civitai.
Следите за подпапками. Если у автора модель лежала в models/loras/flux/, нода хранит flux/name.safetensors, и тот же файл в корне loras не совпадёт. Воркфлоу, сохранённые на Windows, хранят такие пути с обратным слешем. Оба случая лечатся повторным выбором файла в выпадающем списке ноды.
Проверьте и базовую модель. LoRA, обученная под одну базу, на другой нормально не работает; при несовпадении ключей ComfyUI пишет в лог строки lora key not loaded. И берите .safetensors: старые .ckpt и .pt используют pickle, а он может выполнить код при загрузке файла.
Закрытые модели: API-ключ Civitai и токен Hugging Face
Скачать модель в браузере просто. Скачать её сразу на GPU-сервер, где работает ComfyUI, без токена часто не получится.
Civitai. Многие файлы скачиваются анонимно, но часть доступна только вошедшим пользователям. Для скриптов создайте API-ключ в настройках аккаунта Civitai и передавайте его в заголовке Authorization: Bearer. Параметр ?token= в адресе тоже работает, но документация Civitai его не советует: ключ оседает в логах.
curl -L -H "Authorization: Bearer $CIVITAI_TOKEN" \
-o ComfyUI/models/loras/<file>.safetensors \
"https://civitai.com/api/download/models/<versionId>"Hugging Face. Закрытые (gated) репозитории, например FLUX.1 [dev], просят принять условия автора на странице модели под своим аккаунтом. Доступ выдаётся автоматически или после проверки автором, и автор может его отозвать. Дальше качаете с токеном доступа из настроек Hugging Face — через hf auth login на машине или тем же заголовком Bearer:
curl -L -H "Authorization: Bearer $HF_TOKEN" \
-o ComfyUI/models/diffusion_models/<file>.safetensors \
"https://huggingface.co/<org>/<repo>/resolve/main/<file>"Не оставляйте токены в файлах воркфлоу, общих блокнотах и на скриншотах.
Если Civitai не работает
Сайт не открывается или файл не скачивается — варианты такие:
- Проверьте, не требует ли файл входа: без ключа такие загрузки не идут. С ключом файл скачивается по прямой ссылке сразу на сервер, браузер для этого не нужен.
- Поищите модель на Hugging Face: часть авторов выкладывает её и туда. Что это тот же файл, проверяйте по SHA256.
- Отдайте воркфлоу нам: модели мы скачиваем на своей стороне.
Воркфлоу не загружается или падает: типовые ошибки
Большинство сбоев сводится к нескольким сообщениям. Смотрите не только всплывающее окно в браузере, но и консоль ComfyUI: полный трейсбек — там.
| Сообщение | Обычная причина | Что делать |
|---|---|---|
| Красные ноды, «the following node types were not found» | Пакет не установлен или сервер не перезапущен | Поставить пакет, перезапустить сервер |
(IMPORT FAILED) в логе запуска | Зависимости пакета не встали или конфликтуют | Прочитать трейсбек, поправить версию библиотеки, закрепить пакет |
| «Prompt outputs failed validation», «Value not in list» | Файла модели нет, он назван иначе или лежит в другой подпапке | Положить файл в нужную папку, обновить списки, заново выбрать его в ноде |
| «Required input is missing» | Вход не подключён — часто после обновления пакета, добавившего новый вход | Подключить или закрепить версию пакета, как у автора |
Could not detect model type | Не тот загрузчик (отдельная диффузионная модель в Load Checkpoint) или битая загрузка | Взять правильный загрузчик, сверить хеш |
mat1 and mat2 shapes cannot be multiplied | Обычно текстовый энкодер, VAE или CLIP Vision не от этой модели | Взять точные файлы из списка автора |
lora key not loaded в логе | LoRA под другую базовую модель | Найти версию LoRA под вашу базу |
| Нехватка памяти: «you ran out of memory on your GPU» | Разрешение, батч, число кадров или точность не влезают в VRAM | Снизить их; взять fp8- или GGUF-версии (для GGUF нужен свой пакет загрузчиков), VAE Decode (Tiled) или видеокарту с большей памятью |
| Свежий воркфлоу открывается сломанным | Старый ComfyUI или фронтенд (подграфам нужен фронтенд 1.24.3+) | Обновить ComfyUI |
Можно ли использовать результат в коммерции
Запустить воркфлоу и иметь право продавать результат — разные вопросы. У воркфлоу, чекпойнта и каждой LoRA может быть своя лицензия, и некоторые запрещают коммерческое использование. Подробно — в отдельном гайде: можно ли использовать модели с Civitai в коммерции.
Как запускаем чужие воркфлоу мы
Клиент присылает ссылку на Civitai, OpenArt или GitHub либо свой .json, плюс задачу, входные данные и объём. Дальше всё, что описано выше, команда делает вручную:
- разбираем граф и выписываем все ноды и модели; незнакомые ноды и модели без версии сначала проверяем руками, потом запускаем;
- ставим кастомные ноды из git на закреплённых коммитах, чтобы окружение не поплыло посреди заказа;
- берём модели с Hugging Face, Civitai или по прямой ссылке от вас;
- до старта говорим, если модель платная, закрытая или её лицензия запрещает коммерческое использование;
- делаем пробную партию на согласование, потом гоним объём на своих или арендованных GPU, вручную отсматриваем результат и убираем брак;
- сдаём ZIP-архивом или ссылкой на папку.
Масштабирование рабочего воркфлоу до тысяч прогонов — отдельная тема: как масштабировать воркфлоу ComfyUI.
Когда проще отдать нам
Для пары картинок хватит чек-листа выше. Если нужны сотни или тысячи картинок или видео по одному шаблону, если не хватает видеопамяти или нет желания днями воевать с зависимостями — пришлите воркфлоу нам. Настройка и пробная партия входят в заказ. Картинки — от $0.10 за штуку, видео — от $1.50 за ролик, минимальный заказ $50. Подробности — на странице услуги по воркфлоу ComfyUI, или сразу оставьте заявку со ссылкой на воркфлоу.
