Czym jest ComfyUI?

ComfyUI to wizualny edytor workflow do generowania grafiki AI. Zamiast wpisywać komendy, łączysz „node'y" (węzły) na płótnie — jak w edytorze dźwięku czy Blenderze. Każdy node robi jedną rzecz: ładuje model, koduje prompt, próbkuje obraz, zapisuje plik. Łączysz je przewodami i klikasz „Queue Prompt" — resztę robi GPU. To alternatywa dla Automatic1111, ale bardziej elastyczna i szybsza.

Wielu początkujących odbija się od ComfyUI przez "spaghetti" połączeń i problemy z menedżerem pakietów. Wbudowany przycisk "Download missing models" często zawodzi przy plikach ważących 30-70 GB — nie obsługuje wznawiania połączeń i autoryzacji HuggingFace. Efekt? Uszkodzone pliki i błędy header too small.

Zrobimy to metodą "Clean install & Manual wget". To jedyna droga, która daje 100% pewności, że Twoje środowisko będzie stabilne. Zakładam, że masz już Linuxa ze sterownikami CUDA.

① Instalacja Core ComfyUI

Zacznijmy od postawienia fundamentów. Sklonujemy repozytorium, utworzymy izolowane środowisko wirtualne (venv), aby nie zaśmiecać systemu, i zainstalujemy PyTorch z obsługą najnowszych kart graficznych.

user@gpu-server:~
# 1. Pobranie repozytorium
$git clone https://github.com/comfyanonymous/ComfyUI.git
$cd ComfyUI
# 2. Utworzenie środowiska wirtualnego
$python3 -m venv comfyui-env
$source comfyui-env/bin/activate
# 3. Instalacja PyTorch (wersja pod CUDA 13)
$pip install torch torchvision --index-url https://download.pytorch.org/whl/cu130
# 4. Reszta zależności
$pip install -r requirements.txt
# 5. Pierwsze uruchomienie (dostępne pod IP:8188)
$python main.py --listen 0.0.0.0 --enable-manager

② Instalacja Modeli (Metoda Templates)

Tutaj stosujemy specyficzny workflow, który eliminuje błędy. Nie zgadujemy, jakich plików brakuje – ComfyUI powie nam to samo.

Zasada działania — krok po kroku

1
Wchodzisz w zakładkę Templates w interfejsie ComfyUI.
2
Wybierasz interesujący Cię model (np. Qwen Image).
3
System załaduje "mapę" połączeń i wyświetli czerwone ramki z listą brakujących plików.
!
STOP! Nie klikaj "Install" ani "Download missing".
5
Skopiuj nazwę/URL brakującego pliku i pobierz go ręcznie komendą wget w terminalu.

Dlaczego tak? Bo wbudowany downloader psuje duże pliki (30-70 GB). Terminal z wget daje pełną kontrolę — wznawianie, weryfikacja, prędkość.

1️⃣ Qwen Image 2512 (Generowanie)

Wybierz szablon Qwen Image 2512. Zobaczysz braki w sekcjach VAE, Text Encoder i Diffusion Model. Pobierz je do odpowiednich katalogów:

Instalacja Qwen Image
# VAE (Visual AutoEncoder)
$wget -O models/vae/qwen_image_vae.safetensors \
https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/vae/qwen_image_vae.safetensors
# Text Encoder
$wget -O models/text_encoders/qwen_2.5_vl_7b_fp8_scaled.safetensors \
https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/text_encoders/qwen_2.5_vl_7b_fp8_scaled.safetensors
# Diffusion Model (Główny model)
$wget -O models/diffusion_models/qwen_image_2512_fp8_e4m3fn.safetensors \
https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_2512_fp8_e4m3fn.safetensors
# LoRA (Dostrojenie - przyspieszenie do 4 kroków)
$wget -O models/loras/Qwen-Image-Lightning-4steps-V1.0.safetensors \
https://huggingface.co/Qwen/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-4steps-V1.0.safetensors

2️⃣ Qwen Image Edit 2511 (Edycja)

W Templates wybierz Qwen Image Edit 2511. Ten model służy do "inpaintingu" — naprawiania lub zmieniania wybranych fragmentów obrazu. Zaznaczasz maskę (obszar do zmiany), wpisujesz prompt opisujący co ma się tam pojawić, i model generuje spójną edycję. Wymaga innego modelu dyfuzji:

Instalacja Qwen Edit
# Model dyfuzji do edycji
$wget -O models/diffusion_models/qwen_image_edit_2511_bf16.safetensors \
https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_edit_2511_bf16.safetensors
# Dedykowane LoRA
$wget -O models/loras/Qwen-Image-Edit-2511-Lightning-4steps-V1.0-bf16.safetensors \
https://huggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightning/resolve/main/Qwen-Image-Edit-2511-Lightning-4steps-V1.0-bf16.safetensors

3️⃣ Hunyuan 3D 2.1 (Generowanie 3D)

W Templates szukaj Hunyuan 3D 2.1. To narzędzie od Tencent do generowania pełnych siatek 3D (mesh) z pojedynczego zdjęcia lub opisu tekstowego. Wrzucasz zdjęcie obiektu — dostajesz model 3D gotowy do użycia w grach, wizualizacjach czy druku 3D. Plik jest ogromny, więc wget jest tu obowiązkowy.

Instalacja Hunyuan 3D
# Główny Checkpoint
$wget -O models/checkpoints/hunyuan_3d_v2.1.safetensors \
https://huggingface.co/Comfy-Org/hunyuan3D_2.1_repackaged/resolve/main/hunyuan_3d_v2.1.safetensors

③ Finalizacja

Po zakończeniu pobierania zrestartuj ComfyUI w terminalu (CTRL+C, potem ponowne uruchomienie). Teraz po wejściu w Templates i wybraniu workflow, wszystkie „czerwone ramki" powinny zniknąć, a system będzie gotowy do generowania.

Troubleshooting — częste problemy

⚠ header too small — plik modelu jest uszkodzony (niedokończone pobieranie). Usuń go i pobierz ponownie z wget. Dodaj flagę -c aby włączyć wznawianie.
⚠ CUDA out of memory — używasz modelu w pełnej precyzji (bf16) na GPU z za mało pamięci. Szukaj wersji fp8 (8-bit) zamiast bf16 (16-bit) — ważą 2× mniej.
⚠ Node nie istnieje — brakuje Custom Node. Wejdź w Manager → Install Missing Custom Nodes (to jest bezpieczne — to instaluje tylko kod, nie modele).