Troubleshooting

Run tools/doctor.py first, with the interpreter ComfyUI runs on. It names both when they differ.

The Settings dialog says 404

The running ComfyUI started before the pack was installed, so it registered no routes. Restart ComfyUI and reload the page. If it still says 404, read the startup log for the pack: a pack whose import failed registers nothing.

The pickers are empty

Open Settings, then SG, and press Test. An empty project list with a passing Test means the account can see no project. A passing Test and an empty link list means this project has no entity of that type yet.

A new Shot, Task or Version does not show up

The editor's lookups are cached for 600 seconds. Press Sync from SG on the node to force a read.

Nothing works and the pack looks installed

Run tools/doctor.py with the interpreter ComfyUI runs on. Installing the requirements into a different interpreter leaves the pack loaded, the pickers empty, and no error naming a cause.

Create Published Files refuses, and the site has no storage

Add a Local File Storage under Site Preferences, then File Management, in Flow Production Tracking. Name it under Settings, then SG, Storage. Until then, untick Create Published Files and publish review media.

The storage root is not mounted

The publish stops before the Version exists and names the root. Mount it, or name a storage this machine can see.

Versions read ComfyUI (unknown client)

The client that POSTed /prompt did not name itself. The standard frontend sends comfyui-frontend. Set it in your own submitter:

POST /prompt  {"prompt": {...}, "extra_data": {"comfy_usage_source": "my-farm-submitter"}}

A publish failed after the frames were copied

The copies stay where they are and the error names their paths. Nothing is deleted, so a second attempt costs a copy rather than a re-render.

The session has expired

The node keeps the link it had and says to sign in again. Press Log in under Settings, then SG, and run again.