Custom Nodes

Custom Nodes — пользовательские ноды ComfyUI, написанные сообществом. Расширяют возможности базового ComfyUI новыми операциями: видео-генерация (AnimateDiff), управление лицом (FaceID), быстрые апскейлеры, ноды для FLUX, генеративная музыка, визуальные эффекты. К 2026-му в реестре больше 3000 пакетов. Устанавливаются через ComfyUI Manager или вручную через git clone в папку custom_nodes.

Коротко

Коротко. Custom Nodes — это «плагины» для ComfyUI, написанные сообществом. Каждая нода — это python-класс, который добавляет в граф workflow новый блок (генерация видео, FaceID, апскейлер, конкретный sampler). К 2026-му в реестре >3000 пакетов. Устанавливаются через ComfyUI Manager (рекомендуется) или вручную: git clone в ComfyUI/custom_nodes/. После установки — restart ComfyUI и новые ноды появляются в меню.

Что это такое

Дизайнер скачал ComfyUI. Запустил дефолтный workflow text-to-image. Работает, генерит, всё хорошо. Но потом видит на YouTube туториал, где автор делает видео из одной картинки за 10 секунд. Открывает свой ComfyUI — нет такой ноды. Идёт в Custom Nodes Manager, ищет «AnimateDiff», нажимает Install, перезапускает. Появляется десяток новых нод для видео.

Это и есть custom nodes — экосистема расширений, которая превратила ComfyUI из базового SD-интерфейса в универсальный генеративный движок.

К 2026-му в нём можно делать почти всё:

• Видео: AnimateDiff, CogVideoX, LTX-Video, Mochi.
• Контроль лица: IPAdapter Plus, InstantID, PuLID, FaceID.
• Управление: ControlNet aux, OpenPose, Depth, AnyDepth.
• Апскейл: Ultimate SD Upscale, Tiled Diffusion, Supir, AuraSR.
• Аудио: ACE-Step, AudioGen, MusicGen.
• 3D: Hunyuan3D, TripoSR, Trellis.
• LLM: Ollama-nodes, ChatGPT-API, vision-модели.
• Утилиты: математика, логика, batch-обработка, IO.

Базовый ComfyUI — это скелет. Custom nodes — мускулы и нервы.

Как это работает

Каждая custom node — это Python-файл с классом, реализующим определённый интерфейс ComfyUI. Внутри класса:

• Метаданные: название, категория, описание, иконка.
• INPUT_TYPES: какие входы принимает (изображение, текст, число).
• RETURN_TYPES: что выдаёт.
• FUNCTION: Python-функция, которая запускается при выполнении.

Файлы лежат в ComfyUI/custom_nodes/<имя_пакета>/. ComfyUI при запуске сканирует эту папку, импортирует все node-классы, добавляет их в реестр доступных операций.

Установка двумя путями:

1. Через ComfyUI Manager. Открыть Manager (если установлен), выбрать «Install Custom Nodes», найти нужный, нажать Install. Manager делает git clone за вас, ставит зависимости через pip, перезапускает ComfyUI.

2. Вручную. Перейти в ComfyUI/custom_nodes/, выполнить git clone https://github.com/<author>/<repo>.git. Установить зависимости через pip install -r requirements.txt. Перезапустить ComfyUI.

Главные источники нод:

• GitHub. Большинство пакетов — открытый код.
• ComfyUI Registry. Официальный реестр (с 2024).
• Civitai. Часто публикует ноды вместе с моделями.
• OpenArt. Каталог workflow'ов и связанных нод.

Пример на практике

Видеомонтажёр хочет автоматизировать генерацию thumbnail-ов для YouTube. Шаги:

1. Базовая генерация: SDXL text-to-image. Работает в дефолтном ComfyUI.
2. Добавление лица канала: хочет, чтобы на каждом thumbnail было его лицо. Ставит InstantID через Manager. Появляются ноды InstantIDFaceAnalysis, InstantIDPatchModel.
3. Текст на картинке: ставит ComfyUI-MagicTextOnImage. Появляется нода Text Overlay.
4. Авто-сохранение по дате: ставит ComfyUI-Custom-Scripts. Появляется нода Save Image Smart с шаблонами имён.
5. Batch генерация: ставит rgthree's nodes. Появляется Image Comparer, Power Lora Loader Mini.

Workflow собирается за вечер. Дальше — одно нажатие кнопки и 12 готовых thumbnail'ов с его лицом, текстом и датой.

При обновлении ComfyUI custom nodes тоже нужно обновлять — старые могут перестать работать с новой версией. Manager умеет проверять обновления одной кнопкой.

Если вы пришли из ComfyUI

Самая частая история с custom nodes выглядит так: вы скачали красивый workflow, бросили JSON на canvas, а вместо аккуратной схемы увидели красные блоки, Missing Node Types и тревожную простыню в terminal. Это не катастрофа. ComfyUI просто честно говорит: «я не знаю, из каких деталей собран этот граф».

Рабочий порядок такой:

1. Откройте workflow и посмотрите список Missing Node Types.
2. В ComfyUI Manager нажмите Install Missing Custom Nodes, если Manager нашёл совпадения.
3. После установки полностью перезапустите ComfyUI, а не только обновите вкладку браузера.
4. Если нода всё ещё красная, откройте terminal: там обычно видно ModuleNotFoundError, конфликт версии или отсутствующую модель.
5. Если ставите вручную, выполняйте pip install -r requirements.txt именно в том Python-окружении, из которого запускается ComfyUI.

Быстрая диагностика:

Симптом	Причина	Что сделать
Красные ноды	пакета нет	поставить через Manager
Ошибка импорта	нет зависимости	поставить зависимости
Workflow не открывается	старая нода	обновить пакет или ComfyUI
Нода есть, результата нет	нет модели	скачать нужные веса
После update всё сломалось	конфликт версий	откатить пакет или venv

С чем часто путают

• Custom Nodes и Workflow — Workflow это граф из соединённых нод. Custom Nodes — отдельные строительные блоки для этого графа. Один Workflow часто использует много custom nodes.
• Custom Node и Model — Node это код-расширение. Model — это веса (.safetensors). Часто ноды требуют конкретных моделей, но это разные сущности.
• Custom Node и Plugin — в ComfyUI это синонимы. В других программах (Photoshop) — разное.
• Custom Nodes и ComfyUI Core — Core это базовый ComfyUI без расширений. Custom Nodes добавляются поверх.
• JS-extensions и Python-nodes — некоторые ноды имеют ещё JavaScript-часть для UI (Mask Editor, Image Comparer). Это разные слои одного пакета.

Частые ошибки и заблуждения

• «Чем больше нод, тем лучше». Не лучше. Каждая нода добавляет потенциальные конфликты, увеличивает время старта ComfyUI, требует ресурсов. Ставить только то, что реально нужно.
• «Все custom nodes безопасны». Не все. Custom node — это произвольный Python-код. Из недоверенного источника он может делать то, чего вы не ждёте. Используйте проверенных авторов и официальный реестр.
• «Можно ставить и удалять без последствий». Зависимости (Python-пакеты) обычно остаются. Удалить custom node не удаляет установленные через pip библиотеки.
• «Все ноды работают со всеми моделями». Многие ноды — модель-специфичные. AnimateDiff работает только с SD 1.5/SDXL, не с FLUX. IPAdapter v2 требует свои файлы и т.д.
• «Custom nodes есть для всех функций». Многих специфичных вещей нет. Если задача очень узкая — придётся писать свою ноду на Python (что в принципе несложно).

Связанные термины

• ComfyUI — основа, для которой создаются custom nodes.
• ComfyUI с нуля — большой маршрут по базовому workflow и диагностике красных нод.
• ComfyUI Manager — главный инструмент установки и обновления пакетов.
• Workflow — граф, в котором используются custom nodes.
• JSON Workflow — формат сохранения workflow'а и переноски схем между людьми.
• Node Pack — обычно несколько связанных нод в одном пакете.
• AnimateDiff / IP-Adapter / ControlNet — популярные custom node-пакеты и семейства расширений.
• KSampler — базовая нода генерации, вокруг которой часто строятся расширенные workflow.
• Stable Diffusion / SDXL / FLUX — модели, под которые custom nodes часто ставят отдельные загрузчики, патчеры и workflow.
• GitHub — главный хостинг custom nodes.

Частые вопросы

Где взять список лучших custom nodes? В ComfyUI Manager есть категория «Featured». Также популярные подборки на OpenArt, Civitai, в комьюнити ComfyUI на Reddit.

Что делать, если workflow пишет Missing Node Types? Сначала попробуйте Install Missing Custom Nodes в ComfyUI Manager. Если Manager не нашёл пакет, скопируйте название отсутствующей ноды и ищите его в GitHub или в README автора workflow. Иногда нода переехала в другой node pack или была переименована после обновления.

Почему custom node установилась, но всё равно не работает? Чаще всего не поставились зависимости из requirements.txt или они поставились не в тот venv. Смотрите terminal, а не только браузер: там будет конкретная ошибка вроде ModuleNotFoundError, ImportError или конфликта версии numpy, torch, opencv.

Как удалить custom node? Через ComfyUI Manager: Manager → Custom Nodes Manager → найти ноду → Disable/Uninstall. Или вручную: удалить папку из custom_nodes/.

Что делать, если custom node ломает ComfyUI? Зайти в custom_nodes/, переименовать папку проблемной ноды (например, добавить .disabled в конец). ComfyUI её проигнорирует. Перезапустить.

Можно ли держать несколько установок ComfyUI? Да, и для серьёзной работы это часто лучший вариант. Один ComfyUI — стабильный для проектов, второй — экспериментальный для новых нод, FLUX-workflow, видео и рискованных обновлений. Так конфликты зависимостей не рушат рабочую сборку.

Можно ли запустить custom nodes на Mac? Большинство — да, но некоторые требуют CUDA (NVIDIA). Mac работает через MPS, что ограничивает совместимость.

Сколько custom nodes можно ставить? Технически без лимита. Практически: 30–80 пакетов — это уже потолок для стабильной работы. Больше — увеличивается время старта и риск конфликтов.

Кто пишет custom nodes? Сообщество: разработчики, художники, исследователи. Некоторые ноды от компаний (Stability AI, Black Forest Labs), другие — от частных лиц.

Главное

Custom Nodes — это пользовательские расширения ComfyUI, превращающие базовый интерфейс в универсальный генеративный движок. К 2026-му в реестре >3000 пакетов: видео, лица, контроль, апскейл, аудио, 3D, LLM. Установка через ComfyUI Manager обычно занимает минуту, но главные риски остаются прежними: конфликты зависимостей, непроверенный Python-код и слишком тяжёлая сборка. Если workflow не открывается, начинайте с Missing Node Types, Manager и terminal. Лучшая практика — ставить только нужное от проверенных авторов (rgthree, lllyasviel, cubiq, Acly), держать рабочую сборку отдельно от экспериментальной и обновлять пакеты осознанно.