Ошибка import failed при загрузке пакета ComfyUI-Easy-Use в консоли ComfyUI почти всегда означает, что Python не смог импортировать один из модулей расширения — либо из-за отсутствующей зависимости, либо из-за конфликта версий библиотек в окружении. При этом сам пакет появляется в папке custom_nodes, но его ноды недоступны в интерфейсе, а в логе запуска видна строка с трейсбеком и пометкой об ошибке импорта.
Проблема решается системно: нужно найти конкретную строку ошибки в консоли, понять, какого модуля не хватает, и устранить причину — установить зависимость, обновить пакет или разрешить конфликт версий. Ниже разберём диагностику по шагам и типовые сценарии исправления.
Как прочитать сообщение об ошибке в консоли
Первое действие — открыть консоль, из которой запускался ComfyUI, и найти блок, относящийся к ComfyUI-Easy-Use. Обычно он выглядит как несколько строк трейсбека, завершающихся строкой вида ModuleNotFoundError: No module named '...' или ImportError: cannot import name '...'. Именно последняя строка трейсбека — ключ к диагностике, а не сама надпись «import failed».
Различайте два типа сообщений. ModuleNotFoundError означает, что библиотека вообще не установлена в текущем окружении Python. ImportError с формулировкой «cannot import name» чаще указывает на то, что библиотека установлена, но её версия несовместима — нужного класса или функции в ней нет. От этого зависит, что делать дальше: ставить пакет или менять его версию.
⚠️ Внимание: не переустанавливайте весь ComfyUI сразу. Ошибка импорта одного пакета кастомных нод практически никогда не требует полной переустановки — достаточно починить окружение или сам пакет.
Типовые причины ошибки import failed
Наиболее частая причина — неустановленные зависимости из файла requirements.txt пакета. Это случается, когда расширение копировали в папку custom_nodes вручную архивом, а не через ComfyUI Manager, либо когда установка зависимостей оборвалась из-за сетевой ошибки.
Вторая группа причин — конфликты версий. Easy Use зависит от ряда библиотек, и если другой пакет нод уже обновил или откатил одну из них (например, transformers, accelerate или huggingface_hub), импорт может сломаться. Третья причина — несовместимость версии Python: портативные сборки ComfyUI используют встроенный интерпретатор, и пакет, рассчитанный на другую версию Python, может не импортироваться.
- 🔍 ModuleNotFoundError — отсутствует библиотека из requirements.txt;
- ⚙️ ImportError: cannot import name — конфликт версий уже установленной библиотеки;
- 🐍 несовпадение версии Python встроенной сборки и требований пакета;
- 📦 повреждённая или неполная копия пакета после ручного копирования файлов;
- 🔁 устаревшая версия самого Easy Use, несовместимая с актуальным ComfyUI.
Шаг 1: установка зависимостей из requirements.txt
Если в консоли ModuleNotFoundError, необходимо установить зависимости пакета. Перейдите в папку расширения и выполните установку через тот же Python, которым запускается ComfyUI. Для портативной сборки Windows это встроенный интерпретатор в папке python_embeded.
cd ComfyUI/custom_nodes/ComfyUI-Easy-Use
python -m pip install -r requirements.txt
Для портативной версии команда выглядит иначе — нужно явно указать путь к встроенному Python:
..\..\..\python_embeded\python.exe -m pip install -r requirements.txtПосле завершения установки перезапустите ComfyUI полностью — не просто обновите страницу в браузере, а закройте консоль и запустите сервер заново. Если установка пакетов завершилась с ошибкой, читайте её текст: часто это конфликт версий, который pip прямо указывает в сообщении.
☑️ Проверка перед установкой зависимостей
Шаг 2: устранение конфликтов версий библиотек
Когда консоль показывает ImportError: cannot import name, установленная версия библиотеки не содержит нужного компонента. Типичный сценарий: другой пакет нод обновил transformers или huggingface_hub, и Easy Use перестал находить функции, на которые рассчитан.
Порядок действий здесь осторожный. Сначала посмотрите в requirements.txt пакета, какая версия библиотеки требуется (если она указана). Затем проверьте установленную версию командой python -m pip show имя_пакета. Если версии расходятся, установите требуемую: python -m pip install имя_пакета==нужная_версия.
⚠️ Внимание: откат версии библиотеки может сломать другой пакет нод, который её обновил. После смены версии проверьте запуск всех критичных для вас расширений, а не только Easy Use. Если конфликт неразрешим (двум пакетам нужны несовместимые версии), вариант — вынести один из них в отдельное окружение ComfyUI.
Шаг 3: обновление или чистая переустановка самого пакета
Иногда проблема в самом Easy Use: устаревшая копия, повреждённые файлы после ручного копирования или незавершённое обновление через ComfyUI Manager. Проверьте, нет ли в папке пакета файлов с расширением .pyc от старых версий и не дублируется ли пакет под разными именами папок в custom_nodes — дубликаты гарантированно вызывают конфликты импорта.
Чистая переустановка выполняется так: удалите папку ComfyUI-Easy-Use из custom_nodes, затем склонируйте репозиторий заново и установите зависимости:
cd ComfyUI/custom_nodes
git clone https://github.com/yolain/ComfyUI-Easy-Use.git
cd ComfyUI-Easy-Use
python -m pip install -r requirements.txt
Если git не установлен, альтернатива — установка через ComfyUI Manager: он сам скачивает пакет и подтягивает зависимости. После переустановки проверьте консоль: строка с Easy Use должна пройти без трейсбека, а ноды пакета появятся в меню поиска.
Сводная таблица диагностики
| Текст ошибки в консоли | Вероятная причина | Действие |
|---|---|---|
| ModuleNotFoundError: No module named 'X' | Библиотека X не установлена | Установить зависимости из requirements.txt |
| ImportError: cannot import name 'Y' | Несовместимая версия библиотеки | Сверить версию с requirements.txt, привести к нужной |
| Ошибка сразу после обновления пакета | Повреждённое обновление или кэш | Чистая переустановка пакета через git clone |
| Ошибки у нескольких пакетов сразу | Сломано окружение Python | Проверить целостность окружения, восстановить из pip freeze |
| Нет трейсбека, но ноды не появляются | Пакет отключён в Manager или дубликат папки | Проверить список custom_nodes и статус в Manager |
Когда проблема глубже: окружение и версия Python
Если ни один из шагов не помог, стоит проверить само окружение. Убедитесь, что вы ставите пакеты именно в тот Python, который запускает ComfyUI: частая ошибка — установка в системный интерпретатор, тогда как сервер работает на встроенном. Проверить можно командой where python (Windows) или which python (Linux) и сравнив путь с тем, что видно в логе запуска ComfyUI.
Также возможна ситуация, когда версия Python устарела относительно требований актуальных библиотек. Проверьте версию командой python --version и сверьтесь с требованиями пакета в его репозитории. Если окружение безнадёжно запутано конфликтами, прагматичный вариант — развернуть свежее окружение ComfyUI и перенести в него только нужные пакеты нод по одному, проверяя запуск после каждого.
Как временно изолировать проблемный пакет
Переименуйте папку пакета, добавив в конец .disabled (например, ComfyUI-Easy-Use.disabled) — ComfyUI пропустит её при загрузке. Это позволит запустить сервер без Easy Use и убедиться, что остальные ноды работают, а затем спокойно чинить пакет отдельно.
Профилактика: как не столкнуться с ошибкой снова
Чтобы import failed не повторялся, придерживайтесь нескольких правил. Устанавливайте и обновляйте пакеты через ComfyUI Manager, а не ручным копированием — так зависимости подтягиваются автоматически. Обновляйте пакеты по одному и проверяйте запуск после каждого: так сразу видно, какое обновление сломало окружение.
Периодически сохраняйте снимок рабочего окружения через pip freeze — это ускорит восстановление в разы. И перед масштабным обновлением ComfyUI или всех нод сразу делайте копию папки custom_nodes: откат займёт минуты вместо часов диагностики.
- 💾 сохраняйте
pip freezeпосле каждой успешной настройки; - 🔄 обновляйте расширения по одному, а не все скопом;
- 📁 делайте резервную копию custom_nodes перед крупными обновлениями;
- 🧭 используйте ComfyUI Manager вместо ручного копирования архивов.
Часто задаваемые вопросы
Easy Use виден в папке custom_nodes, но ноды не появляются в интерфейсе. Что делать?
Откройте консоль запуска ComfyUI и найдите блок загрузки ComfyUI-Easy-Use. Если там есть трейсбек с ошибкой импорта — пакет физически присутствует, но не загрузился. Действуйте по инструкции из статьи: определите тип ошибки и устраните причину, затем полностью перезапустите сервер.
Поможет ли переустановка ComfyUI целиком?
Почти всегда это избыточно. Ошибка импорта одного пакета решается на уровне зависимостей или самого пакета. Полная переустановка оправдана только при серьёзно повреждённом окружении Python, когда ошибки возникают у нескольких расширений одновременно.
После установки зависимостей сломался другой пакет нод. Почему?
Вероятно, Easy Use и другой пакет требуют разных версий одной библиотеки. Проверьте requirements.txt обоих пакетов. Если конфликт неразрешим, варианты — найти версии пакетов, совместимые друг с другом, или запускать их в отдельных окружениях ComfyUI.
Как понять, в какой Python я устанавливаю пакеты?
Выполните where python в Windows или which python в Linux и сравните путь с интерпретатором, который использует ComfyUI (он виден в логе запуска или это python_embeded у портативной сборки). Для портативной версии всегда вызывайте pip через полный путь к встроенному python.exe.
Ошибка появилась сразу после обновления Easy Use через Manager. Что предпринять?
Возможно, обновление прошло неполностью или новая версия требует обновлённых зависимостей. Сначала выполните установку из requirements.txt пакета. Если не помогло — удалите папку пакета и установите его заново через git clone или Manager, затем перезапустите ComfyUI.