Как ставить ноды вручную через git clone

Короткий ответ. Чтобы поставить кастомную ноду ComfyUI вручную, скачайте репозиторий автора в ComfyUI/custom_nodes, установите зависимости в том Python-окружении, которым запускается ComfyUI, и полностью перезапустите сервер. Команда git clone сама по себе лишь копирует код: она не ставит Python-пакеты и не проверяет совместимость версии. Для обычных пакетов сначала посмотрите, доступна ли установка через Manager; ручной путь нужен, когда пакет отсутствует в каталоге или требуется определённая версия. Основа: официальная инструкция ComfyUI.

Перед копированием проверьте источник

Найдите репозиторий автора в README нужного workflow или на странице пакета в Manager. Не берите первую ссылку из комментариев: похожие названия нод могут вести на устаревшие форки. Прочитайте раздел Installation и список поддерживаемых версий. Если автор даёт конкретный commit или release, запишите его. Это поможет повторить рабочую установку после обновления ComfyUI. Перед изменением рабочего окружения сохраните JSON workflow и список уже установленных расширений.

Каталог назначения должен относиться к той копии ComfyUI, которая действительно запущена. На Windows portable, Desktop, в облачном pod и в нескольких виртуальных окружениях пути могут отличаться. Ошибка «скопировал, но нода не появилась» часто означает, что репозиторий попал в другую установку. Найдите команду запуска и текущую папку проекта, затем уже переходите в её custom_nodes.

Установка через git clone

cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/OWNER/REPOSITORY.git

Замените примерный адрес на точный URL из официального репозитория нужной ноды. Если папка с таким именем уже есть, не клонируйте поверх неё: сначала выясните, какой пакет и версия установлены. После клонирования откройте README внутри новой папки. Некоторые расширения требуют только копирования файлов, другие — requirements.txt, отдельные веса, системные библиотеки или специальную команду установки. Универсального pip install -r requirements.txt для всех нод нет. Документация ComfyUI рекомендует учитывать способ вашей установки и зависимости конкретного пакета: Install custom nodes.

Как поставить зависимости в правильный Python

Для виртуального окружения используйте его интерпретатор, например /path/to/venv/bin/python -m pip install -r requirements.txt. В Windows portable путь к Python часто находится внутри пакета установки. Для Desktop и облачного шаблона сначала проверьте инструкцию именно этой сборки. Команда pip из произвольного терминала может обратиться к системному Python; тогда установка завершится успешно, но ComfyUI по-прежнему выдаст ModuleNotFoundError.

Не запускайте команду установки из неизвестного репозитория без просмотра README и состава файлов. Кастомная нода — исполняемый код с доступом к файлам процесса ComfyUI. Для рабочего проекта лучше зафиксировать источник, версию и дату установки. Если расширение просит менять системные библиотеки или удалять существующие пакеты, проверьте последствия в отдельной тестовой среде.

Проверка после перезапуска

1. Полностью остановите процесс ComfyUI и запустите его заново.
2. Посмотрите стартовый лог: пакет должен загрузиться без IMPORT FAILED и трассировки ошибки.
3. Найдите точное имя ноды в меню добавления. Название репозитория и название узла часто различаются.
4. Откройте сохранённый workflow и убедитесь, что соответствующие красные блоки исчезли.
5. Запустите короткую тестовую цепочку и проверьте результат, а не только наличие пункта в меню.

Если при запуске ошибка импорта, читайте первую недостающую библиотеку или несовместимый API в трассировке. Повторная команда git clone не исправит недостающую зависимость. Если лог чистый, но граф всё ещё красный, сравните версию workflow с версией пакета: автор мог переименовать класс ноды или изменить входы. Обычное обновление страницы браузера не заставляет Python повторно загрузить пакет.

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

Можно ли просто положить ZIP в custom_nodes?

Архив нужно распаковать так, чтобы файлы пакета лежали в ожидаемом каталоге. Лишний вложенный уровень папок может мешать загрузке. Проверяйте README автора.

Как откатить неудачную установку?

Сохраните исходный workflow и зафиксируйте, какие файлы были добавлены. Вернитесь к прежней версии пакета или удалите только проверенную папку расширения, затем перезапустите ComfyUI. Если менялись общие зависимости, лучше восстановить отдельное окружение из зафиксированного списка.