इंस्टॉल न हो तो क्या करें: इंस्टॉलेशन और स्टार्टअप समस्या-निवारण
ComfyUI इंस्टॉल करते समय सबसे निराशाजनक क्षण धीमा डाउनलोड नहीं, बल्कि इंस्टॉल के बाद है: .bat पर डबल-क्लिक करने पर काली विंडो एक पल में गायब, या सर्विस चालू हो जाती है पर ब्राउज़र खाली सफ़ेद। ComfyUI न खुलने की समस्या अधिकांशतः तीन जगह अटकती है——ग्राफिक्स वातावरण गलत, सर्विस वास्तव में चालू नहीं, या ब्राउज़र की समस्या। यह पाठ इंस्टॉलेशन और स्टार्टअप चरण की सामान्य त्रुटियों को 「मूल पाठ」 के अनुसार एक-एक करके कारण और समाधान देता है: पहले 60 सेकंड की त्वरित जाँच से चरण पहचानें, फिर अपनी समस्या से मिलाएँ।
समाधान और कमांड सभी आधिकारिक समस्या-निवारण दस्तावेज़, आधिकारिक पोर्टेबल पैकेज स्क्रिप्ट और आधिकारिक रिपॉज़िटरी से हैं; त्रुटियों का मूल पाठ आधिकारिक दस्तावेज़ या ComfyUI आधिकारिक रिपॉज़िटरी के सार्वजनिक issue शीर्षकों से है। छवि जनरेशन चरण की त्रुटियाँ (लाल नोड, VRAM की कमी) इस पाठ के दायरे में नहीं हैं, उनके लिए समस्या-निवारण अवलोकन देखें।
सीखने के बाद आप क्या कर सकते हैं
- 4 कमांड से 60 सेकंड में पता लगाएँ: ग्राफिक्स कार्ड, PyTorch, Python में से कौन-सा चरण खराब है
- ComfyUI स्टार्टअप विफलता का सही वर्गीकरण करें: काली विंडो एक पल में गायब, CUDA त्रुटि, Linux लाइब्रेरी अनुपस्थित——हर एक का कारण और सुधार
- ComfyUI न खुलने की तीन इंटरफ़ेस समस्याएँ हल करें:
127.0.0.1:8188से कनेक्शन न बनना, व्हाइट/गड़बड़ स्क्रीन, ब्लैक स्क्रीन क्रैश - डेस्कटॉप संस्करण शुरू न होना संभालें: सुरक्षा रोक, अपडेट लूप, असमर्थित ग्राफिक्स कार्ड, और आधिकारिक लॉग फ़ाइल
app.logखोजें - आधिकारिक तरीके से प्रश्न पूछना सीखें: छह सिस्टम जानकारी और पूरी त्रुटि का मूल पाठ लेकर GitHub Issues पर जाएँ
आपकी वर्तमान दुविधा
.batपर डबल-क्लिक, काली विंडो एक पल में गायब, त्रुटि तक ठीक से दिखी नहीं, ComfyUI स्टार्टअप बिना किसी सुराग के विफल- काली विंडो में साफ़ ढेर सारे लॉग लुढ़के, पर ब्राउज़र
127.0.0.1:8188नहीं खोलता, या इंटरफ़ेस एक बार काला एक बार सफ़ेद - त्रुटियों की एक लंबी अंग्रेज़ी कतार (
Torch not compiled with CUDA enabled?), कॉपी करके खोजा तो जवाब तरह-तरह के और आपस में विरोधाभासी
यह तरीका कब अपनाएँ
जब आपको चाहिए:
- इंस्टॉलेशन: Windows पोर्टेबल पैकेज या वैकल्पिक इंस्टॉलेशन में अटके इंस्टॉलेशन, स्टार्टअप की समस्याएँ ठीक करना
- मदद माँगने से पहले खुद पहचानना: फ़ाइल सही नहीं लगी, वातावरण गलत है, सर्विस चालू नहीं, या ब्राउज़र का दोष है
और आप नहीं चाहते:
- त्रुटि आते ही फ़ोरम पर जवाब का इंतज़ार——60 सेकंड की त्वरित जाँच ज़्यादातर आगे-पीछे बचा सकती है
- 「ब्राउज़र अपग्रेड होना चाहिए」 को 「ComfyUI गलत इंस्टॉल हुआ」 समझकर व्यर्थ में दोबारा इंस्टॉल करना
🎒 शुरू करने से पहले की तैयारी
- इंस्टॉलेशन: Windows पोर्टेबल पैकेज या वैकल्पिक इंस्टॉलेशन से गुज़रे हों (बीच में अटकना कोई बात नहीं, यही पाठ अटकन हटाने के लिए है)
- ComfyUI शुरू करने वाली उस काली कमांड-लाइन विंडो (पोर्टेबल पैकेज / मैनुअल इंस्टॉलेशन) या Comfy Desktop ऐप (डेस्कटॉप संस्करण) खोज सकते हों
- डेस्कटॉप संस्करण उपयोगकर्ता: यह जानते हों कि ऊपर बाएँ ☰ मेन्यू से Desktop Settings खुलता है
- एक कप पानी ☕
💡 डेस्कटॉप संस्करण उपयोगकर्ता यहाँ देखें
Comfy Desktop Python वातावरण और डिपेंडेंसीज़ संभालता है, इस पेज की Python / pip संबंधी समस्या-निवारण मुख्य रूप से पोर्टेबल पैकेज और मैनुअल इंस्टॉलेशन उपयोगकर्ताओं के लिए है। डेस्कटॉप संस्करण शुरू न हो तो पहले समूह 4 देखें; लॉग चाहिए तो सीधे 「फिर भी नहीं होता?」 पर जाएँ——आधिकारिक app.log की जगह वहीं है।
मूल विचार
**ComfyUI एक 「लोकल सर्विस + वेब इंटरफ़ेस」 दो-परत संरचना है। ** काली कमांड-लाइन विंडो (या डेस्कटॉप संस्करण द्वारा चालू इंस्टेंस) सर्विस का मूल रूप है, और ब्राउज़र द्वारा http://127.0.0.1:8188 तक पहुँचना केवल उसका वेबपेज देखना है। इसलिए 「ComfyUI नहीं खुलता」 को दो सवालों में तोड़ें: सर्विस चालू हुई? ब्राउज़र जुड़ सका?——समस्या-निवारण पहले परत के अनुसार, फिर त्रुटि देखकर।
| आपके लक्षण | कौन-सी परत में अटके | कौन-सा समूह देखें |
|---|---|---|
| 7z अनज़िप विफल, डाउनलोड अटक जाता है | फ़ाइलें ही जगह पर नहीं पहुँचीं | समूह 5 |
| काली खिड़की एक पल के लिए दिखकर गायब / त्रुटि देकर बाहर निकल जाती है | सेवा शुरू नहीं होती (ड्राइवर, PyTorch) | समूह 1, 3 |
खिड़की मौजूद है, लेकिन To see the GUI वाली पंक्ति कभी नहीं आती | सेवा शुरू होने के दौरान बाधित | समूह 1 |
To see the GUI पंक्ति मौजूद है, लेकिन ब्राउज़र नहीं खुलता | सेवा ↔ ब्राउज़र के बीच | समूह 2 |
| इंटरफ़ेस सफ़ेद स्क्रीन, खराब स्क्रीन, काली स्क्रीन | फ्रंटएंड / ब्राउज़र | समूह 2 |
| डेस्कटॉप संस्करण नहीं खुलता, अपडेट के बाद अपने-आप बाहर निकल जाता है | डेस्कटॉप ऐप स्वयं | समूह 4 |
दो आधिकारिक "हर समस्या का हल" पहले क़दम। आधिकारिक ट्रबलशूटिंग दस्तावेज़ "ComfyUI शुरू नहीं होता" के लिए पहले दो त्वरित सुधार सूचीबद्ध करता है: न्यूनतम सिस्टम आवश्यकताएँ जाँचना, और GPU ड्राइवर को नवीनतम में अपडेट करना। आधिकारिक पोर्टेबल पैक README में भी एक सीधी बात लिखी है: अगर शुरू नहीं होता तो अपना NVIDIA ड्राइवर अपडेट करें। पहले ये दो काम करने से इंस्टॉलेशन के दौरान की त्रुटियों का एक बड़ा हिस्सा ख़त्म हो जाता है।
त्रुटि का मूल पाठ सबसे अच्छा खोज शब्द है। काली खिड़की की आख़िरी कुछ पंक्तियाँ, app.log का आख़िरी हिस्सा—वही आपको चाहिए—इसे नीचे दिए गए H4 शीर्षकों से मिलाएँ, या सीधे कॉपी करके GitHub Issues में खोजें।
पहली जाँच: 60 सेकंड की त्वरित जाँच
चार कमांड क्रम से चलाएँ (टर्मिनल / कमांड लाइन में)। पोर्टेबल पैक उपयोगकर्ता ध्यान दें: साथ आया Python सिस्टम PATH में नहीं होता, कमांड में python की जगह .\python_embeded\python.exe लिखें (पहले cd से ComfyUI_windows_portable फ़ोल्डर में जाएँ), टिप्पणी में उदाहरण दिया गया है।
# 1. NVIDIA 显卡被识别吗?——应该看到显卡型号和驱动版本(AMD / Intel / Apple Silicon 用户跳过)
nvidia-smi
# 2. PyTorch 认得你的 GPU 吗?——应该看到 True
python -c "import torch; print(torch.cuda.is_available())"
# Windows 便携包用户改用下面这条
# .\python_embeded\python.exe -c "import torch; print(torch.cuda.is_available())"
# 3. 版本号(报 bug 时官方要这两项)
python -c "import torch; print(torch.__version__)"
python --version
# 便携包用户同上替换 python;官方便携包当前自带 Python 3.13 与 CUDA 13.0 版 PyTorchआपको यह दिखना चाहिए: पहली 1 कमांड ग्राफ़िक्स कार्ड की जानकारी की एक तालिका प्रिंट करती है; दूसरी 2 कमांड True प्रिंट करती है; तीसरी 3 कमांड PyTorch और Python के संस्करण नंबर प्रिंट करती है।
जो कमांड टूटी है वहीं से ठीक करें: पहली 1 कमांड त्रुटि दे या कमांड न मिले → ड्राइवर की समस्या (समूह 3); दूसरी 2 कमांड False प्रिंट करे → PyTorch वातावरण (समूह 3); दोनों सामान्य हों लेकिन सेवा शुरू न हो → समूह 1; सेवा सामान्य हो लेकिन इंटरफ़ेस न खुले → समूह 2।
सामान्य समस्याओं की जाँच
शुरू होने में विफलता: प्रोग्राम शुरू नहीं होता (ComfyUI स्टार्टअप विफलता)
.bat पर डबल-क्लिक करने के बाद काली खिड़की एक पल को दिखकर गायब, ComfyUI शुरू नहीं हुआ
कारण: स्टार्टअप स्क्रिप्ट ComfyUI को चला नहीं पाई—सबसे आम कारण ग्राफ़िक्स ड्राइवर पुराना होना या रनटाइम लाइब्रेरी का अभाव है। आधिकारिक तौर पर run_nvidia_gpu.bat में सीधे एक संकेत लिखा गया है, मूल पाठ है:
If you see this and ComfyUI did not start try updating your Nvidia Drivers to the latest.
If you get a c10.dll error you need to install vc redist that you can find: https://aka.ms/vc14/vc_redist.x64.exeसमाधान:
- पहले NVIDIA ड्राइवर को नवीनतम में अपडेट करें (आधिकारिक पोर्टेबल पैक README के मूल शब्द: Update your Nvidia drivers if it doesn't start), फिर
.batपर डबल-क्लिक करें c10.dllत्रुटि आए: माइक्रोसॉफ़्ट VC++ रनटाइम लाइब्रेरी इंस्टॉल करें, आधिकारिक दिया गया पता https://aka.ms/vc14/vc_redist.x64.exe है, इंस्टॉल करके दोबारा कोशिश करें- जाँचें कि पैक सही डाउनलोड हुआ है या नहीं: RTX 20 सीरीज़ और उससे ऊपर के लिए स्टैंडर्ड पैक ज़रूरी है,
cu126पैक केवल GTX 10 सीरीज़ और उससे पुराने के लिए है (देखें समूह 5 "ग़लत इंस्टॉलर पैक डाउनलोड होना") - फिर भी न चले:
run_cpu.batपर डबल-क्लिक करके CPU मोड में एक बार कोशिश करें—आधिकारिक विवरण के अनुसार CPU मोड किसी भी हार्डवेयर पर चल सकता है, लेकिन यहबहुत धीमा होता है (आधिकारिक तौर पर इसे केवल अंतिम उपाय बताया गया है, यहाँ केवल जाँच-पुष्टि के लिए है)। अगर चल जाए, तो समस्या GPU वातावरण तक सीमित हो जाती है, समूह 3 पर जाएँ
आपको यह दिखना चाहिए: ड्राइवर अपडेट करने के बाद .bat पर दोबारा डबल-क्लिक करने पर काली खिड़की स्थिर रहती है और लॉग स्क्रॉल होते हैं, अंत में To see the GUI go to: http://127.0.0.1:8188 दिखता है।
"Torch not compiled with CUDA enabled"
कारण: PyTorch CPU संस्करण के रूप में इंस्टॉल हुआ या ग्राफ़िक्स कार्ड से बेमेल संस्करण—ComfyUI CUDA का उपयोग करना चाहता है लेकिन इस torch में CUDA समर्थन संकलित नहीं है। मैनुअल इंस्टॉलेशन उपयोगकर्ताओं में सबसे आम; आधिकारिक रिपॉज़िटरी के issue क्षेत्र में इसी त्रुटि का पूरा रूप AssertionError: Torch not compiled with CUDA enabled है।
समाधान:
- पहले अनइंस्टॉल करें, फिर ग्राफ़िक्स कार्ड के अनुसार दोबारा इंस्टॉल करें (आधिकारिक README ट्रबलशूटिंग मद):
pip uninstall torch
# NVIDIA 稳定版(CUDA 13.0)
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130- सत्यापित करें (त्वरित जाँच की दूसरी 2 कमांड):
python -c "import torch; print(torch.cuda.is_available())"Trueप्रिंट करे तभी ठीक मानें - Intel ग्राफ़िक्स उपयोगकर्ता ध्यान दें: Intel पर यह त्रुटि बिल्कुल अलग बात है—XPU बैकएंड उपलब्ध नहीं, ComfyUI इसे ग़लती से CUDA कार्ड समझता है। ऊपर दिए गए CUDA पुनर्इंस्टॉल चरणों को जस-का-तस न अपनाएँ, पहले आधिकारिक जाँच कमांड चलाएँ:
python -c "import torch; print('XPU available:', hasattr(torch, 'xpu') and torch.xpu.is_available())"अगर False प्रिंट हो तो XPU बिल्ड वाला PyTorch इंस्टॉल करें (आधिकारिक मूल कमांड), आधिकारिक तौर पर स्पष्ट चेतावनी है कि Intel पर CUDA संस्करण की wheel न इंस्टॉल करें:
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu- पोर्टेबल पैक उपयोगकर्ता: पैक में मेल खाता PyTorch पहले से आता है, आमतौर पर यह त्रुटि नहीं मिलती; मिले तो इसका मतलब है कि वातावरण बदला गया है,
update\update_comfyui_and_python_dependencies.batपर विचार करें (आधिकारिक तौर पर केवल निर्भरता की समस्या होने पर उपयोग हेतु चिह्नित, चलाने से पहले पूरी इंस्टॉल डायरेक्टरी का बैकअप लें)
"cuDNN Frontend error: No valid execution plans built"
कारण: Blackwell आर्किटेक्चर (RTX 50 सीरीज़) ग्राफ़िक्स कार्ड पर PyTorch का डिफ़ॉल्ट SDPA ध्यान cuDNN बैकएंड चुन सकता है, और इस आर्किटेक्चर के लिए कोई मान्य निष्पादन योजना नहीं है। आधिकारिक विवरण: FLUX चलाते समय UNet के पहले ध्यान ब्लॉक पर ही यह आ जाता है, एक भी तस्वीर नहीं बनती।
समाधान:
- स्टार्टअप पर हाथ से लिखा ध्यान कार्यान्वयन सक्षम करें, SDPA और cuDNN को बायपास करते हुए (आधिकारिक तौर पर इसे भरोसेमंद सुधार कहा गया है):
python main.py --use-split-cross-attention- साथ ही PyTorch बिल्ड की पुष्टि करें: आधिकारिक तौर पर नोट किया गया है कि Blackwell को CUDA 12.8 या उससे ऊपर के बिल्ड की ज़रूरत है,
cu121बिल्ड इन कार्ड परबिल्कुल नहीं चलता—CUDA 12.8+ / cu130 बिल्ड पर स्विच करें
💡 घुमावदार रास्ते न अपनाएँ
आधिकारिक तौर पर स्पष्ट कहा गया है: शुरू करने से पहले sitecustomize.py में torch.backends.cuda.enable_cudnn_sdp(False) से cuDNN बैकएंड बंद करनाकाम नहीं करता—यह फ़्लैग CUDA इनिशियलाइज़ेशन के समय सुरक्षित नहीं रहता। स्टार्टअप पैरामीटर ही भरोसेमंद सुधार है।
"libcuda.so.1: cannot open shared object file"
कारण: Linux पर PyTorch NVIDIA लाइब्रेरीज़ को site-packages/nvidia/ में इंस्टॉल करता है, सिस्टम डिफ़ॉल्ट रूप से वहाँ खोजने नहीं जाता। आधिकारिक तौर पर libcuda.so.1, libnccl.so, libnvinfer.so.X तीनों एक जैसी त्रुटियों को एक ही श्रेणी के LD_LIBRARY_PATH लक्षण के रूप में सूचीबद्ध करता है।
समाधान:
- लाइब्रेरी पथ को वातावरण चर में जोड़ें (वर्चुअल वातावरण उपयोगकर्ता,
python3.12को अपने संस्करण से बदलना न भूलें):
export LD_LIBRARY_PATH=$VIRTUAL_ENV/lib/python3.12/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH
# conda 环境改用 $CONDA_PREFIX/lib/python3.12/site-packages/nvidia/nvjitlink/lib- पथ हाथ से लिखना न चाहें, तो Python को site-packages स्वयं खोजने दें (आधिकारिक मूल कमांड):
PYTHON_PATH=$(python -c "import site; print(site.getsitepackages()[0])")
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH
# 可能还需要其他 NVIDIA 库目录
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cuda_runtime/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cublas/lib:$LD_LIBRARY_PATH- एक बार में हमेशा के लिए सुलझाना चाहते हैं: वर्चुअल एनवायरनमेंट के
activateस्क्रिप्ट या~/.bashrcमें जोड़ें (आधिकारिक रूप से दो तरीके दिए गए हैं) - सत्यापित करें:
python -c "import torch; print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda)"
आपको यह दिखना चाहिए: चरण 4 CUDA available: True और CUDA संस्करण संख्या प्रिंट करता है, फिर python main.py सामान्य रूप से शुरू होता है।
ComfyUI नहीं खुलता: 127.0.0.1:8188, ब्लैक स्क्रीन और व्हाइट स्क्रीन
"Failed to connect to server"
कारण: सेवा और ब्राउज़र के बीच कनेक्शन टूट गया है। आधिकारिक Connection Issues में चार जाँचें दी गई हैं: फ़ायरवॉल, पोर्ट, VPN, प्रॉक्सी; साथ ही सबसे आम पाँचवाँ कारण—सेवा बिल्कुल शुरू ही नहीं हुई।
समाधान:
- पहले देखें कि ब्लैक विंडो में यह पंक्ति है या नहीं—
To see the GUI go to: http://127.0.0.1:8188। यह पंक्ति नहीं है तो सेवा शुरू नहीं हुई, समूह 1 पर लौटें - यह पंक्ति है लेकिन ब्राउज़र अपने आप नहीं खुला: यह खराबी नहीं है—आधिकारिक दस्तावेज़ के अनुसार आमतौर पर अपने आप खुलना चाहिए, अगर अपने आप नहीं खुलता तो स्वयं ब्राउज़र खोलकर
http://127.0.0.1:8188पर जाएँ - पोर्ट बदलकर दोबारा कोशिश करें (डिफ़ॉल्ट 8188, आधिकारिक रूप से 8189 या 8190 आज़माने की सलाह दी गई है)। पोर्टेबल पैकेज उपयोगकर्ता नोटपैड से
.batमें पैरामीटर जोड़ें (आधिकारिक रूप से.batमें स्टार्टअप पैरामीटर जोड़ने का तरीका प्रदर्शित किया गया है):
.\python_embeded\python.exe -s ComfyUI\main.py --port 8189 --windows-standalone-build
pauseमैनुअल इंस्टॉलेशन उपयोगकर्ता सीधे: python main.py --port 8189।
- आधिकारिक चेकलिस्ट से एक बार जाँच लें: फ़ायरवॉल में ComfyUI को अनुमति दें, VPN अस्थायी रूप से बंद करें, प्रॉक्सी की ज़रूरत नहीं है तो प्रॉक्सी बंद कर दें
--listenसे लैन एक्सेस चालू किया हो तो ध्यान दें: लॉग मेंTo see the GUI go to: http://0.0.0.0:8188दिखेगा, अन्य डिवाइस को आपके लोकल IP से एक्सेस करना होगा (Win + R→cmd→ipconfigसे देखें),127.0.0.1का अर्थ है "यही मशीन", फ़ोन पर यह आपके कंप्यूटर का नहीं है
आपको यह दिखना चाहिए: ब्राउज़र http://127.0.0.1:8188 (या नया पोर्ट) खोलता है, और नोड कैनवास दिखता है।
इंटरफ़ेस व्हाइट स्क्रीन, गड़बड़ डिस्प्ले या असामान्य प्रदर्शन
कारण: ब्राउज़र बहुत पुराना है। आधिकारिक सिस्टम आवश्यकताओं में स्पष्ट लिखा है: Chrome 142 और उससे नीचे के संस्करणों में ज्ञात समस्याएँ हैं, जिससे इंटरफ़ेस असामान्य दिखता है और परफ़ॉर्मेंस समस्याएँ होती हैं। GitHub issue क्षेत्र में भी व्हाइट स्क्रीन से जुड़ी सार्वजनिक रिपोर्टें हैं (जैसे White screen wen loading Comfyui)।
समाधान:
- Chrome को 143 या उससे ऊँचे संस्करण में अपग्रेड करके खोलें (आधिकारिक आवश्यकता के मूल शब्द)
- ब्राउज़र बदलने पर भी व्हाइट स्क्रीन: "फिर भी नहीं चल रहा?" के अनुसार ब्राउज़र कंसोल की एरर इकट्ठा करें (F12 → Console), फिर GitHub Issues में खोजें
आपको यह दिखना चाहिए: अपग्रेड के बाद http://127.0.0.1:8188 नोड कैनवास सामान्य रूप से रेंडर करता है।
स्टार्टअप पर ब्लैक स्क्रीन या सीधे क्रैश (ComfyUI ब्लैक स्क्रीन)
कारण: आधिकारिक रूप से "स्टार्टअप क्रैश, ब्लैक स्क्रीन, लोड विफलता" को एक ही "ComfyUI Won't Start" लक्षण श्रेणी में रखा गया है, और दिए गए क्विक फ़िक्स सिर्फ़ दो हैं: न्यूनतम सिस्टम आवश्यकताएँ जाँचें + GPU ड्राइवर अपडेट करें।
समाधान:
- सिस्टम आवश्यकताएँ जाँचें: पिछले पाठ की ग्राफ़िक्स कार्ड आवश्यकता त्वरित सारणी से मिलाएँ, पुष्टि करें कि ग्राफ़िक्स कार्ड समर्थित सूची में है (NVIDIA / AMD / Intel Arc / Apple Silicon), डेडिकेटेड GPU नहीं है तो CPU मोड अपनाएँ
- GPU ड्राइवर अपडेट करें (NVIDIA / AMD / Intel की आधिकारिक वेबसाइट, यह आधिकारिक दूसरा क्विक फ़िक्स है)
- पोर्टेबल पैकेज उपयोगकर्ता
run_cpu.batडबल-क्लिक करें (मैनुअल इंस्टॉलेशन में--cpuजोड़कर चलाएँ) और दोबारा कोशिश करें: CPU मोड किसी भी हार्डवेयर पर चल जाता है, लेकिन बहुत धीमा है—चल जाए तो GPU एनवायरनमेंट की समस्या है, समूह 3 पर जाकर आगे जाँचें - macOS उपयोगकर्ता: MPS में समस्या होने पर आधिकारिक रूप से इसी तरह CPU विकल्प
python main.py --cpuदिया गया है (मेमोरी ऑप्टिमाइज़ेशन के साथ--force-fp16 --cpuउपयोग किया जा सकता है)
आपको यह दिखना चाहिए: ड्राइवर अपडेट (या CPU मोड) के बाद, सेवा पूरी तरह To see the GUI go to: http://127.0.0.1:8188 तक शुरू होती है, और इंटरफ़ेस अब ब्लैक स्क्रीन नहीं होता।
"Frontend or Templates Package Not Updated"
कारण: git pull से ComfyUI कोड अपडेट किया गया, लेकिन मुख्य डिपेंडेंसीज़ साथ नहीं चल पाईं — फ्रंटएंड, वर्कफ़्लो टेम्पलेट और नोड डॉक्युमेंटेशन अलग-अलग pip पैकेज हैं। डिपेंडेंसी अपडेट विफल होने पर पुराना वर्ज़न फ़ॉलबैक हो जाता है, और स्टार्टअप लॉग में Falling back to the default frontend. दिखाई देता है।
समाधान:
- ComfyUI के Python एनवायरनमेंट में डिपेंडेंसीज़ पूरी करके इंस्टॉल करें (आधिकारिक समाधान):
pip install -r requirements.txt- चीन के नेटवर्क पर Tsinghua मिरर जोड़ें (आधिकारिक रूप से दिया गया):
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple- फिर भी विफल: पहले
pip listसे संस्करणों की तुलना करें, फिरComfyUI/requirements.txtमें लिखे संस्करण नंबर के अनुसार एक-एक करके इंस्टॉल करें (आधिकारिक चेतावनी: अपनी मर्ज़ी से नवीनतम संस्करण पर न बढ़ें):
pip install comfyui-frontend-package==<版本号>
pip install comfyui-workflow-templates==<版本号>- अनुमति कम हो: एडमिनिस्ट्रेटर अनुमति से कमांड लाइन चलाएँ (आधिकारिक ट्रबलशूटिंग चरणों में से एक)
आपको यह दिखना चाहिए: डिपेंडेंसीज़ इंस्टॉल होने के बाद, स्टार्टअप लॉग में Falling back to the default frontend. नहीं दिखता, और इंटरफ़ेस की सुविधाएँ पूरी रहती हैं।
ग्राफ़िक्स कार्ड और ड्राइवर समस्याएँ
"CUDA error: no kernel image is available for execution on the device"
कारण: PyTorch के CUDA बिल्ड में आपके ग्राफ़िक्स कार्ड आर्किटेक्चर के लिए कर्नेल कंपाइल नहीं किया गया—बिल्ड और कार्ड मेल नहीं खाते। विशिष्ट स्थिति: नया कार्ड पुराने बिल्ड के साथ (जैसे Blackwell के साथ cu121), या पुराना कार्ड बहुत नए बिल्ड के साथ।
समाधान:
- आधिकारिक तालिका के अनुसार सही पैकेज / बिल्ड बदलें:
| ग्राफ़िक्स कार्ड | उपयोग करने योग्य |
|---|---|
| RTX 20 सीरीज़ और ऊपर | स्टैंडर्ड पैकेज / बिल्ड (CUDA 13.0) |
| GTX 10 सीरीज़ और उससे पुराने | cu126 पैकेज (CUDA 12.6, Python 3.12) |
| RTX 50 सीरीज़ (Blackwell) | CUDA 12.8 और ऊपर के बिल्ड (आधिकारिक: cu121 बिल्ड बिल्कुल नहीं चलता) |
- पोर्टेबल पैकेज उपयोगकर्ता: गलत डाउनलोड किया पैकेज हटाएँ, पिछले पाठ की पैकेज चयन सारणी के अनुसार दोबारा डाउनलोड करके निकालें
- मैनुअल इंस्टॉलेशन उपयोगकर्ता:
pip uninstall torchके बाद संगत संस्करण इंस्टॉल करें, फिरpython -c "import torch; print(torch.cuda.is_available())"से सत्यापित करें
"HIP error: invalid device function when running ComfyUI"
कारण: AMD ग्राफ़िक्स कार्ड का आर्किटेक्चर प्रयुक्त ROCm बिल्ड की समर्थित सूची में नहीं है। आधिकारिक दस्तावेज़ में "असमर्थित AMD कार्ड" के लिए अलग से एनवायरनमेंट वेरिएबल ओवरराइड समाधान दिया गया है।
समाधान (आर्किटेक्चर के अनुसार एक चुनें, आधिकारिक मूल कमांड):
# RDNA2 或更旧(如 6700、6600)
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
# RDNA3(如 7600)
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.pyसाथ ही पुष्टि करें कि PyTorch का स्रोत सही है—Linux AMD के लिए ROCm स्टेबल संस्करण उपयोग करें:
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2"My GPU is not detected"
कारण: डेस्कटॉप संस्करण GPU नहीं ढूँढ पाया—ड्राइवर बहुत पुराना, Linux में CUDA टूलचेन नहीं है, या इंस्टॉलेशन प्रकार ही लोकल GPU का उपयोग नहीं करता (आधिकारिक FAQ में दी गई तीन स्थितियाँ)।
समाधान:
- NVIDIA ड्राइवर अपडेट करें
- Linux उपयोगकर्ता पुष्टि करें कि CUDA toolkit इंस्टॉल है
- पुष्टि करें कि इंस्टॉलेशन प्रकार GPU का समर्थन करता है: Standalone और Git Clone समर्थित हैं; Cloud कनेक्शन रिमोट GPU का उपयोग करता है
- कमांड लाइन से सत्यापन (त्वरित जांच के 1 नंबर वाले बिंदु का विस्तारित संस्करण, आधिकारिक मूल कमांड):
nvidia-smi
nvidia-smi --query-gpu=driver_version --format=csvआपको यह दिखना चाहिए: nvidia-smi ग्राफिक्स कार्ड मॉडल और ड्राइवर संस्करण प्रिंट करता है; डेस्कटॉप संस्करण GPU को सामान्य रूप से पहचान और उपयोग कर पाता है।
Comfy Desktop डेस्कटॉप संस्करण की समस्याएं
"The app won't start after installation"
कारण: प्लेटफ़ॉर्म-संबंधी स्टार्टअप अवरोध — अनुमतियां, सुरक्षा सेटिंग्स या लाइब्रेरी की कमी। आधिकारिक FAQ ने प्लेटफ़ॉर्म के अनुसार चार उपाय दिए हैं।
समाधान:
- Windows: एक बार एडमिनिस्ट्रेटर के रूप में चलाएं
- macOS: सुरक्षा चेतावनी आने पर, सिस्टम सेटिंग्स → प्राइवेसी और सुरक्षा में जाकर फिर भी खोलें (Open Anyway) पर क्लिक करें
- Linux: पुष्टि करें कि FUSE 2 (
sudo apt install libfuse2) इंस्टॉल है; यदि Ubuntu 24.04+ का AppArmor Electron सैंडबॉक्स रोक रहा है, तो--no-sandboxजोड़कर पुनः प्रयास करें — ⚠️ आधिकारिक चेतावनी: यह पैरामीटर हर प्रोसेस का Electron सैंडबॉक्स अक्षम कर देता है, केवल सैंडबॉक्स स्टार्टअप विफल होने पर ही उपयोग करें - डाउनलोड पेज पर जाकर पुष्टि करें कि आपको नवीनतम संस्करण मिला है
आपको यह दिखना चाहिए: प्लेटफ़ॉर्म के अनुसार उपाय करने पर, Comfy Desktop विंडो खुल जाती है और डैशबोर्ड या प्रथम सेटअप में प्रवेश होता है।
"App is damaged"
कारण: macOS की सुरक्षा प्रणाली ने ऐप को "क्षतिग्रस्त" चिह्नित किया है। आधिकारिक macOS ट्रबलशूटिंग सूची का पहला आइटम यही है।
समाधान: सिस्टम सेटिंग्स → प्राइवेसी और सुरक्षा में जाकर इस ऐप को अनुमति दें। उसी पेज के आधिकारिक आइटम में यह भी है: परफ़ॉर्मेंस समस्याओं के लिए पूर्ण डिस्क एक्सेस प्रदान करें; क्रैश होने पर "कंसोल" ऐप में क्रैश रिपोर्ट देखें।
"Comfy Desktop closes by itself after an update (Windows)"
कारण: आधिकारिक रूप से पुष्ट किया गया बग — 1.0.46 और उससे पुराने Windows संस्करणों में, अपडेट डाउनलोड पूरा न होने पर ऐप अपडेट इंटरफ़ेस एक पल दिखाकर अपने आप बंद हो जाता है, और हर स्टार्टअप पर यह दोहराता है, स्वयं-मरम्मत का मौका ही नहीं मिलता। 1.0.47 से ठीक कर दिया गया है।
समाधान: नवीनतम संस्करण मैन्युअल रूप से इंस्टॉल करें (आधिकारिक रिकवरी चरण):
- नवीनतम Windows इंस्टॉलर डाउनलोड करें (या डाउनलोड पेज से प्राप्त करें)
- इंस्टॉलर सीधे चलाएं, पुराना संस्करण पहले अनइंस्टॉल करने की आवश्यकता नहीं है
- Comfy Desktop लॉन्च करें
आपको यह दिखना चाहिए: ऐप सामान्य रूप से खुलता है और अपने आप बंद नहीं होता — आपका इंस्टॉलेशन इंस्टेंस, मॉडल और सेटिंग्स सब सुरक्षित हैं (आधिकारिक पुष्टि: संरक्षित रहते हैं)।
"Unsupported device"
कारण: Windows संस्करण का Comfy Desktop केवल NVIDIA CUDA ग्राफिक्स कार्ड का समर्थन करता है — आधिकारिक ट्रबलशूटिंग दस्तावेज़ के मूल शब्द। AMD / Intel ग्राफिक्स कार्ड वाले उपयोगकर्ता Windows डेस्कटॉप संस्करण इंस्टॉल करने पर इससे मिलेंगे।
समाधान: AMD / Intel ग्राफिक्स कार्ड वाले Windows उपयोगकर्ता अन्य दो आधिकारिक मार्ग अपनाएं:
- आधिकारिक पोर्टेबल पैकेज: AMD पैकेज (
ComfyUI_windows_portable_amd.7z) या Intel पैकेज (ComfyUI_windows_portable_intel.7z), देखें पिछले पाठ की पैकेज चयन तालिका - मैन्युअल इंस्टॉलेशन (ग्राफिक्स कार्ड के अनुसार संगत PyTorch इंस्टॉल करें)
डाउनलोड विफलता, Maintenance पेज पर अटकना या डिस्क स्पेस की कमी का संदेश
कारण: डेस्कटॉप संस्करण को GitHub / PyPI से फ़ाइलें खींचनी पड़ती हैं, नेटवर्क या मिरर ठीक न होने पर अटक जाता है; नया इंस्टेंस बनाते समय डिस्क स्पेस की जांच भी अनिवार्य होती है।
समाधान:
- Maintenance पेज पर अटकना: आधिकारिक सलाह मिरर सेटिंग्स जांचें — चीनी इंटरफ़ेस में सेटिंग्स में Use Chinese Mirrors (Git & PyPI) चालू किया जा सकता है: Git रिपॉज़िटरी
gitcode.comसे होकर जाती हैं, PyPI अलीबाबा क्लाउड और टेंसेंट मिरर से, आधिकारिक विवरण के अनुसार यह मुख्यभूमि चीन में तेज़ है - Low Disk Space केवल एक चेतावनी है, Continue Anyway चुनकर जारी रख सकते हैं (या इंस्टॉलेशन पाथ बदलें); Not Enough Space for Template Models उस टेम्पलेट को रोक देगा — हल्का वर्कफ़्लो चुनें या डिस्क साफ़ करें
- इंस्टॉलर विफलता: आधिकारिक सलाह एडमिनिस्ट्रेटर के रूप में चलाना + कम से कम 15GB डिस्क स्पेस सुनिश्चित करना; डेस्कटॉप संस्करण के हर स्वतंत्र इंस्टॉलेशन के लिए आधिकारिक आवश्यकता कम से कम 4.85GB है
डाउनलोड और एक्सट्रैक्शन समस्याएं (ComfyUI इंस्टॉल नहीं हो रहा)
7z एक्सट्रैक्शन विफलता या एक्सट्रैक्शन के बाद फ़ाइलें अधूरीं
कारण: Windows इंटरनेट से डाउनलोड की गई फ़ाइलों पर "लॉक" चिह्न लगा देता है, जिससे एक्सट्रैक्शन में समस्या होती है। आधिकारिक README में इस पर एक विशेष वाक्य है: If you have trouble extracting it, right click the file -> properties -> unblock।
समाधान:
.7zफ़ाइल पर राइट-क्लिक → प्रॉपर्टीज़ → "अनब्लॉक (Unblock)" चेक करें → ठीक है, फिर से एक्सट्रैक्ट करें- फिर भी न हो: 7-Zip से एक्सट्रैक्ट करें (आधिकारिक रूप से यह भी बताया गया है कि नए Windows एक्सप्लोरर सीधे एक्सट्रैक्ट कर सकते हैं)
आपको यह दिखना चाहिए: पूर्ण ComfyUI_windows_portable फ़ोल्डर एक्सट्रैक्ट होता है, जिसमें run_nvidia_gpu.bat, python_embeded आदि मौजूद हैं।
ग़लत इंस्टॉलर डाउनलोड: नए कार्ड के लिए cu126 पैकेज डाउनलोड कर लिया (या इसका उलटा)
कारण: आधिकारिक रूप से ग्राफिक्स कार्ड के अनुसार कई पैकेज जारी किए गए हैं, चुनने में ग़लती केवल NVIDIA के दो पैकेजों में हो सकती है। cu126 पैकेज केवल GTX 10 सीरीज़ और उससे पुराने कार्डों के लिए है, आधिकारिक रूप से बड़े अक्षरों में ज़ोर दिया गया: DO NOT USE THIS ON NEWER 20 SERIES AND ABOVE GPUS।
समाधान: फ़ाइल नाम की जांच करके दोबारा डाउनलोड करें (पूर्ण तुलना तालिका देखें पिछला पाठ)):
| आपका ग्राफिक्स कार्ड | सही फ़ाइल नाम |
|---|---|
| RTX 20 सीरीज़ और उससे नए | ComfyUI_windows_portable_nvidia.7z |
| GTX 10 सीरीज़ और उससे पुराने | ComfyUI_windows_portable_nvidia_cu126.7z |
| AMD | ComfyUI_windows_portable_amd.7z |
| Intel | ComfyUI_windows_portable_intel.7z |
आपको यह देखना चाहिए: नए पैकेज को अनज़िप करने के बाद संबंधित .bat पर डबल-क्लिक करें, स्टार्टअप पर अब आर्किटेक्चर संबंधी त्रुटि नहीं आएगी।
डाउनलोड धीमा है या डाउनलोड विफल (चीनी नेटवर्क)
कारण: इंस्टॉल पैकेज GitHub Releases पर होस्ट किए गए हैं — आधिकारिक दस्तावेज़ में उल्लेख है कि चीनी मुख्यभूमि के उपयोगकर्ताओं को GitHub रिपॉज़िटरी तक स्थिर पहुंच के लिए प्रॉक्सी कॉन्फ़िगर करने की आवश्यकता हो सकती है। धीमा डाउनलोड होना आपकी गलती नहीं है।
समाधान:
- GitHub तक पहुंच के लिए प्रॉक्सी कॉन्फ़िगर करें (आधिकारिक समाधान)
- डेस्कटॉप संस्करण उपयोगकर्ता: चीनी मिरर चालू करें (Git
gitcode.comसे, PyPI अलीबाबा क्लाउड और टेंसेंट मिरर से, पिछली प्रविष्टि देखें) - मैन्युअल रूप से डिपेंडेंसी इंस्टॉल करते समय pip को त्सिंगहुआ मिरर पर स्विच करें (आधिकारिक रूप से दिया गया):
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple - पैकेज हमेशा आधिकारिक चैनलों से ही लें: GitHub Releases और comfy.org/download
फिर भी नहीं हो रहा?
पहले सबूत जुटाएं, फिर प्रश्न पूछें। आधिकारिक बग रिपोर्ट टेम्पलेट में कुल छह सिस्टम जानकारी मांगी जाती हैं, पहले उन्हें तैयार रखें:
| जानकारी आइटम | कैसे प्राप्त करें |
|---|---|
| ऑपरेटिंग सिस्टम | Windows: systeminfo | findstr /C:"OS Name" /C:"OS Version"; macOS/Linux: uname -a |
| ComfyUI संस्करण | इंटरफ़ेस के Settings → About पेज से |
| Python संस्करण | python --version |
| PyTorch संस्करण | python -c "import torch; print(f'PyTorch: {torch.__version__}')" |
| GPU मॉडल और ड्राइवर | Windows: wmic path win32_VideoController get name; Linux: lspci | grep VGA; ड्राइवर संस्करण nvidia-smi --query-gpu=driver_version --format=csv |
| इंस्टॉल विधि | Desktop / Portable / Manual / comfy-cli |
साथ में तीन चीज़ें और जोड़ें: कंसोल की पूरी त्रुटि का मूल पाठ, ब्राउज़र कंसोल की त्रुटियां (F12 → Console), और समस्या को पुनः उत्पन्न कर सकने वाला वर्कफ़्लो .json तथा कस्टम नोड की सूची।
डेस्कटॉप संस्करण उपयोगकर्ता पहले लॉग खोजें। Comfy Desktop रोलिंग लॉग app.log लिखता है, सबसे तेज़ रास्ता है Desktop Settings → Logs → Diagnostics → Open logs folder (☰ मेनू से सेटिंग्स में जाएं)। डिफ़ॉल्ट स्थान:
| प्लेटफ़ॉर्म | लॉग फ़ोल्डर |
|---|---|
| Windows | %APPDATA%\Comfy Desktop\logs |
| macOS | ~/Library/Logs/Comfy Desktop |
| Linux | ~/.config/Comfy Desktop/logs |
app.log देखें (पुराने सेशन टाइमस्टैम्प वाले app.log_*.log में हैं)। ComfyUI प्रोसेस का अपना आउटपुट देखने के लिए, इंस्टेंस का Manage पैनल खोलकर Terminal टैब का उपयोग करें।
कहां पूछें (आधिकारिक चैनलों की तुलना):
| चैनल | किस समस्या के लिए जाएं |
|---|---|
| ComfyUI GitHub Issues | ComfyUI कोर समस्याएं |
| Comfy-Desktop Issues | डेस्कटॉप संस्करण की समस्याएं |
| ComfyUI_frontend Issues | फ़्रंटएंड समस्याएं |
| कस्टम नोड के लेखक | custom node समस्याएं (आधिकारिक: उस विशिष्ट नोड के डेवलपर से संपर्क करें) |
| आधिकारिक फ़ोरम / Discord / r/comfyui | समुदाय से मदद |
💡 प्रश्न पूछने से पहले आधिकारिक रूप से सुझाई गई तीन चीज़ें
पहले GitHub Issues और फ़ोरम खोजें ताकि पक्का हो सके कि यह कोई ज्ञात समस्या नहीं है; डिफ़ॉल्ट वर्कफ़्लो से एक बार टेस्ट करें ताकि वर्कफ़्लो का कारक हट जाए; comfy-cli से इंस्टॉल किया है तो पहले comfy node update all चलाएं। जनरेशन चरण की त्रुटियों की जांच (कस्टम नोड, मॉडल लोडिंग, VRAM) ट्रबलशूटिंग ओवरव्यू से करें।
चेकपॉइंट ✅
- 60-सेकंड वाली चार कमांड मैंने चला ली हैं और मुझे पता है कि कौन सी गलत है
- काली विंडो झटपट बंद हो जाने पर मुझे क्रम पता है: पहले ग्राफ़िक्स ड्राइवर अपडेट करें → c10.dll की त्रुटि आए तो VC++ रनटाइम इंस्टॉल करें → जांचें कि सही पैकेज डाउनलोड हुआ है या नहीं
127.0.0.1:8188न खुलने पर मैं पहले यह पक्का करता हूं कि काली विंडो मेंTo see the GUIवाली पंक्ति है या नहीं, फिर फ़ायरवॉल / VPN / पोर्ट बदलने की जांच करता हूं- इंटरफ़ेस सफ़ेद या बिखरा हुआ दिखे तो मेरी पहली प्रतिक्रिया Chrome संस्करण जांचना है (143 या उससे नया)
- प्रश्न पूछते समय मैं छह सिस्टम जानकारी + पूरी त्रुटि का मूल पाठ +
app.log(डेस्कटॉप संस्करण) साथ रखूंगा
इस पाठ का सारांश
✅ ComfyUI न खुलने पर पहले परतों में बांटें: फ़ाइलें पूरी इंस्टॉल हुईं (समूह 5) → सेवा चल पाती है (समूह 1, 3) → ब्राउज़र जुड़ पाता है (समूह 2) → डेस्कटॉप संस्करण खुद सही है (समूह 4)।
✅ दो आधिकारिक सर्वकालीन उपाय: सिस्टम आवश्यकताएं जांचें + GPU ड्राइवर अपडेट करें, पहले ये दो काम करें फिर विस्तार से जांचें।
✅ प्रश्न पूछने का सही तरीका: छह सिस्टम जानकारी + त्रुटि का मूल पाठ + लॉग, और संबंधित आधिकारिक GitHub रिपॉज़िटरी या समुदाय में जाएं।
मुख्य संकेतों की समीक्षा:
| संकेत | किस परत में | पहला कदम |
|---|---|---|
| काली विंडो झटपट बंद | स्टार्टअप | ग्राफ़िक्स ड्राइवर अपडेट करें; c10.dll → VC++ रनटाइम इंस्टॉल करें |
Torch not compiled with CUDA enabled | PyTorch एनवायरनमेंट | torch को अनइंस्टॉल करें और अपने GPU के अनुसार दोबारा इंस्टॉल करें |
To see the GUI लाइनें हैं लेकिन नहीं खुल रहा | सर्विस ↔ ब्राउज़र | मैन्युअली एक्सेस करें; फ़ायरवॉल / VPN जाँचें / पोर्ट बदलें |
| सफ़ेद स्क्रीन, गड़बड़ स्क्रीन | ब्राउज़र | Chrome को 143+ पर अपग्रेड करें |
App is damaged | macOS सुरक्षा | प्राइवेसी और सिक्योरिटी में अनुमति दें |
| Maintenance पेज अटक गया | नेटवर्क | मिरर सेटिंग जाँचें / चाइनीज़ मिरर चालू करें |
अगले पाठ की झलक
एनवायरनमेंट स्थिर हो गया है, अगला कदम मॉडल कहाँ रखें: models डायरेक्टरी और extra_model_paths की पूरी जानकारी पर जाएँ।
आप सीखेंगे:
modelsडायरेक्टरी की पूरी संरचना और हर सब-डायरेक्टरी में क्या रखें- checkpoint, VAE, LoRA को सही जगह कैसे रखें
extra_model_paths.yamlका उपयोग करके कई इंस्टॉलेशन के बीच मॉडल साझा करें
जल्दी इमेज बनाना चाहने वाले पाठक मॉडल रखने के बाद सीधे पहली बार इमेज जनरेशन पर जाएँ।