Integrations

ComfyUI GenAsset nodes

Use Save To GenAsset, Load Asset From GenAsset, Manager Health, Workflow Doctor, Model Resolver, and Repro Lock inside ComfyUI workflows.

Save node

Save To GenAsset

Connect the generated image into the blue image input.
Set base_url to your GenAsset app URL.
Set token to `ComfyUI/user/genasset.json` (recommended) or paste a token directly.
Use a stable asset_name when you want clean version history.

Load node

Load Asset From GenAsset

Use the same base_url and token as your save node.
Set version_id when you want one exact version.
Leave version_id empty and set asset_id to load latest/current for that asset.
Leave both empty to load the latest updated asset in your workspace.
Connect image to VAE Encode for img2img workflows.
Use workflow_json, metadata_json, and status_json when you need recipe/debug data.

Field guide: what to add and where to find it

base_url: use https://genasset.xyz (or your local GenAsset URL if self-hosting).
token: recommended value is ComfyUI/user/genasset.json (file-based). You can also paste a token directly.
asset_id: copy from the asset page in GenAsset (asset id), or from Save To GenAsset output asset_id.
version_id: optional exact-version override. Copy from version history (version id), or from Save To GenAsset output version_id.

If the preview is black 64x64

This is a fallback image returned when load fails. Open status_json for the exact error and verify that base_url, token, and ids are from the same GenAsset workspace/environment.

Health tab

Open GenAsset in the ComfyUI top bar, then choose Health. The Health tab inspects the currently loaded workflow before you queue it.

Workflow Doctor

Uses GenAsset AI to explain missing nodes, broken links, missing models, and risky workflow patterns in plain language.

Model Resolver

Finds required checkpoints, UNets/GGUFs, LoRAs, VAEs, ControlNets, CLIP files, embeddings, and expected folders.

No automatic mutation

Health v1 is read-only. It does not rewrite workflows, install nodes, or download models. Resolve Models suggests folders and source-search links; Run Doctor requires the GenAsset token because AI guidance runs through GenAsset.

Repro Lock

Save To GenAsset now attaches metadata.repro_lock automatically to every saved version. Repro Lock records the workflow hash, GenAsset node version, ComfyUI version context, Python/Torch/CUDA/MPS details, custom-node versions, and referenced model metadata when available.

Use Preview Repro Lock in the Manager Health tab to see what will be saved before queueing. There is no separate Repro Lock canvas node.

Workflow patterns

Text to image

Generate normally, then send the decoded image to Save To GenAsset.

Image to image

Load an existing asset, encode it to latent, edit, then save a new version.

Codex SDK

Use Codex to save generated images to GenAsset and load version recipes later.

Troubleshooting

Token errors

If saves fail with unauthorized responses, create a fresh workspace token and make sure the node is pointed at the same GenAsset URL.

Missing checkpoint

If the starter workflow opens with missing model warnings, download the checkpoint named in the workflow card and restart ComfyUI.