ComfyUI Manager

ComfyUI Manager помогает искать, устанавливать, обновлять и отключать сторонние ноды, находить недостающие пакеты из чужой схемы, управлять моделями и сохранять снимки окружения. В ComfyUI Desktop он уже включён, а в portable и manual-сборках входит в ядро и при необходимости включается штатным способом.

Коротко

ComfyUI Manager — штатный интерфейс управления расширениями и связанными ресурсами ComfyUI. В Desktop-сборке он доступен сразу. В portable и ручной установке Manager находится в ядре ComfyUI, но его зависимости и интерфейс иногда нужно включить по официальной инструкции для этой сборки. Клонировать старый Manager в custom_nodes для новой установки не требуется.

Зачем он нужен

Схема ComfyUI (workflow) хранит названия и настройки нод, но не приносит с собой весь сторонний код. Поэтому после импорта чужой схемы часть блоков может оказаться недоступной.

Manager связывает отсутствующие ноды с пакетами из ComfyUI Registry и помогает установить их в текущее окружение. В нём также можно:

• искать и устанавливать custom nodes;
• обновлять, отключать и удалять пакеты;
• находить зависимости импортированного workflow;
• управлять совместимыми моделями;
• сохранять и восстанавливать снимки состояния установки.

Это удобный центр управления, а не гарантия совместимости. Старый workflow может зависеть от удалённой версии ноды, необычной структуры файлов или конфликтующих Python-библиотек.

Manager и Registry

ComfyUI Registry — публичный каталог пакетов. Авторы публикуют туда custom nodes и их версии.

ComfyUI Manager — интерфейс, который читает этот каталог и выполняет операции в конкретной установке ComfyUI.

Если нужного пакета нет в Registry, Manager может не сопоставить его с красной нодой. Это не всегда означает, что нода исчезла: она могла остаться в отдельном репозитории, сменить название или вообще не публиковаться в реестре.

Что происходит при установке

Когда пользователь выбирает пакет, Manager добавляет его код в окружение ComfyUI и устанавливает заявленные зависимости. Некоторые пакеты также запускают собственный установочный сценарий.

Поэтому custom node — не безобидный файл настроек. Это сторонний программный код с теми же правами, что и локальный ComfyUI. Перед установкой полезно посмотреть:

• кто опубликовал пакет;
• есть ли исходный репозиторий и документация;
• какие зависимости и модели он загружает;
• когда пакет обновлялся;
• подходит ли его лицензия для вашей задачи.

После установки новых Python-нод ComfyUI обычно перезапускают, чтобы окружение загрузило их код.

Как открыть встроенный Manager

Способ зависит от варианта установки:

• ComfyUI Desktop поставляется с включённым Manager;
• portable-сборка содержит Manager в ядре, но может требовать включения и установки его зависимостей;
• ручная установка использует тот же встроенный Manager, который включается при запуске ComfyUI.

Если Manager не виден, в официальной инструкции установки есть отдельные шаги для Desktop, portable и ручного запуска. Для встроенного варианта в portable и manual описаны зависимости из manager_requirements.txt и флаг --enable-manager. Старые инструкции с клонированием отдельного репозитория относятся к прежнему Manager и нужны только для поддержки старого окружения.

Работа с чужим workflow

Работу с импортированной схемой можно разделить на несколько шагов:

1. Импортировать workflow и посмотреть список отсутствующих нод.
2. Открыть Manager и найти связанные пакеты.
3. Проверить источник и зависимости каждого пакета.
4. Установить только то, что действительно требуется.
5. Перезапустить ComfyUI.
6. Убедиться, что модели лежат в ожидаемых каталогах.
7. Запустить небольшой контрольный workflow.

Если нода всё ещё красная, причина может быть не в установке. Иногда workflow ждёт другое имя класса, старую версию пакета или модель, которую Manager не скачивает автоматически.

Снимки окружения

Snapshot сохраняет сведения о состоянии установленных пакетов. Такой снимок полезен перед крупным обновлением или экспериментом: он помогает вернуть прежний набор версий.

При этом snapshot не равен полной резервной копии. Поддержка сторонних пакетов бывает неполной, а большие модели и пользовательские файлы могут храниться отдельно. Для восстановления рабочей сборки отдельно сохраняют схемы, входные файлы, конфигурацию и необходимые модели. Если модели хранятся в другом месте, полезно сохранить их точные имена и контрольные суммы.

Обновления без сюрпризов

Кнопка массового обновления удобна, но сразу меняет много частей окружения. Если один пакет обновит общую библиотеку, соседняя нода может перестать запускаться.

После обновления изменения проверяют на знакомой схеме:

снимок состояния → обновление → контрольный workflow → проверка результата

Если важна повторяемость, фиксируют версии пакетов и сохраняют возможность вернуться к рабочему состоянию. Новая версия не обязана давать тот же результат на старом workflow.

Если зависимости конфликтуют

Manager может установить требования пакета, но не способен сделать совместимыми любые две библиотеки. Признаки конфликта:

• одна нода требует более новую версию библиотеки, другая — старую;
• ComfyUI запускается, но часть пакетов не импортируется;
• после обновления появляется ошибка, которой не было на снимке;
• команда установки прошла успешно, а нода всё равно отсутствует.

В таком случае помогают журнал запуска, сравнение версий и отдельные окружения для несовместимых проектов. Важно работать с Python-окружением именно этой установки ComfyUI, а не со случайным системным интерпретатором.

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

• Manager и custom nodes. Manager встроен в ComfyUI, а управляемые им пакеты остаются сторонними расширениями.
• Manager и Registry. Первый меняет локальное окружение, второй хранит каталог опубликованных пакетов.
• Manager и Python-окружение. Manager ставит зависимости внутрь окружения, но не заменяет его изоляцию.
• Snapshot и резервная копия. Снимок описывает состояние пакетов, но не обязательно сохраняет все файлы проекта.
• Модель и нода. Установленная нода может требовать отдельные веса, которые занимают место и распространяются по своей лицензии.

Частые ошибки

• Устанавливать старый Manager как отдельную custom node. Для новых сборок используется Manager из ядра ComfyUI.
• Ставить весь список отсутствующих пакетов не глядя. В чужом workflow могут быть ненужные или недоверенные расширения.
• Обновлять рабочую сборку перед срочной задачей. Лучше оставить время на контрольный запуск и возможное восстановление.
• Считать удаление пакета полной очисткой. Его Python-зависимости и загруженные модели могут остаться в окружении.
• Верить одному зелёному статусу. Установка пакета не подтверждает, что конкретный workflow даёт правильный результат.

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

Нужно ли устанавливать Manager в custom_nodes? Для встроенного Manager — нет. В Desktop он включён, а в portable и ручной установке могут потребоваться его Python-зависимости и флаг запуска. Это отличается от установки прежнего Manager как отдельного расширения.

Почему Manager не виден? Причиной могут быть параметры запуска, отключённый интерфейс или неустановленные зависимости Manager. Актуальные шаги различаются между Desktop, portable и ручной установкой, поэтому их лучше сверить с официальной страницей установки.

Почему Manager не находит ноду? Пакет мог не попасть в Registry, сменить имя или удалить нужный класс. Помогает поиск по названию отсутствующей ноды и исходному workflow, но неизвестный репозиторий сначала стоит проверить.

Можно ли восстановить всё одним snapshot? Не всегда. Снимки хорошо помогают с управляемыми пакетами, но не заменяют копию моделей, workflow и пользовательской конфигурации.

Отправляет ли Manager данные в сеть? Для чтения реестра и загрузки пакетов ему нужен сетевой доступ. Дополнительные обращения зависят от выбранных пакетов и моделей, поэтому сетевую политику и исходный код особенно важно проверять в чувствительной среде.

Главное

ComfyUI Manager встроен в ComfyUI: в Desktop он включён сразу, а в других сборках может требовать штатного включения. Он хорошо снимает рутину вокруг custom nodes, моделей и снимков окружения. Установленный пакет всё равно проверяют на своей схеме: Manager помогает управлять кодом, но не гарантирует его безопасность и совместимость.