Import failed ComfyUI Impact Pack: как исправить ошибку импорта

Ошибка import failed при загрузке ComfyUI Impact Pack означает, что Python не смог импортировать один или несколько модулей пакета — чаще всего из-за отсутствующих зависимостей, конфликта версий или повреждённых файлов в папке custom_nodes. В консоли ComfyUI при этом появляется строка вида Cannot import ... ComfyUI-Impact-Pack, а сами ноды пакета не появляются в интерфейсе.

Проблема почти всегда решается без переустановки всего ComfyUI: достаточно последовательно проверить зависимости, обновить пакет и устранить конфликты с другими кастомными нодами. Ниже — пошаговая диагностика от простых проверок к более глубоким.

Как читать сообщение об ошибке в консоли

Первое действие при сбое — открыть консоль, из которой запускался ComfyUI, и найти полный traceback. Строка IMPORT FAILED сама по себе малоинформативна: реальная причина указана несколькими строками выше или ниже, обычно в виде ModuleNotFoundError, ImportError или AttributeError.

Обратите внимание на имя модуля в тексте ошибки. Если указано что-то вроде No module named 'cv2' или No module named 'ultralytics' — проблема в отсутствующей Python-зависимости. Если ошибка ссылается на файл внутри самого Impact Pack — вероятно, пакет установлен не полностью или повреждён.

Проверка установки зависимостей

Impact Pack использует ряд сторонних библиотек, которые должны быть установлены в то же окружение Python, из которого запускается ComfyUI. В папке пакета есть файл requirements.txt — именно он определяет нужный набор зависимостей.

Для установки зависимостей перейдите в папку пакета и выполните установку через тот же интерпретатор Python, которым запускается ComfyUI:

cd ComfyUI/custom_nodes/ComfyUI-Impact-Pack

python -m pip install -r requirements.txt

Если вы используете портативную сборку ComfyUI для Windows, системный python может не подойти — нужен встроенный интерпретатор из папки python_embeded. Команда тогда выглядит примерно так:

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Impact-Pack\requirements.txt
⚠️ Внимание: установка пакетов в «не то» окружение Python — самая частая причина, когда зависимости вроде бы установлены, но ошибка import failed сохраняется. Всегда проверяйте, каким именно интерпретатором запускается ComfyUI.

Запуск встроенного скрипта установки Impact Pack

У Impact Pack есть собственный установочный скрипт install.py, который выполняется при первом запуске и подтягивает дополнительные компоненты. Если установка была прервана (закрыта консоль, оборвалось соединение), пакет оказывается в полуразвёрнутом состоянии.

В таком случае помогает ручной запуск скрипта из папки пакета:

python install.py

Также в папке пакета может присутствовать директория impact_subpack — она должна лежать рядом с основными файлами пакета внутри custom_nodes, а не быть вложена в отдельную папку. Неверная структура каталогов после распаковки архива вручную — типичный источник сбоя импорта.

☑️ Базовая проверка Impact Pack

Выполнено: 0 / 5

Обновление пакета и ComfyUI

Версия Impact Pack жёстко связана с версией самого ComfyUI: после крупных обновлений ядра старые релизы пакета могут перестать импортироваться из-за изменившихся внутренних API. Симптом — ошибка появилась сразу после обновления ComfyUI.

Порядок действий в этом случае:

  • 🔄 Обновите сам пакет: зайдите в папку ComfyUI-Impact-Pack и выполните git pull, либо обновите его через ComfyUI Manager.
  • 🧩 Проверьте наличие ComfyUI-Impact-Pack-Subpack — для актуальных версий он требуется как отдельный компонент.
  • 🐍 Сверьте версию Python: ComfyUI ориентирован на конкретные ветки Python, и слишком старые или экспериментальные версии могут ломать зависимости.
  • 📦 После обновления повторно выполните установку requirements.txt — список зависимостей мог измениться.
📊 Что стало причиной import failed у вас?
Отсутствующие зависимости Python
Конфликт с другими кастомными нодами
Ошибка после обновления ComfyUI
Повреждённые файлы пакета

Конфликты с другими кастомными нодами

Если зависимости установлены, а ошибка остаётся, возможна коллизия с другими расширениями. Два пакета могут требовать несовместимые версии одной библиотеки — например, разные версии numpy, opencv или torch.

Диагностика простая: временно переместите все остальные папки из custom_nodes в другое место, оставив только Impact Pack, и перезапустите ComfyUI. Если импорт прошёл успешно — возвращайте пакеты по одному, пока не найдёте конфликтующий.

⚠️ Внимание: не удаляйте папки кастомных нод через проводник во время работы ComfyUI — это может привести к повреждению кэша и новым ошибкам импорта. Сначала полностью остановите сервер.
Как найти конфликт версий библиотек

Выполните python -m pip check в окружении ComfyUI — команда покажет несовместимости установленных пакетов. Также полезен вывод pip show для конкретной библиотеки из traceback, чтобы увидеть её версию и сравнить с требованиями пакета.

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

Когда ничто из перечисленного не помогает, остаётся полная переустановка. Удалите папку ComfyUI-Impact-Pack из custom_nodes и установите пакет заново — предпочтительно через ComfyUI Manager, который сам подтянет зависимости, либо через git:

cd ComfyUI/custom_nodes

git clone https://github.com/ltdrdata/ComfyUI-Impact-Pack.git

cd ComfyUI-Impact-Pack

python install.py

Точный адрес репозитория и актуальные требования стоит сверять с официальной страницей проекта на GitHub — структура пакета периодически меняется, и устаревшие инструкции могут не соответствовать текущей версии.

Симптом в консолиВероятная причинаДействие
ModuleNotFoundErrorНе установлена зависимостьpip install -r requirements.txt
ImportError после обновленияНесовместимость версий пакета и ядраОбновить Impact Pack через git pull
Ошибка в файле самого пакетаПовреждённые или неполные файлыЧистая переустановка
Импорт работает без других нодКонфликт кастомных пакетовПоиск конфликтующего расширения

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

Impact Pack установлен через Manager, но всё равно import failed — что делать?

Откройте консоль и найдите конкретный модуль из traceback. Затем вручную выполните установку зависимостей из requirements.txt пакета — Manager не всегда корректно ставит их в портативных сборках.

Ошибка появилась после обновления ComfyUI. Откатываться?

Сначала попробуйте обновить сам Impact Pack — авторы обычно выпускают совместимую версию. Откат ядра ComfyUI имеет смысл только как временная мера, пока пакет не обновлён.

Как понять, в какое окружение ставить зависимости?

Посмотрите, каким интерпретатором запускается ComfyUI: для портативной сборки это python_embeded\python.exe, для ручной установки — активированное виртуальное окружение. Именно этот Python и должен выполнять pip install.

Можно ли удалить папку Impact Pack и поставить заново без потери воркфлоу?

Сами воркфлоу (JSON-файлы) хранятся отдельно и не пострадают. Но ноды Impact Pack в старых схемах будут отображаться как отсутствующие, пока пакет снова не заработает.

Помогает ли перезапуск браузера при ошибке импорта?

Нет. Ошибка импорта возникает на стороне сервера при старте Python-процесса. Нужен полный перезапуск ComfyUI, а не обновление страницы в браузере.