How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/mojomast/open-higgsfield-skills --skill comfyui-connectBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
comfyui-connect
scripts/comfy_client.py uses only the Python standard library. Every other skill ships a copy of it.
Targets
- Local:
COMFY_URL=http://127.0.0.1:8188. - Google Colab: start ComfyUI in the notebook, expose it through a tunnel (for example cloudflared), and set
COMFY_URLto the tunnel URL. Ask before you start a paid Google Colab runtime, and stop it when the job is done. - Hosted (Comfy Cloud or any other): only works if the host exposes the standard
/prompt,/history,/viewand/upload/imageroutes. SetCOMFY_API_KEYto send a Bearer token. Whether Comfy Cloud accepts this exact API and auth is unverified, so read the host's API docs first.
Commands
| Do | Command |
|---|---|
| Run a graph end to end | comfy_client.py run wf.api.json --set 6.text="a red fox" --set 14.noise_seed=7 --out out/ |
| Submit only | comfy_client.py submit wf.api.json prints {"prompt_id": ...} |
| Wait for several jobs | comfy_client.py wait ID1 ID2 --timeout 300 |
| Download outputs | comfy_client.py fetch ID --out out/ |
| Cancel a job | comfy_client.py cancel ID |
| Upload an input | comfy_client.py upload start.png, then pass the returned name to the LoadImage image input |
How wait and cancel behave
waitpolls/history/<id>and/queueuntil every id isdoneorerror, or until the timeout. When the timeout runs out, it returns each job's live status (queued/running) withtimed_out: true. A timeout is not a failure, so you can callwaitagain. If one id can't be fetched, its error is reported for that id alone and the other ids still return.cancelchecks where the job is. A running job getsPOST /interrupt. A queued job getsPOST /queue {"delete":[id]}. A finished job is left alone.- Keep each timeout short (60-300 s) and loop. That keeps you responsive, so you can report progress or cancel.
Rules
- Only send API-format graphs. If a JSON file has a top-level
nodeskey, it is UI format: re-export it with "Save (API)". --setvalues are parsed as JSON when possible, so--set 5.width=1024sends a number.- If
/promptreturnsnode_errors, show them and runcomfyui-preflight. Don't retry blindly.