Claude से टूटे ComfyUI वर्कफ़्लो को कैसे ठीक करें

सबसे पहले Claude से पूरा workflow दोबारा लिखने को न कहें। सामान्य save format वाला मूल JSON और सटीक error messages सुरक्षित रखें, फिर साबित करें कि custom nodes बंद होने पर मौजूदा default workflow चलता है। उसके बाद Claude को केवल उपलब्ध evidence classify करने दें। एक समय में एक dependency बदलें, सबसे छोटा चलने योग्य graph बनाएँ, एक image चलाएँ और स्वयं जाँचें कि output Save Image में आया, local file के रूप में save हुआ और दोबारा खुल रहा है।

इस तरीके से “ComfyUI बहुत बदल गया” जैसी अस्पष्ट समस्या चार-पाँच जाँच योग्य layers में टूट जाती है: ComfyUI core, frontend extensions, custom nodes, model files या पुराना graph। आधिकारिक ComfyUI troubleshooting guide भी fix लगाने से पहले default workflow test करने, custom nodes disable करने और terminal की सटीक error पढ़ने की सलाह देता है।

पूरी repair sequence एक नज़र में

1. मूल workflow को सामान्य save format में रखें और कभी overwrite न करें।
2. पूरा error report, startup log, install type, versions और हाल के बदलाव दर्ज करें।
3. सभी custom nodes बंद करके मौजूदा default image workflow चलाएँ।
4. Claude को सीमित evidence packet दें; edits या installs से पहले analysis हो।
5. failure को core, frontend, custom node, model या unknown में classify करें।
6. केवल एक incompatible node update/replace करें, या current minimal graph बनाएँ।
7. एक छोटी image चलाकर वास्तविक saved file verify करें।

1. कोई बदलाव करने से पहले workflow और evidence freeze करें

पुराने workflow को सामान्य JSON में save करें और उसकी अलग working copy बनाएँ। एक छोटा case folder investigation को दोहराने योग्य रखता है:

comfyui-repair-case/
  workflow-original.json
  workflow-working.json
  error-report.txt
  startup-log.txt
  environment.md

workflow-original.json को read-only मानें। error-report.txt में Show report का पूरा text रखें, “node टूट गया” जैसा सारांश नहीं। startup-log.txt में launch terminal के import failures, dependency conflicts और tracebacks रखें। environment.md में लिखें कि install Desktop, Portable या manual है; ComfyUI version, operating system, GPU, और हाल में core, frontend, custom nodes या models में क्या update हुआ।

Save format और API format को भी अलग रखें। आधिकारिक Workflow API Format page बताता है कि सामान्य saved workflow में node positions, colors, groups और editing metadata रहते हैं, जबकि API format programmatic submission के लिए छोटा representation है। Repair के लिए सामान्य save-format original रखें। API वास्तव में चाहिए तभी अलग API copy export करें।

2. पुराने graph से पहले clean ComfyUI baseline साबित करें

पुराना graph पहला test नहीं होना चाहिए। Third-party nodes अस्थायी रूप से बंद करें। Desktop में setting उपलब्ध है; manual install आम तौर पर इस तरह शुरू किया जा सकता है:

python main.py --disable-all-custom-nodes

मौजूदा default Image Generation template load करें, dropdown में पहले से दिख रहा compatible checkpoint चुनें और एक image generate करें। आधिकारिक custom-node troubleshooting guide उपयोगी separation देता है: custom nodes बंद करने पर समस्या गायब हो तो कोई custom node involved है; समस्या बनी रहे तो core, frontend, models या environment जाँचें।

Result के आधार पर अगली branch चुनें:

Baseline result	अधिक संभावित layer	अगला प्रमाण
Default workflow खुलता या चलता नहीं	Core install, frontend, model या hardware	पुराने graph से पहले baseline ठीक करें
Default चलता है, पुराना graph missing nodes दिखाता है	Missing, renamed या unloaded custom nodes	JSON node types को package owners से map करें
पुराना graph load होकर एक node पर fail होता है	Model architecture, links, dependencies या memory	पहला failing node और पूरा report बचाएँ
Frontend extensions बंद करने पर UI लौटता है	Incompatible third-party frontend extension	आधे-आधे enable करके एक extension isolate करें

अगर default graph ही fail हो रहा है, तो पुराने JSON को rewrite करना successful repair का प्रमाण नहीं है।

3. Claude को सीमित और सुरक्षित evidence packet दें

Anthropic के अनुसार Claude Code codebase पढ़ सकता है, files edit कर सकता है और commands चला सकता है। यही क्षमता उपयोगी भी है और जोखिम भी, इसलिए पहला pass analysis-only रखें। Claude को case folder में शुरू करें या वही files chat में attach करें और स्पष्ट constraints दें:

आप एक ComfyUI workflow diagnose कर रहे हैं जो update के बाद बंद हो गया।

केवल ये files पढ़ें:
- workflow-original.json
- workflow-working.json
- error-report.txt
- startup-log.txt
- environment.md

अभी कुछ install, update, delete, rename या edit न करें।
पहले:
1. Node types और referenced model files की inventory बनाएँ।
2. हर problem को ComfyUI core, frontend extension,
   custom node, model file या unknown में classify करें।
3. हर conclusion के साथ exact JSON field या error line quote करें।
4. सबसे छोटा reversible change propose करें।
5. workflow-working.json edit करने से पहले approval का इंतज़ार करें।

जब तक मैं एक image चला कर saved file confirm न करूँ, repair successful न कहें।

उपयोगी answer एक mapping table होगा: old node type, owning extension, input/output contract, possible replacement, parameter mapping, evidence और risk। Owner या replacement साबित न हो तो Claude को unknown लिखना चाहिए, समान नाम देखकर package guess नहीं करना चाहिए।

4. सब कुछ update करने के बजाय failure classify करें

Missing node: replacement से पहले owner पहचानें

सामान्य save JSON में missing node का type, title और links देखें। मिलते-जुलते नाम compatible sockets या widget values की गारंटी नहीं देते, इसलिए JSON string बदल देना safe migration नहीं है। पहले तय करें कि node core का है या किसी specific custom-node repository का, फिर old और new inputs, outputs और parameters compare करें।

Extension maintained है तो केवल उसी extension को update करके retest करें। Abandoned है तो maintained alternative चुनें या core nodes से उस छोटे function को rebuild करें। Official guide भी यही options देता है: node update करें, replace करें, author को report करें या remove/disable करें।

Frontend conflict: disable करें, फिर binary search

कुछ custom nodes frontend extensions भी inject करते हैं। Blank UI, broken links, missing previews या frontend/backend communication failure इस layer से आ सकते हैं। पहले third-party frontend extensions बंद करें। Symptom गायब हो तो आधे extensions enable करें और test दोहराएँ। यह binary search causality बचाती है और सब कुछ reinstall करने से सुरक्षित है।

Missing model: folders और search paths जाँचें

पुराना graph हटाए, renamed या moved checkpoint, VAE, LoRA या ControlNet को refer कर सकता है। ComfyUI models को ComfyUI/models/ की categorized folders और extra_model_paths.yaml में configured paths से खोजता है। Selector empty हो या null दिखाए तो वास्तविक location verify करें, फिर refresh या restart करें। पुराने filename से match कराने के लिए incompatible model का नाम न बदलें।

Architecture mismatch: filename नहीं, model family देखें

आधिकारिक model troubleshooting guide workflow models को एक ही architecture family में रखने की सलाह देता है। अलग families के checkpoint, VAE, text encoder या ControlNet मिलाने से sampling या VAE decode में tensor-shape errors आ सकते हैं। Claude stack trace और graph को correlate कर सकता है, लेकिन intended model family का official template बेहतर compatibility baseline है।

5. Working copy में केवल एक node बदलें

Edit approve करने से पहले Claude से change plan माँगें:

Item	अनिवार्य सवाल
Old node	JSON में exact type क्या है?
Owner	Core, custom node या frontend extension?
Replacement	Input और output types match करते हैं?
Parameter migration	कौन से widget values रह सकते हैं, किन्हें फिर बनाना होगा?
Rollback	पिछला workflow-working.json कैसे restore होगा?

केवल workflow-working.json में और एक समय में एक fault के लिए बदलाव approve करें। हर edit के बाद reload करके जाँचें कि node मौजूद है, links valid हैं और parameters shift नहीं हुए। “Update all custom nodes” दूसरा compatibility conflict बना सकता है और यह evidence मिटा देता है कि कौन सा change काम आया।

Community pages symptoms match करने में मदद कर सकती हैं, universal diagnosis नहीं हैं। उदाहरण के लिए frontend issue #6328 और ComfyUI discussion #14344 individual user reports हैं। Version, error और node context आपके case से match हों तभी उन्हें reference बनाएँ।

6. Current minimal image spine दोबारा बनाएँ

अगर पुराने graph में बहुत से obsolete LoRA, ControlNet, upscaling, preview और utility branches हैं, तो सबको एक साथ repair करना core को फिर बनाने से अधिक जोखिमपूर्ण है। Core को ComfyUI के official minimal Save-format example से दोबारा बनाएँ। यह serial chain नहीं है: कई outputs KSampler में मिलते हैं, और VAEDecode को checkpoint का VAE अलग input के रूप में मिलता है।

Output port	Input port
CheckpointLoaderSimple.MODEL	KSampler.model
CheckpointLoaderSimple.CLIP	positive prompt का CLIPTextEncode.clip
CheckpointLoaderSimple.CLIP	negative prompt का CLIPTextEncode.clip
positive prompt का CLIPTextEncode.CONDITIONING	KSampler.positive
negative prompt का CLIPTextEncode.CONDITIONING	KSampler.negative
EmptyLatentImage.LATENT	KSampler.latent_image
KSampler.LATENT	VAEDecode.samples
CheckpointLoaderSimple.VAE	VAEDecode.vae
VAEDecode.IMAGE	SaveImage.images

EmptyLatentImage conditioning नहीं लेता। KSampler को चार independent inputs—model, positive, negative और latent_image—चाहिए, जबकि VAEDecode को sampled samples और checkpoint का vae दोनों चाहिए। Ports को ऊपर दिए तरीके से जोड़ने के बाद ही minimal graph queue होकर image save कर सकता है।

यह wiring तभी इस्तेमाल करें जब चुने गए checkpoint की architecture official example से match करती हो। किसी नए model को अलग loader, text encoder, latent node या VAE path चाहिए हो सकता है; ऐसी स्थिति में इस graph को force करने के बजाय उस model का official workflow follow करें। Baseline test के लिए Load Checkpoint में पहले से दिख रहा compatible checkpoint चुनें, batch size 1 और moderate resolution रखें, और पुराने optional branches अभी disconnected रखें। Spine pass होने के बाद एक LoRA, ControlNet, upscaler या custom post-processing branch जोड़ें और हर addition के बाद फिर run करें।

उद्देश्य नए graph को पुराने जैसा दिखाना नहीं है। पहले एक current और सच में working spine सिद्ध करें, फिर पुराने workflow की केवल जरूरी capabilities migrate करें। Claude दोनों JSON compare करके migration map बना सकता है, लेकिन execution ही acceptance test है।

7. एक छोटी image चलाएँ और saved output verify करें

सिर्फ खुल जाने वाला workflow repair नहीं माना जाता। आधिकारिक first-generation guide के अनुसार पूरा loop पूरा करें:

1. Model install या move करने के बाद model lists refresh करने के लिए R दबाएँ, या जरूरत हो तो restart करें।
2. Load Checkpoint में visible और compatible model चुना है, यह confirm करें।
3. Run क्लिक करें या Ctrl + Enter दबाएँ।
4. Queue complete होने तक प्रतीक्षा करें; missing node, validation error या red failed node न हो।
5. Image Save Image में दिखाई दे, यह जाँचें।
6. Right-click करके local save करें, filename लिखें और image viewer में दोबारा खोलें।
7. वैकल्पिक: generated ComfyUI PNG को interface में वापस drag करके embedded workflow metadata पढ़े जाने की जाँच करें।
8. Repaired normal-format graph को workflow-repaired.json नाम से save करें; workflow-original.json न बदलें।

Acceptance record में repaired workflow filename, output image filename, model, enabled custom nodes, replacements और known limitations होने चाहिए। तभी “fixed” evidence-based status है।

कोई branch अब भी fail हो तो

• Custom nodes बंद होने पर default workflow fail है: पुराना graph edit करना रोकें; install, model, driver या frontend baseline ठीक करें।
• Default चलता है लेकिन पुराने graph में missing nodes हैं: ownership और replacement mapping जारी रखें; JSON types guess करके rename न करें।
• Graph load होता है लेकिन generation fail है: Show report के first failing node से शुरू करें; memory से पहले model family और links जाँचें।
• Extensions का group enable करते ही failure लौटता है: bisect जारी रखें जब तक एक custom node या frontend extension न बच जाए।
• Original node maintained नहीं है: function replace/rebuild करें और behavior differences साफ लिखें।
• Claude exact error या JSON evidence quote नहीं करता: suggestion को hypothesis मानें और अभी execute न करें।

निष्कर्ष

इस काम में Claude evidence organizer और change planner के रूप में सबसे भरोसेमंद है, बिना verification वाला auto-repair button नहीं। मजबूत loop है: backup → clean baseline → classify → smallest change → one image → saved-file verification। Original graph सुरक्षित रखें, एक समय में एक variable बदलें और confident explanation के बजाय वास्तविक ComfyUI output से तय करें कि workflow सच में ठीक हुआ है।