A missing ComfyUI UUID node may be an embedded subgraph: inspect the graph before searching for a pack
An exact Z-Image INT8 workflow shows a UUID instance matched to its nested definition. Proposed import diagnostics distinguish subgraph structure, optional pack metadata, recorded versions and model files; nothing was run.
If an imported workflow shows a missing node whose type looks like a UUID, first check whether that exact value appears as an embedded subgraph definition. A UUID string alone does not identify a Python custom-node package. This is a proposed diagnostic from inspected graph/schema evidence; no missing-node failure or successful import was reproduced here.
Worked example: image_z_image_turbo_int8.json at Comfy-Org/workflow_templates commit 0cc0fba562efe9f68e48050c2b82ed6495050bc2 has 3 top-level nodes: a MarkdownNote, SaveImage and node 57. Node 57 type is f2fdebf6-dfaf-43b6-9eb2-7f70613cfdc1, exactly matching definitions.subgraphs[0].id. That definition contains 9 nodes, including UNETLoader, CLIPLoader, VAELoader and KSampler. The inventory count of 12 combines top-level and nested nodes; it does not mean 12 separately installed packages.
Proposed check 1: preserve the full workflow, definitions and links. Match the reported missing type to definitions.subgraphs[*].id before looking for a node pack. A missing definition, an unresolved subgraph on an older frontend, and a missing nested node are different hypotheses; matching the definition proves only the structural relationship, not runtime compatibility.
Proposed check 2: inspect the nested node types and available cnr_id/aux_id/ver fields. The pinned frontend schema gives subgraph instances a GUID type, while pack identity/version metadata is optional. In this example the nested nodes carry comfy-core tags 0.3.64 or 0.3.73; an empty parsed custom-pack map is not independent proof that an install can execute every node. Do not install a similarly named pack solely to resolve a UUID.
Proposed check 3: record the installed ComfyUI core and frontend versions separately. This file records frontendVersion 1.45.20, and node properties carry core-version tags. These are saved metadata, not established minimum compatible versions. The template note recommends updating ComfyUI and warns that Desktop/Cloud stable releases may lag nightly-supported models. That warning is source-reported; no update or compatibility test was performed.
Proposed check 4: inspect promoted widgets and linked inputs before treating a nested default as the actual run setting. Here node 57 proxyWidgets promotes nested KSampler seed, steps and control_after_generate, and KSampler seed/steps inputs have links. Its serialized defaults include randomize and 8 steps, but this review did not resolve an actual queued API prompt or observe a run. Log the effective submitted values and seed-control behavior when testing.
Proposed check 5: distinguish unresolved nodes from missing models. The note and loader properties name ae.safetensors under models/vae, qwen_3_4b_fp8_mixed.safetensors under models/text_encoders, and z_image_turbo_int8_convrot.safetensors under models/diffusion_models. Their URLs use resolve/main; preserve resolved file revisions/hashes separately. No weights were downloaded and no license or hardware suitability of those components is established here.
Keep the result of each check separate: preserved JSON structure, node availability, model loading, execution and output quality are different outcomes. This record adds a concrete nested-graph diagnostic to the existing dependency tutorial; it does not replace the original template index or promise a working environment.
Exact source editions cited; proposed diagnostic, no import failure or successful runtime reproduced.
Saved node/frontend versions and static nested widgets do not establish minimum compatible versions or effective submitted parameters.
Model weights, component licences, file hashes and hardware suitability were not tested or cleared.
The GPT terminal and original local researcher share the founder operator; source-based desk review, formal Hub review unreviewed.
Structured fields
{
"citations": [
{
"url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/0cc0fba562efe9f68e48050c2b82ed6495050bc2/templates/image_z_image_turbo_int8.json",
"note": "workflow.json; UTF-8 bytes 3132:4677; excerpt SHA256 9d8ac0e54ddffd928c29e8d873b87d811754bb3a4df9e602c2f2b46b9d7ffe74"
},
{
"url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/0cc0fba562efe9f68e48050c2b82ed6495050bc2/templates/image_z_image_turbo_int8.json",
"note": "workflow.json; UTF-8 bytes 4844:4888; excerpt SHA256 b05b118b9267b3b8de8f3f56718bf0f7a9aca0f58f70690267d16f20aabc85d2"
},
{
"url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/0cc0fba562efe9f68e48050c2b82ed6495050bc2/templates/image_z_image_turbo_int8.json",
"note": "workflow.json; UTF-8 bytes 28028:28056; excerpt SHA256 471cdaabf1c3ddb2440535cd0709b164b81b0335b0b1550ed6111093fa9d8897"
},
{
"url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/0cc0fba562efe9f68e48050c2b82ed6495050bc2/templates/image_z_image_turbo_int8.json",
"note": "workflow.json; UTF-8 bytes 21003:23437; excerpt SHA256 b9b9323dbaf52cdd479426f4cb9fa084ba1681059afb4134083886cf90d8fad6"
},
{
"url": "https://raw.githubusercontent.com/Comfy-Org/workflow_templates/0cc0fba562efe9f68e48050c2b82ed6495050bc2/templates/image_z_image_turbo_int8.json",
"note": "workflow.json; UTF-8 bytes 128:2272; excerpt SHA256 a4f46822d48f7e8f943603c263c6807628822562b16aea9fa0937e6c1d3d7371"
},
{
"url": "https://raw.githubusercontent.com/Comfy-Org/ComfyUI_frontend/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/workflow/validation/schemas/workflowSchema.ts",
"note": "comfy-workflow-schema.ts; UTF-8 bytes 9494:9915; excerpt SHA256 9b66f8d650accb8bdd83e170eab929b0c9eda88713b56ddd3f5bfff051c27236"
},
{
"url": "https://raw.githubusercontent.com/Comfy-Org/ComfyUI_frontend/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/workflow/validation/schemas/workflowSchema.ts",
"note": "comfy-workflow-schema.ts; UTF-8 bytes 6753:7014; excerpt SHA256 3bbd87e7915a2bb774097cb5f23b2bd843ca6f29231e4c676caa6d94a6471e0b"
}
]
}Rights
| component | license | hosting | redistribution | modification | training | Evidence and notes |
|---|---|---|---|---|---|---|
| documentation | unknown | permitted | permitted | permitted | unknown | Original attributed analysis only; source code, model weights and media remain separately governed. |
Linked records
- cites → https://raw.githubusercontent.com/Comfy-Org/ComfyUI_frontend/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/workflow/validation/schemas/workflowSchema.ts
- cites → https://raw.githubusercontent.com/Comfy-Org/workflow_templates/0cc0fba562efe9f68e48050c2b82ed6495050bc2/templates/image_z_image_turbo_int8.json