Модели и custom nodes в ComfyUI: папки и совместимость

Workflow содержит инструкции, а не все зависимости. Импорт JSON не устанавливает веса и custom nodes, на которые ссылается граф. Сначала определите, чего именно не хватает, затем скачивайте нужное.

Веса модели и код узла — разные вещи

Модель — файл весов, который читает loader. Custom node — исполняемый код: он добавляет загрузчики, препроцессоры и другие операции. Ошибка «model not in list» обычно означает отсутствие файла, другое имя или неправильную папку. Красный неизвестный узел чаще связан с отсутствующим расширением или встроенным узлом из более новой версии ComfyUI.

Наши шесть стартовых workflow используют встроенные узлы. Сначала запустите базовый граф, затем добавляйте расширения. Большой набор custom nodes не является условием для SDXL text-to-image, маски или нашего Canny-примера.

Используйте каталог работающей установки

В готовых пресетах это по умолчанию /workspace/ComfyUI. При ручной установке путь может отличаться. Перед копированием найдите команду запуска или рабочий каталог процесса. У двух установок будут разные списки моделей, если общие пути не настроены явно.

Назначение файла Папка внутри ComfyUI Что проверить
Чекпойнт «всё в одном» models/checkpoints/ Есть компоненты, которые ожидает checkpoint loader
Отдельные диффузионные веса models/diffusion_models/ Нужны соответствующий loader, отдельные энкодеры и VAE
Текстовый энкодер models/text_encoders/ Совпадают архитектура модели и loader
VAE models/vae/ Совместим с представлением latent
LoRA models/loras/ Подходит семейство базовой модели и загрузчик
ControlNet models/controlnet/ Совпадают семейство модели и тип conditioning
Апскейлер models/upscale_models/ Поддерживаемая архитектура апскейлера, отдельно от диффузионных весов

В старых графах встречаются алиасы models/clip/ и models/unet/. Используйте пути, поддерживаемые установленной версией, и не копируйте многогигабайтные веса в несколько папок без необходимости. Для отдельного диска моделей есть extra_model_paths.yaml; подключённый каталог всё равно не является резервной копией.

Добавляйте модели осознанно

Откройте карточку автора, выберите точный вариант файла и проверьте место. Скачивайте во временный .partial и переименовывайте только после успеха. Имена для наших графов указаны в списке моделей. Обновите список или безопасно перезапустите сервер, затем выберите фактическое значение dropdown.

Расширение .safetensors само по себе не говорит, перед вами checkpoint, LoRA или отдельная диффузионная модель. При ошибке отсутствующего CLIP или несовместимых размеров тензоров сравните ожидаемые компоненты и семейство модели, а не перебирайте случайные флаги памяти.

Установка и обновление custom nodes

Готовые пресеты устанавливают и включают ComfyUI Manager. Если нужен дополнительный узел, проверьте его источник, поддерживаемую версию ComfyUI, модели и Python-зависимости, затем установите конкретный пакет. Перезапускайте после завершения активных заданий и сохранения работы. Наличие Manager не означает, что уже установлены Impact Pack, все препроцессоры ControlNet или другие пакеты сообщества.

Для ручной установки используйте актуальную настройку Manager. Зависимости должны устанавливаться в то же Python-окружение, из которого запускается ComfyUI. Команда pip из другого окружения может отработать успешно, но сервер узел не увидит.

Custom nodes выполняют код с доступом процесса сервера. Проверяйте незнакомый пакет до установки, особенно если на инстансе есть приватные файлы или API-ключи. Не снижайте настройки безопасности Manager только ради обхода ошибки установки.

Сохраните рабочую версию

Перед обновлением экспортируйте граф, запишите ревизии ComfyUI/custom nodes и список Python-пакетов. Меняйте по одному компоненту и проверяйте небольшой известный граф. Откат Git-ревизии не восстанавливает автоматически Python-зависимости. См. бэкап и описание окружения и диагностику.

Источники: установка custom nodes, дополнительные пути моделей. Вернуться к установке ComfyUI.

Готовы запустить?

Запустить GPU-сервер