Instalarea ComfyUI: Comfy Desktop, Portable și instalare manuală în ComfyUI & Stable Diffusion / Flux

Ecosistem & Administrare Nivel: începător

ComfyUI se instalează local prin aplicația Comfy Desktop, prin pachetul Portable pentru Windows sau manual dintr-un clone Git, fiecare cu propriul mediu Python; serverul pornește implicit pe http://127.0.0.1:8188.

Intrări & ieșiri nod
# instalare manuală (Windows, macOS, Linux)
git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
pip install -r requirements.txt
python main.py            # interfața: http://127.0.0.1:8188

Documentația oficială descrie trei instalări locale. Comfy Desktop este aplicația care instalează, actualizează și pornește una sau mai multe instanțe ComfyUI, fiecare cu versiunea, nodurile custom și setările ei; rulează pe Windows 10+, macOS 13+ (Apple Silicon) și Linux (pachete .deb și AppImage) și urmărește implicit versiunea stabilă. ComfyUI Portable este o arhivă 7z pentru Windows care conține un Python propriu (python_embeded); se dezarhivează și se pornește cu run_nvidia_gpu.bat (sau run_amd_gpu.bat, run_intel_gpu.bat, run_cpu.bat). Instalarea manuală merge pe toate sistemele și plăcile video: mediu virtual, git clone, PyTorch pentru placa ta, apoi pip install -r requirements.txt.

PyTorch se instalează înaintea dependențelor ComfyUI, cu varianta potrivită plăcii: pentru NVIDIA documentația indică roțile CUDA 13.0 (--extra-index-url https://download.pytorch.org/whl/cu130), pentru AMD pe Linux ROCm 7.2, pentru Intel Arc indexul xpu, iar pe Apple Silicon PyTorch folosește backendul MPS. Python 3.13 este versiunea recomandată; 3.14 funcționează, dar unele noduri custom pot avea probleme, iar 3.12 este alternativa sigură. Fără placă video compatibilă, ComfyUI pornește cu --cpu (lent). Nu există o imagine Docker oficială.

Pentru instalările manuale există și comfy-cli (pip install comfy-cli, apoi comfy install și comfy launch), care alege PyTorch după placa video. Modelele nu vin cu instalarea: se pun în subfolderele din ComfyUI/models/ (vezi Load Diffusion Model) sau în căi declarate în extra_model_paths.yaml. Actualizarea: din Desktop, cu scripturile din folderul update la Portable, respectiv git pull urmat de pip install -r requirements.txt la instalarea manuală. ComfyUI scoate o versiune stabilă aproximativ la două săptămâni; commiturile dintre versiuni pot strica noduri custom.

Concepte cheie și caracteristici

Concept / Parametru Descriere practică
Comfy Desktop Aplicație pentru Windows, macOS (Apple Silicon) și Linux; instalează Python, dependențele și ComfyUI-Manager (pornit cu --enable-manager).
ComfyUI Portable (Windows) Arhivă cu ComfyUI, python_embeded, update și fișierele run_*.bat. Pachetul NVIDIA standard are Python 3.13 și CUDA 13.0; există și unul CUDA 12.6 / Python 3.12 pentru plăcile NVIDIA seria 10 și mai vechi.
Instalare manuală git clone, PyTorch potrivit plăcii, pip install -r requirements.txt, python main.py; merge pe NVIDIA, AMD, Intel, Apple Silicon, Ascend.
comfy-cli comfy install instalează ComfyUI și PyTorch potrivit; comfy launch îl pornește.
--listen [IP] Adresa pe care ascultă serverul; implicit 127.0.0.1. Fără valoare ascultă pe toate interfețele (0.0.0.0,::).
--port Portul serverului; implicit 8188.
--cpu / --lowvram / --novram Rulare doar pe procesor, respectiv moduri pentru memorie video puțină.
--enable-manager Pornește ComfyUI-Manager inclus în ComfyUI (vezi ComfyUI-Manager).
extra_model_paths.yaml Căi suplimentare pentru modele (de exemplu foldere comune cu altă instalare); se pornește de la extra_model_paths.yaml.example.

Exemple practice și scenarii reale

Exemplul 1: Instalare manuală cu placă NVIDIA

Comenzile din ghidul de instalare manuală; mediul virtual separă dependențele ComfyUI de Python-ul sistemului.

conda create -n comfyenv
conda activate comfyenv
git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
pip install -r requirements.txt
python main.py

Exemplul 2: Pornirea pachetului Portable

După dublu clic pe run_nvidia_gpu.bat, consola afișează adresa interfeței. Fereastra consolei trebuie să rămână deschisă cât folosești ComfyUI.

ComfyUI_windows_portable\run_nvidia_gpu.bat

Rezultat

To see the GUI go to: http://127.0.0.1:8188

Exemplul 3: Acces din rețeaua locală și port diferit

python main.py --listen 0.0.0.0 --port 8190

Exemplul 4: Foldere de modele comune cu altă instalare

Fragment din extra_model_paths.yaml, după exemplul din documentație; după salvare, ComfyUI trebuie repornit.

my_custom_config:
    base_path: D:/modele/
    checkpoints: checkpoints
    loras: loras
    vae: vae
    controlnet: controlnet

Greșeli frecvente și capcane

  • Rulezi pip install în Python-ul sistemului în loc de mediul ComfyUI. La Portable folosește python_embeded\python.exe -m pip, la instalarea manuală activează întâi mediul virtual.
  • Suprascrii la Desktop fișierul extra_models_config.yaml generat la instalare. Documentația cere să adaugi căile noi în fișierul existent, după o copie de siguranță.
  • Pornești cu --listen pe o rețea la care au acces și alții fără să te uiți la setările Manager-ului. Documentația lui tratează separat acest caz: nivelul normal- blochează funcțiile de risc mare când adresa din --listen nu începe cu 127., iar în Desktop un nivel mai strict contează mai ales când ComfyUI e expus în rețea.

Noțiuni și module înrudite