Install

Install the requirements into the interpreter ComfyUI itself runs on. Installing into a different one leaves the pack loaded, the pickers empty, and no error naming a cause.

Requirements

requirement	value
ComfyUI	0.34.0 or newer
Python	3.11
Site	a Flow Production Tracking site you can log into

Two ways to install

1. From the Registry

Pick this to use the nodes. Manager updates the pack, and Settings and the profile keep your configuration across updates: project, templates, storage, the provenance mapping, which inputs are advanced. The pack is in alpha. What is missing is under What's next.

Open Manager, then Custom Nodes Manager. Search for Flow Production Tracking. Press Install. Restart ComfyUI.

With the Comfy CLI, the pack is sg-comfyui at https://registry.comfy.org/nodes/sg-comfyui:

comfy node install sg-comfyui

Restart ComfyUI.

The commands /setup, /task and /track-workflow are in the pack, at ComfyUI/custom_nodes/sg-comfyui. Start your agent in that directory to use them.

2. From the repo

Pick this to change the nodes. The checkout has the tests, the harness and the history an agent works with, and your change survives git pull. It is also where /inspect-site runs, since it needs the sg-groundtruth checkout beside it.

cd ComfyUI/custom_nodes
git clone https://github.com/ksallee/sg-comfyui.git
cd sg-comfyui
<comfy-python> -m pip install -r requirements.txt

Restart ComfyUI.

<comfy-python> is the interpreter ComfyUI runs on. Check the install with it:

<comfy-python> tools/doctor.py

Start your agent in the checkout. The four commands are there, /inspect-site included.

Which interpreter

install	the interpreter
source	`ComfyUI/venv/bin/python`
desktop	the `python` inside the app bundle
studio	whatever your launch script names

Check which one you have:

cd ComfyUI/custom_nodes/sg-comfyui
../../venv/bin/python tools/doctor.py

ok    Python 3.11.11 at /Users/you/ComfyUI/venv/bin/python.
ok    sg_groundtruth imports here.
ok    requests imports here.
ok    Pillow imports here.
ok    This is the interpreter ComfyUI runs on, /Users/you/ComfyUI/venv/bin/python.

A fail line names the fix.
--site adds the connection, the provenance fields, the storage roots and the link types.
COMFYUI_PATH tells the doctor where ComfyUI is. It defaults to ~/dev/ComfyUI.
The doctor exits non-zero on anything that would fail a publish. It warns on the rest.

Local files

All of them yours. Neither install ships one.

file	what it is	written by
`settings.local.json`	site address, script name, application key, publish as	Settings, then SG
`session.local.json`	the session token from Log in	Settings, then SG
`profile.local.json`	what your site practices, per project	the inspector, Settings, and you
`.env.local`	a script key for the command-line tools	you

The protected user directory is <ComfyUI user directory>/__sg_comfyui, which is ComfyUI/user/__sg_comfyui unless --user-directory or --base-directory moved it. It is outside custom_nodes, so an upgrade leaves it alone. ComfyUI serves no HTTP route for a __ directory.

Colour management

Core ComfyUI has none, and none of this is needed to publish. For a colour-managed pipeline:

Install the ComfyUI-OCIO pack.
Set OPENCV_IO_ENABLE_OPENEXR=1 in the environment that launches ComfyUI.
Put ffmpeg on the path.

Next: First run.