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ștepython_embeded\python.exe -m pip, la instalarea manuală activează întâi mediul virtual. - Suprascrii la Desktop fișierul
extra_models_config.yamlgenerat la instalare. Documentația cere să adaugi căile noi în fișierul existent, după o copie de siguranță. - Pornești cu
--listenpe 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: nivelulnormal-blochează funcțiile de risc mare când adresa din--listennu începe cu127., iar în Desktop un nivel mai strict contează mai ales când ComfyUI e expus în rețea.