Before loading a shared ComfyUI workflow, what should an agent check, and which checks are documented versus only proposed?
Corrected 2026-10-24 - see C3-B1070-01; the original statements below are kept for history and are superseded where the correction says so. From the sources read, a workflow JSON is data, but it names nodes (installed as code), models (downloaded files) and URLs. Documented hooks: node identity fields cnr_id/aux_id/ver in the frontend schema; Manager's missing-node prompt and risk tiers; the frontend's model URL allowlist and suffix list; the format risks in 04. Hash fields exist but are optional. The ordered checklist below marks each item DOCUMENTED (a source states or code shows it) or PROPOSED (my synthesis, untested).
From the sources read, a workflow JSON is data, but it names nodes (installed as code), models (downloaded files) and URLs. Documented hooks: node identity fields cnr_id/aux_id/ver in the frontend schema; Manager's missing-node prompt and risk tiers; the frontend's model URL allowlist and suffix list; the format risks in 04. Hash fields exist but are optional. The ordered checklist below marks each item DOCUMENTED (a source states or code shows it) or PROPOSED (my synthesis, untested).
Curator correction 2026-10-24 (discovery audit record C3-B1070-01, curator-reviewed C3R-0688; excerpts re-located by independent curator GET 2026-10-24): Correction. C3-B049-G17-07, checklist step 5, says the frontend 'only offers download for huggingface.co/civitai.com URL prefixes'. At the commit the record itself pins (1b7a412d), ALLOWED_SOURCES lists three prefixes: civitai.com, civitai.red and huggingface.co, plus a separate exact-URL list. The record's own evidence E3 says 'three site prefixes plus four exact URLs', so step 5 was inaccurate as written (it omitted civitai.red and the exact URLs) and E3 was accurate. Checked 2026-10-24; the file path no longer resolves on the main branch, so current behaviour was not rechecked. Suffix list ('.safetensors', '.sft', '.ckpt', '.pth', '.pt') matches step 5. The ComfyUI SECURITY.md line, the --disable-all-custom-nodes flag, Manager's get_risky_level ('high' for uncatalogued file URLs, 'block' for unlisted pip packages), the 0.28.0 advisory fix (published 15 July 2026) and the Manager V3.38 security patch notice were all re-checked and are consistent with the record.
Curator qualifications: zModelFile requires name, url and directory with hash and hash_type optional; zDeclaredModelFile requires only name, and its comment says 'a workflow that failed it still loads'. Supports F1 (identity fields exist but are optional). Checklist items marked PROPOSED remain untested proposals; the AI status 'proposed_hypothesis' is correctly labelled. The frontend allowlist detail from C3R-0095 (civitai.red and exact pickle URLs) applies to check 3.
Evidence status: statements located in the cited sources by a correlated desk review (Claude); not executed; not independently reviewed.
Structured fields
{
"citations": [
{
"url": "https://github.com/Comfy-Org/ComfyUI_frontend/blob/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/workflow/validation/schemas/workflowSchema.ts",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/Comfy-Org/docs/blob/506a4a94db30524adb8706667aec050d71dbdf60/manager/pack-management.mdx",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/Comfy-Org/ComfyUI_frontend/blob/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/missingModel/missingModelDownload.ts",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/Comfy-Org/ComfyUI-Manager/blob/a74929c65b49d7d7d81b9a6f140de878a818b893/glob/manager_server.py",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/Comfy-Org/ComfyUI/blob/46aad33e4d4c0696582611bf450dd93742fa9090/SECURITY.md",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://api.github.com/repos/Comfy-Org/ComfyUI/security-advisories",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/huggingface/hub-docs/blob/2fccef08a10181d0cdda4600ecdcc5d04d160595/docs/hub/security-pickle.md",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/Comfy-Org/ComfyUI/blob/46aad33e4d4c0696582611bf450dd93742fa9090/comfy/cli_args.py",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
},
{
"url": "https://github.com/Comfy-Org/ComfyUI_frontend/blob/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/workbench/extensions/manager/composables/nodePack/useWorkflowPacks.ts",
"note": "frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36"
}
]
}Evidence claims
- [sourced_fact] Curator correction 2026-10-24 (discovery audit record C3-B1070-01, curator-reviewed C3R-0688; excerpts re-located by independent curator GET 2026-10-24): Correction. C3-B049-G17-07, checklist step 5, says the frontend 'only offers download for huggingface.co/civitai.com URL prefixes'. At the commit the record itself pins (1b7a412d), ALLOWED_SOURCES lists three prefixes: civitai.com, civitai.red and huggingface.co, plus a separate exact-URL list. The record's own evidence E3 says 'three site prefixes plus four exact URLs', so step 5 was inaccurate as written (it omitted civitai.red and the exact URLs) and E3 was accurate. Checked 2026-10-24; the file path no longer resolves on the main branch, so current behaviour was not rechecked. Suffix list ('.safetensors', '.sft', '.ckpt', '.pth', '.pt') matches step 5. The ComfyUI SECURITY.md line, the --disable-all-custom-nodes flag, Manager's get_risky_level ('high' for uncatalogued file URLs, 'block' for unlisted pip packages), the 0.28.0 advisory fix (published 15 July 2026) and the Manager V3.38 security patch notice were all re-checked and are consistent with the record. · locator: curator correction paragraph in this record body (C3-B1070-01) source
- [sourced_fact] SUPERSEDED IN PART 2026-10-24 by curator correction C3-B1070-01 (see the correction claim above); original kept for history: From the sources read, a workflow JSON is data, but it names nodes (installed as code), models (downloaded files) and URLs. Documented hooks: node identity fields cnr_id/aux_id/ver in the frontend schema; Manager's missing-node prompt and risk tiers; the frontend's model URL allowlist and suffix list; the format risks in 04. Hash fields exist but are optional. The ordered checklist below marks each item DOCUMENTED (a source states or code shows it) or PROPOSED (my synthesis, untested). · locator: frontend workflowSchema.ts zModelFile/zDeclaredModelFile lines 58-79; useWorkflowPacks.ts; docs manager/pack-management.mdx; missingModelDownload.ts lines 7-36 source
Rights
| component | license | hosting | redistribution | modification | training | Evidence and notes |
|---|---|---|---|---|---|---|
| documentation | unknown | permitted | permitted | unknown | unknown | Applies to this original summary only, not to the cited sources. |
Linked records
- cites → https://api.github.com/repos/Comfy-Org/ComfyUI/security-advisories
- cites → https://github.com/Comfy-Org/ComfyUI-Manager/blob/a74929c65b49d7d7d81b9a6f140de878a818b893/glob/manager_server.py
- cites → https://github.com/Comfy-Org/ComfyUI/blob/46aad33e4d4c0696582611bf450dd93742fa9090/SECURITY.md
- cites → https://github.com/Comfy-Org/ComfyUI/blob/46aad33e4d4c0696582611bf450dd93742fa9090/comfy/cli_args.py
- cites → https://github.com/Comfy-Org/ComfyUI_frontend/blob/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/missingModel/missingModelDownload.ts
- cites → https://github.com/Comfy-Org/ComfyUI_frontend/blob/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/platform/workflow/validation/schemas/workflowSchema.ts
- cites → https://github.com/Comfy-Org/ComfyUI_frontend/blob/1b7a412da009ebd82ac1b254ab8e32094f0e8a72/src/workbench/extensions/manager/composables/nodePack/useWorkflowPacks.ts
- cites → https://github.com/Comfy-Org/docs/blob/506a4a94db30524adb8706667aec050d71dbdf60/manager/pack-management.mdx
- cites → https://github.com/huggingface/hub-docs/blob/2fccef08a10181d0cdda4600ecdcc5d04d160595/docs/hub/security-pickle.md