Установка SUPIR в ComfyUI чаще всего упирается не в саму ноду, а в отсутствующие файлы моделей: без весов SUPIR и базовой модели SDXL граф запускается, но падает с ошибкой на этапе загрузки чекпоинтов. Поэтому правильный порядок действий — сначала поставить кастомную ноду, затем вручную разложить модели по нужным папкам и только потом загружать воркфлоу.
SUPIR (Scaling-UP Image Restoration) — это метод апскейла и реставрации изображений, который использует диффузионную модель SDXL в качестве основы. Он заметно тяжелее обычных апскейлеров вроде ESRGAN: требует много видеопамяти и времени на генерацию, но взамен способен восстанавливать детали на сильно сжатых или повреждённых фото. Ниже разберём установку по шагам — от подготовки ComfyUI до первого успешного запуска.
Что понадобится перед установкой
Прежде чем ставить ноду, убедитесь, что ваша система соответствует базовым требованиям. SUPIR — одна из самых требовательных нод в экосистеме ComfyUI, и слабое железо станет главным ограничением.
- 🎮 Видеокарта NVIDIA с большим объёмом VRAM — на картах с 8 ГБ и меньше запуск будет затруднён даже с оптимизациями
- 🐍 Рабочая установка ComfyUI (портативная или через git clone) с актуальной версией
- 📦 Установленный ComfyUI Manager — через него проще всего ставить кастомные ноды
- 💾 Свободное место на диске — веса моделей SUPIR и SDXL вместе занимают десятки гигабайт
Обратите внимание на объём видеопамяти. Разработчики SUPIR изначально ориентировались на карты уровня высокопроизводительных решений NVIDIA. Если у вас меньше VRAM, придётся использовать режимы экономии памяти, о которых речь пойдёт ниже.
Шаг 1. Установка ноды SUPIR через ComfyUI Manager
Самый простой способ — установка через ComfyUI Manager. Откройте интерфейс ComfyUI в браузере, нажмите кнопку Manager на панели справа и выберите Install Custom Nodes. В поиске введите «SUPIR» — в результатах появится нода, обычно публикуемая под названием ComfyUI-SUPIR.
Нажмите Install и дождитесь завершения. После установки Manager предложит перезапустить ComfyUI — сделайте это, иначе нода не появится в списке доступных. Если вы предпочитаете ручную установку, склонируйте репозиторий в папку кастомных нод:
cd ComfyUI/custom_nodes
git clone https://github.com/kijai/ComfyUI-SUPIR.git
После клонирования нужно поставить зависимости. Для портативной версии ComfyUI на Windows команда выглядит примерно так:
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-SUPIR\requirements.txt⚠️ Внимание: путь к интерпретатору Python зависит от вашего типа установки ComfyUI. В портативной сборке это python_embeded, при установке через venv — активированное виртуальное окружение. Использование «системного» Python может привести к конфликту зависимостей.
☑️ Проверка после установки ноды
Шаг 2. Скачивание и размещение моделей
Это самый ответственный этап. Нода SUPIR требует два набора файлов: собственные веса SUPIR и базовую модель SDXL, на которой он работает. Оба скачиваются с Hugging Face — ищите официальный репозиторий проекта SUPIR и страницу модели SDXL.
Файлы раскладываются по стандартным папкам ComfyUI. Точные имена подпапок могут отличаться в зависимости от версии ноды, поэтому сверьтесь с README репозитория ComfyUI-SUPIR — там указано, куда именно помещать каждый файл. Типичная схема выглядит так:
| Файл | Назначение | Типичная папка |
|---|---|---|
| Веса SUPIR (safetensors) | Основная модель реставрации | models/checkpoints |
| SDXL base (safetensors) | Базовая диффузионная модель | models/checkpoints |
| CLIP-энкодеры SDXL | Обработка текстовых промптов | models/clip |
| VAE для SDXL | Декодирование результата | models/vae |
После размещения файлов перезапустите ComfyUI, чтобы он проиндексировал новые модели. Если модель не появилась в выпадающем списке ноды, проверьте расширение файла и вложенность папок — лишний уровень директорий является частой причиной «невидимых» моделей.
Шаг 3. Сборка и запуск воркфлоу
Готовый пример воркфлоу обычно прилагается к репозиторию ноды — файл в формате JSON или картинка с вшитыми метаданными. Перетащите его прямо в окно ComfyUI, и граф соберётся автоматически. Вам останется только выбрать загруженные модели в соответствующих нодах и указать исходное изображение.
Типовая цепочка выглядит так: Load Image → нода загрузки моделей SUPIR → основная нода сэмплирования SUPIR → Save Image. В ноде сэмплирования задаются ключевые параметры: коэффициент апскейла, количество шагов диффузии и текстовый промпт, описывающий содержимое кадра.
Промпт для SUPIR влияет на результат сильнее, чем кажется. Модель использует его как подсказку при восстановлении деталей, поэтому короткое описание сцены («portrait of an elderly man, natural skin texture») даёт более предсказуемый результат, чем пустое поле. Для негативного промпта подойдут стандартные формулировки против артефактов.
Оптимизация под ограниченную VRAM
Если при запуске вы получаете ошибку CUDA out of memory, это ожидаемо на картах со средним объёмом памяти. Есть несколько способов снизить потребление VRAM, и комбинировать их можно.
- 🧩 Включите режим tiled VAE или тайловой обработки, если он предусмотрен нодой — изображение обрабатывается по частям
- 📉 Уменьшите размер входного изображения и коэффициент апскейла для первых тестов
- ⚙️ Запустите ComfyUI с флагом
--lowvramили--medvram, добавив его в bat-файл запуска - 🔢 Сократите число шагов диффузии — качество снизится умеренно, а памяти потребуется заметно меньше
⚠️ Внимание: флаги--lowvramи--medvramвлияют на все ноды в ComfyUI, а не только на SUPIR. Если другие ваши воркфлоу после этого стали работать медленнее, верните стандартный режим запуска и оптимизируйте только сам граф SUPIR.
Даже со всеми оптимизациями SUPIR остаётся тяжёлой моделью: на картах с малым объёмом VRAM генерация одного кадра может занимать много минут. Это нормальное поведение, а не признак неисправности.
Типичные ошибки и их решение
Разберём проблемы, с которыми пользователи сталкиваются чаще всего. Большинство из них диагностируется по тексту в консоли ComfyUI — не закрывайте окно терминала при отладке.
Нода не появляется после установки. Проверьте консоль на предмет ошибок импорта — обычно это неустановленные зависимости из requirements.txt или конфликт версий PyTorch. Установите зависимости вручную и перезапустите ComfyUI.
Ошибка загрузки модели. Убедитесь, что файлы лежат в правильных папках и не повреждены при скачивании. Прерванная загрузка с Hugging Face — частая причина битых safetensors; сравните размер файла с указанным на странице модели и при сомнениях скачайте заново.
Чёрный или испорченный результат. Возможная причина — несовместимый VAE или неверно выбранная базовая модель. Попробуйте явно подключить VAE для SDXL через отдельную ноду Load VAE и проверьте, что в графе используется именно SDXL, а не другой чекпоинт.
Как читать ошибки в консоли ComfyUI
Ищите строку, начинающуюся с Traceback — под ней указана цепочка вызовов. Последняя строка блока содержит тип ошибки (например, ModuleNotFoundError или RuntimeError) и её причину. Именно эта строка подсказывает, чего не хватает: модуля Python, файла модели или видеопамяти.
Обновление и совместимость
Кастомные ноды для ComfyUI обновляются независимо от основной программы, и рассинхрон версий — типичный источник проблем. Если после обновления ComfyUI нода SUPIR перестала работать, проверьте наличие свежей версии самой ноды через Manager → Update All или командой git pull в папке ноды.
Обратная ситуация тоже возможна: свежая версия ноды может требовать более новый ComfyUI или PyTorch. В таком случае в консоли появятся ошибки о несовместимых функциях. Лечится это обновлением основной установки, но перед ним имеет смысл сделать резервную копию рабочей папки ComfyUI.
Часто задаваемые вопросы
Работает ли SUPIR на видеокартах AMD?
Официально проект ориентирован на CUDA и видеокарты NVIDIA. Запуск на AMD теоретически возможен через ROCm-совместимые сборки ComfyUI, но стабильность и производительность не гарантируются — будьте готовы к дополнительной настройке и возможным ошибкам.
Чем SUPIR отличается от обычных апскейлеров вроде ESRGAN?
ESRGAN и подобные модели просто увеличивают разрешение, интерполируя существующие пиксели. SUPIR использует диффузионную модель и фактически «дорисовывает» детали, руководствуясь промптом. Это даёт лучший результат на сильно повреждённых изображениях, но требует в разы больше ресурсов и времени.
Где взять готовый воркфлоу для SUPIR?
Пример воркфлоу обычно опубликован в репозитории ноды ComfyUI-SUPIR на GitHub — в папке examples или прямо в описании. Файл JSON или картинку с метаданными достаточно перетащить в окно ComfyUI.
Можно ли использовать SUPIR без текстового промпта?
Технически поле промпта можно оставить пустым, и генерация пройдёт. Однако модель использует текстовое описание для восстановления деталей, поэтому короткий осмысленный промпт обычно улучшает результат, особенно на портретах и текстурах.
Почему генерация занимает так много времени?
SUPIR прогоняет изображение через полноценную диффузионную модель SDXL с множеством шагов, а при большом коэффициенте апскейла — ещё и в высоком разрешении. Длительное время обработки, особенно на картах с умеренным объёмом VRAM, является нормой для этого метода.