Перед началом

Главный совет: спросите нейросеть!

Прежде чем искать решение вручную, попробуйте самый быстрый способ. Современные нейросети отлично разбираются в коде Python и стектрейсах PyTorch — они мгновенно определят причину проблемы по тексту ошибки.

Как это сделать

1. Найдите чёрное окно консоли, которое открылось вместе с ComfyUI (или вкладку терминала, если запускали из IDE).
2. Прокрутите его вверх и найдите красный текст ошибки. Обычно он начинается со слов Traceback (most recent call last):. Самое важное — последние 5–10 строк: именно там содержится конкретное сообщение об ошибке.
3. Выделите и скопируйте весь блок с ошибкой (от Traceback до конца).
4. Перейдите к нейросети — Claude, ChatGPT, DeepSeek, Gemini или Grok.
5. Вставьте текст ошибки и попросите объяснить и исправить.

Пример запроса

Проблемы при установке и запуске

Desktop или Portable: какую версию выбрать 2026

Что нового в 2026

Сейчас существует три способа установить ComfyUI, и выбор сильно влияет на стабильность:

• ComfyUI Desktop — официальный установщик-приложение от Comfy-Org. Работает только на NVIDIA GPU с CUDA. Удобен для новичков, но требует не менее 15 ГБ свободного места и прав администратора.
• ComfyUI Portable — самораспаковывающаяся версия с встроенным Python. Самый стабильный и универсальный вариант, рекомендуется для большинства пользователей.
• Manual (Git + venv) — для разработчиков и владельцев AMD / Intel Arc / Apple Silicon. Требует ручной настройки PyTorch.

Установка зависает, pip падает, ошибки зависимостей

Описание проблемы

При первой установке процесс прерывается, зависает на скачивании или выдаёт ошибки при установке «тяжёлых» пакетов: torch, torchvision, onnxruntime, opencv-python.

Решение

• Расположение: поместите ComfyUI в корень диска (например, C:\ComfyUI или D:\AI\ComfyUI). Избегайте системных папок (Documents, Desktop, Program Files, OneDrive) и путей со спецсимволами.
• Python: используйте Python 3.10–3.12 (3.12 рекомендуется в 2026). Версия 3.13 ещё нестабильна для многих кастомных нод. Создайте чистое venv-окружение командой python -m venv venv, избегайте Conda — он часто конфликтует с ComfyUI Manager.
• Антивирус и SmartScreen: временно отключите или добавьте папку ComfyUI в исключения. Defender часто блокирует загрузку моделей и .pyd-файлов.
• Свободное место: убедитесь, что на диске есть минимум 15 ГБ для установки и ещё столько же — для моделей.
• Зеркала: при медленной загрузке используйте зеркало pip:
  pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

«Python process exited with code 1» в Desktop 2026

Описание проблемы

Свежий ComfyUI Desktop не запускается, в логах — лаконичное «Python process exited with code 1». В 2026 году эта ошибка стала одной из самых массовых.

Решение

Чаще всего проблема в неправильном выборе папки установки и трёх отсутствующих пакетах: torch, psutil, einops. Переустановите ComfyUI Desktop:

1. Полностью удалите Desktop (включая папки в %APPDATA% и %LOCALAPPDATA%).
2. Запустите установщик от имени администратора.
3. Выберите путь без пробелов и кириллицы, не в Program Files и не на сетевом диске.
4. Доустановите недостающие пакеты во встроенный Python:

Проблемы с кириллицей или пробелами в путях

Описание проблемы

ComfyUI и часть кастомных нод (особенно работающие с моделями FaceID, IPAdapter, ControlNet) некорректно работают, если путь содержит кириллицу или пробелы.

Решение

Используйте пути только из латинских символов и цифр без пробелов:

Ошибка «ModuleNotFoundError» или «Модуль не найден»

Описание проблемы

Не хватает Python-библиотеки. Чаще всего возникает после установки нового набора нод или обновления ComfyUI.

Решение

См. подробный раздел «Красные ноды и ModuleNotFoundError».

«Port already in use» или белый экран при запуске

Описание проблемы

ComfyUI запускает веб-сервер на порту 8188. Если порт занят, сервер не стартует. Иногда проблема проявляется как пустой белый экран в браузере или бесконечный loader.

Решение

• Смените порт: отредактируйте run_nvidia_gpu.bat, добавив флаг --port:
  .\python_embeded\python.exe -s ComfyUI\main.py --port=8189 --windows-standalone-build
• Найдите процесс на порту 8188:
  netstat -ano | findstr :8188 taskkill /PID [номер_PID] /F
• Очистите кэш браузера: Ctrl+Shift+R или режим инкогнито. Часто помогает после обновлений фронтенда.
• Файрвол: разрешите Python.exe и ComfyUI в Windows Defender Firewall.

Проблемы с GPU, драйверами и CUDA

Описание проблемы

Ошибки Failed to create CUDAExecutionProvider, CUDA_PATH not set, no kernel image is available, Torch not compiled with CUDA enabled.

Решение

• Используйте Portable-версию: в неё уже встроены совместимые PyTorch и CUDA — это избавляет от 90% проблем.
• Обновите драйверы: установите свежий NVIDIA Studio Driver (или Game Ready) с официального сайта.
• RTX 50-series: для Blackwell необходимы PyTorch 2.7+ с CUDA 12.8 или 12.9. Старые сборки PyTorch вызовут no kernel image is available.
• Проверьте установку CUDA в PyTorch:
  python -c "import torch; print(torch.cuda.is_available()); print(torch.version.cuda)"
  Если False, переустановите torch с правильным индексом:
  pip uninstall torch torchvision torchaudio pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128

Конфликт TensorFlow с einops 2026

Описание проблемы

Свежая ошибка 2026 года: ComfyUI крашится с AttributeError: module 'tensorflow' has no attribute 'Tensor'. Возникает из-за того, что какой-то кастомный нод подтянул TensorFlow, и он начинает мешать einops, хотя ComfyUI работает только на PyTorch.

Решение (30 секунд)

Удалите TensorFlow из встроенного Python:

Затем переустановите einops:

«Access denied» или «Отказано в доступе»

Описание проблемы

Программа не может записать или прочитать файл. Часто случается, если ComfyUI установлен в системную папку (Program Files), заблокирован антивирусом или находится в OneDrive с активной синхронизацией.

Решение

• Запускайте run_*.bat от имени администратора.
• Переместите ComfyUI в несистемную папку (например, C:\ComfyUI или D:\AI\ComfyUI).
• Уберите ComfyUI из синхронизации OneDrive / Google Drive / Dropbox — они блокируют файлы во время записи.
• Добавьте папку в исключения антивируса.

«DLL load failed»

Описание проблемы

В Windows отсутствуют системные библиотеки — чаще всего Visual C++ Redistributable, реже cuDNN или zlibwapi.dll.

Решение

• Установите свежие Microsoft Visual C++ Redistributable (нужны и x86, и x64).
• Если ошибка про cudnn_ops64_*.dll или cublas64_*.dll — обновите драйверы NVIDIA до последней версии.
• При установке SageAttention или Triton ошибка про DLL обычно означает, что не установлены libs / include папки рядом с embedded Python — см. раздел SageAttention.

Проблемы с кастомными нодами

По официальной статистике Comfy-Org, большинство багрепортов 2026 года вызваны не ComfyUI, а кастомными нодами. Перед тем, как репортить баг, обязательно отключите все кастомные ноды и проверьте, воспроизводится ли проблема на чистой установке.

Красные ноды (Red Box) и ModuleNotFoundError

Описание проблемы

После загрузки воркфлоу некоторые ноды отображаются как красные блоки. В консоли — ошибка ModuleNotFoundError (например, facexlib, av, insightface, onnxruntime) — у ноды не хватает зависимостей.

Решение

1. ComfyUI Manager: нажмите «Manager» → «Install Missing Custom Nodes». Менеджер сам найдёт, скачает и установит недостающие ноды и их зависимости.
2. Установите зависимости вручную: найдите в консоли название модуля и установите его в правильный Python:
   # Portable .\python_embeded\python.exe -m pip install facexlib insightface onnxruntime-gpu # Desktop "%LOCALAPPDATA%\Programs\comfyui-electron\resources\ComfyUI\python\python.exe" -m pip install facexlib # Manual / venv .\venv\Scripts\python.exe -m pip install facexlib
3. Запустите install.bat внутри папки кастомной ноды, если она его содержит.
4. Обновите ноду: в Manager → «Update All». Часто проблема в несовместимости старой ноды с новой версией ComfyUI.

Конфликт кастомных нод

Описание проблемы

Два набора нод содержат класс с одинаковым именем. ComfyUI загружает только один, и воркфлоу другого ломается. В консоли видно сообщение вида Node 'XYZ' is overridden by another node.

Решение

1. Откройте папку ComfyUI\custom_nodes\.
2. Найдите конфликтующий набор.
3. Переименуйте его, добавив тильду в начало: Conflicting-Nodes → ~Conflicting-Nodes. ComfyUI игнорирует папки, начинающиеся с ~.
4. Перезапустите ComfyUI и проверьте, какой набор оставить.

ComfyUI Manager не работает

Описание проблемы

Manager не скачивает ноды, выдаёт ошибки или вовсе не появляется в интерфейсе.

Решение

• Установите Git: Manager использует git clone для скачивания нод. Скачайте Git с git-scm.com и убедитесь, что он добавлен в PATH.
• Запустите от администратора или переместите ComfyUI в папку с правами на запись.
• Избегайте Conda: Manager регулярно конфликтует с Anaconda-окружениями. Используйте Portable или чистый venv.
• Ручное клонирование Manager:
  cd ComfyUI\custom_nodes git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
• Security level: в 2026 Manager V2 имеет встроенный security pipeline. Если ноды не устанавливаются с предупреждением — проверьте настройку security_level в config.ini Manager'а.

Воркфлоу сломался после обновления

Описание проблемы

Воркфлоу, работавший месяц назад, теперь выдаёт красные ноды и ошибки. ComfyUI развивается очень быстро, и кастомные ноды обновляются ещё быстрее — что-то ломается почти каждое обновление.

Решение

• Бэкапьте рабочую сборку: перед обновлением скопируйте всю папку ComfyUI в архив.
• Используйте Git и теги: создавайте rollback-точки командой git stash или git tag working-2026-04-15. При проблеме можно откатить за секунды.
• Не обновляйтесь перед дедлайном: обновляйте, когда есть время на тестирование и фиксы.
• Документируйте версии: при шеринге воркфлоу добавляйте список используемых нод и их версий — это критично для воспроизводимости.

Проблемы в процессе работы

«Reconnecting…» — главная проблема 2026 2026

Описание проблемы

Самая массовая жалоба пользователей в 2026 году. В середине генерации браузер показывает «Reconnecting…» и циклически пытается восстановить WebSocket-соединение с бэкендом. Воркфлоу останавливается.

Главная причина

Исчерпание VRAM: бэкенд крашится молча, ничего не пишет в лог, и фронт уходит в reconnect-цикл. Вторая по частоте причина — конфликт кастомных нод, которые так же тихо рушат Python-процесс.

Решение по шагам

1. Откройте консоль и проверьте логи. Если бэкенд упал — там будет stacktrace с OutOfMemoryError или ошибкой ноды.
2. Перезапустите бэкенд — закройте консоль и запустите run_nvidia_gpu.bat заново.
3. Очистите кэш браузера: Ctrl+Shift+R или режим инкогнито.
4. Уменьшите нагрузку: снизьте разрешение, batch_size = 1, выгрузите неиспользуемые модели.
5. Добавьте флаги памяти в .bat:
   set PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:512,expandable_segments:True .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --lowvram
6. Проверьте порт и файрвол: 8188 не должен быть заблокирован.
7. Cloud-пользователи (RunPod, Vast, Google Cloud): проверьте SSH-туннель, nginx-конфиг WebSocket и cloud-firewall.
8. Если ничего не помогает — сделайте чистую переустановку Portable, бэкапнув models, output и нужные кастомные ноды.

Модель, LoRA или файл не найдены в списке

Описание проблемы

Скачали модель, положили в папку, но в выпадающем списке ноды её нет. Также ошибка вида: Value not in list: ckpt_name: 'sd_xl_base_1.0.safetensors' not in [...]

Решение

ComfyUI использует строгую структуру внутри ComfyUI\models\:

• Чекпоинты (SD 1.5, SDXL, Flux, Pony): \models\checkpoints\
• UNet / Diffusion Models (для Flux 2, Wan, LTX): \models\diffusion_models\ или \models\unet\
• LoRA: \models\loras\
• VAE: \models\vae\
• CLIP / Text Encoders: \models\clip\ или \models\text_encoders\
• ControlNet: \models\controlnet\
• Upscale-модели: \models\upscale_models\
• Embeddings (Textual Inversion): \models\embeddings\
• GGUF-кванты: обычно в \models\unet\ или \models\diffusion_models\

После перемещения файлов нажмите «Refresh» в интерфейсе или перезапустите ComfyUI.

Ошибка загрузки модели (HeaderTooLarge, Deserialization)

Описание проблемы

При попытке загрузить .ckpt или .safetensors возникает HeaderTooLarge, SafetensorError или Deserialization error.

Решение

• Перекачайте файл: главная причина — недокачанный файл или сбой при скачивании. Сравните размер с указанным на странице загрузки и проверьте SHA256, если он есть.
• Проверьте формат: не пытайтесь грузить upscale-модель в CheckpointLoader или GGUF-файл в обычный лоадер — для GGUF нужен UnetLoaderGGUF из ComfyUI-GGUF.
• Проверьте назначение: модель Flux нельзя загрузить как SDXL-чекпоинт — для Flux нужен UNETLoader + отдельные CLIP и VAE.
• Конвертация: устаревшие .ckpt можно конвертировать в .safetensors — это безопаснее и быстрее.

Изображение серое, блеклое, пересвеченное или в «молоке»

Описание проблемы

Классическая проблема — связана с VAE (Variational Autoencoder). Если VAE отсутствует, не подходит к модели или не подключён — цвета искажаются.

Решение

1. Используйте правильный VAE. Для SD 1.5 — vae-ft-mse-840000-ema-pruned. Для SDXL — VAE из комплекта базовой модели или sdxl_vae.safetensors. Для Flux 1 / Flux 2 — ae.safetensors (входит в репозиторий моделей). Для Wan 2.2 (B-модели high/low) — VAE из Wan 2.1 (важно!), для Wan 2.2 5B — собственный VAE 2.2.
2. Подключите VAE: используйте ноду VAELoader и подключите её выход к VAE Decode.
3. Проверьте force_upcast в настройках — иногда помогает при артефактах SDXL VAE.

Изображение искажённое, «шумное» или абстрактное

Описание проблемы

Вместо ожидаемой картинки — абстрактный шум или искажения. Чаще всего — несовместимость компонентов воркфлоу.

Самые частые причины

• Смешивание архитектур: SDXL-чекпоинт + LoRA для SD 1.5 (или наоборот), Flux-LoRA на SDXL, ControlNet от другой версии. Все компоненты должны быть для одной архитектуры.
• Слишком высокий CFG: для Flux нормальный CFG = 1.0 (используется guidance вместо). Для SDXL — 5–8. CFG = 15+ обычно даёт пережарку и шум.
• Слишком мало шагов: 4–8 шагов — только для Turbo / Lightning / DMD2 моделей. Для классических SDXL нужно 25–40.
• Неподходящий sampler/scheduler: попробуйте euler + simple или dpmpp_2m + karras как стартовую точку.

«Out of memory» (OOM) и Dynamic VRAM 2026

Описание проблемы

При генерации с большими моделями (Flux 2, Wan 2.2, LTX 2.3, Qwen-Image) или высоком разрешении возникает torch.OutOfMemoryError: CUDA out of memory.

Решение

• Используйте квантизованные модели: GGUF Q4 / Q5, FP8, NVFP4 (см. раздел квантизаций). На RTX 4060 (8 ГБ) Flux 2 Klein нормально работает в GGUF Q4 с Dynamic VRAM.
• Уменьшите разрешение и batch: 768×768 + batch_size=1 вместо 1024×1024 + batch_size=4. Апскейл — отдельным проходом.
• Флаги VRAM-оптимизации в run_*.bat:
  --lowvram # для GPU 4-6 ГБ --medvram # для GPU 6-8 ГБ --novram # экстремальный режим (всё в RAM, очень медленно) --use-split-cross-attention # экономия памяти на attention
• PYTORCH_CUDA_ALLOC_CONF — переменная окружения, фрагментирующая аллокатор и реально помогающая на грани OOM:
  set PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:512,expandable_segments:True
• Закройте браузеры и игры: Chrome / Edge с десятком вкладок легко съедают 1-2 ГБ VRAM.
• Settings → Performance → Enable Model Offloading — встроенный механизм выгрузки моделей в RAM между шагами.
• Следите за температурой: перегрев GPU тоже даёт «OOM-подобные» крэши.

«OS Error 1455: paging file too small» 2026

Описание проблемы

Частая ошибка 2026 года при загрузке Flux 1, Flux 2, SDXL, Wan 2.2 на Windows. Это проблема системной RAM, а не VRAM — новое железо покупать не нужно.

Решение: вручную увеличить файл подкачки

1. Win+R → sysdm.cpl → вкладка «Дополнительно».
2. В разделе «Быстродействие» нажмите «Параметры…».
3. Вкладка «Дополнительно» → раздел «Виртуальная память» → «Изменить…».
4. Снимите галочку «Автоматически выбирать объём».
5. Выберите ваш SSD → «Указать размер»: исходный = 16384 МБ, максимальный = 65536 МБ (или больше при наличии места).
6. Нажмите «Задать» → ОК → перезагрузите Windows.

Wan 2.2: «expected 36 channels but got 32 channels» 2026

Описание проблемы

При запуске Wan 2.2 I2V воркфлоу появляется ошибка Given groups=1, weight of size [5120, 36, 1, 2, 2], expected input[1, 32, 21, 96, 96] to have 36 channels, but got 32 channels instead.

Причина и решение

Это путаница с VAE. Wan 2.2 модели high и low по-прежнему используют VAE от Wan 2.1. Собственный Wan 2.2 VAE нужен только для Wan 2.2 5B модели. Подключите правильный VAE:

• Wan 2.2 high / low (B-модели) → wan_2.1_vae.safetensors
• Wan 2.2 5B → wan_2.2_vae.safetensors

Также при появлении этой ошибки иногда виноваты SageAttention + Triton — попробуйте временно запустить ComfyUI без флага --use-sage-attention.

Отсутствуют превью изображений

Описание проблемы

В Preview Image или Save Image картинка не появляется, хотя в логах генерация завершилась. В output файлы есть, но в UI пусто.

Решение

• Очистите кэш браузера: Ctrl+Shift+R.
• Проверьте права на output: папка должна быть доступна на запись.
• Обновите ComfyUI и фронтенд: старый фронт + новый бэк часто не понимают друг друга.
• Включите превью семплинга: Manager → Preview Method → Auto (latent2rgb) или TAESD.
• Отключите расширения браузера (особенно блокировщики), которые могут резать локальные WebSocket-кадры.

Производительность и оптимизация 2026

SageAttention 2.2 + Triton 2026

Что это

SageAttention 2.2 + Triton — стандарт де-факто для ускорения ComfyUI в 2026. Особенно сильно ускоряет видео-модели (Wan 2.2, LTX) — до 1.5–2.5× быстрее и на 5-6°C холоднее.

Установка (Portable, Windows)

1. Узнайте версии: python_embeded\python.exe -c "import sys, torch; print(sys.version, torch.__version__, torch.version.cuda)"
2. Установите Triton:
   .\python_embeded\python.exe -m pip install -U "triton-windows<3.7"
3. Скачайте подходящий wheel SageAttention 2.2 с релизов или из индекса AI-windows-whl по точному соответствию cp{python}-cu{cuda}-torch{torch}.
4. Установите wheel:
   .\python_embeded\python.exe -m pip install path\to\sageattention-2.2.0+cu128torch2.8.0-cp312-cp312-win_amd64.whl
5. Добавьте флаг в run_nvidia_gpu.bat: --use-sage-attention.

Альтернатива для тех, кто не хочет возиться: используйте автоматический установщик DazzleML/comfyui-triton-and-sageattention-installer — он сам подбирает совместимые версии.

GGUF, FP8 и NVFP4: что выбрать 2026

Краткая шпаргалка по форматам

• FP16 / BF16 — оригинальная точность, максимальное качество. Нужен GPU с большим VRAM (24+ ГБ для Flux 2).
• FP8 (e4m3fn / e5m2) — экономия 30-40% VRAM, минимальная потеря качества. Поддерживается с RTX 40-серии. Хороший баланс для 12-16 ГБ карт.
• GGUF (Q8 / Q6_K / Q5_K / Q4_K_M / Q4_K_S / Q3_K / Q2_K) — самые экономные кванты, до 70% экономии. Идеально для 8-12 ГБ карт. Чем меньше число, тем сильнее сжатие и потеря качества. Q4_K_M — обычно лучший компромисс. Нужны ноды ComfyUI-GGUF от city96.
• NVFP4 2026 — новый 4-битный формат, аппаратно ускоряемый только на RTX 50-series (Blackwell). Даёт 2.7× ускорение и 55% экономии VRAM. На старых картах не работает или работает медленнее GGUF.

Что выбрать по железу

• RTX 4060 (8 ГБ): GGUF Q4_K_M + Dynamic VRAM
• RTX 4070 / 4070 Ti (12 ГБ): GGUF Q5_K_M или Q6_K, либо FP8
• RTX 4080 / 4090 (16-24 ГБ): FP8, для Flux 2 — GGUF Q8 или FP8
• RTX 5070 / 5080 / 5090: NVFP4 для поддерживаемых моделей, иначе FP8

xformers и медленная генерация

Описание проблемы

Генерация даже простой 1024×1024 картинки занимает 1-3 минуты, хотя GPU достаточно мощный.

Решение

• Проверьте, что используется GPU, а не CPU: в логе при запуске должно быть Using NVIDIA GPU или CUDA available: True. Если CPU — переустановите PyTorch с CUDA.
• В Portable xformers уже установлен. Если ставили вручную: pip install xformers.
• В RTX 30 / 40 / 50 в 2026 SageAttention обычно быстрее xformers — рассмотрите переход.
• Не используйте --cpu и убедитесь, что в .bat нет флага --disable-xformers.
• SDPA (встроенный в PyTorch 2.x) часто работает не хуже xformers — может включаться автоматически.
• Снизьте шаги: 25-30 шагов с dpmpp_2m karras обычно достаточно. 50-150 шагов — редко даёт визуальное улучшение.

Быстрая диагностика: с чего начать?

Если непонятно, в чём причина — пройдитесь по этому чек-листу сверху вниз:

1. Изучите консоль: скопируйте последние 100-200 строк из чёрного окна. Именно там — текст ошибки. Самые важные слова: Traceback, Error, Failed, OOM, CUDA.
2. Скармливайте ошибку нейросети. Это правда быстрее, чем гуглить — см. раздел в начале.
3. Минимальный воркфлоу: попробуйте простейший Loader → KSampler → Save Image. Если работает — проблема в нодах сложного воркфлоу.
4. Отключите кастомные ноды: временно переименуйте custom_nodes в ~custom_nodes и перезапустите. Если ошибка ушла — виновата одна из нод.
5. Проверьте версии: ComfyUI, GPU-драйвера, CUDA, PyTorch. Несовпадения — частая причина странных багов.
6. Запустите с флагами: --lowvram, --port 8189, --use-split-cross-attention — четверть проблем решается за минуту.
7. Чистая переустановка: крайнее средство, но иногда быстрее, чем чинить старую сборку. Бэкапьте models, output и список нод.