mojomast/open-higgsfield-skills

comfyui-connect

Submit ComfyUI API-format workflows to any ComfyUI server (local, a Google Colab tunnel, or a hosted instance), poll for completion, download outputs, upload inputs, and cancel jobs.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/mojomast/open-higgsfield-skills --skill comfyui-connect

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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_URL to 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, /view and /upload/image routes. Set COMFY_API_KEY to send a Bearer token. Whether Comfy Cloud accepts this exact API and auth is unverified, so read the host's API docs first.

Commands

DoCommand
Run a graph end to endcomfy_client.py run wf.api.json --set 6.text="a red fox" --set 14.noise_seed=7 --out out/
Submit onlycomfy_client.py submit wf.api.json prints {"prompt_id": ...}
Wait for several jobscomfy_client.py wait ID1 ID2 --timeout 300
Download outputscomfy_client.py fetch ID --out out/
Cancel a jobcomfy_client.py cancel ID
Upload an inputcomfy_client.py upload start.png, then pass the returned name to the LoadImage image input

How wait and cancel behave

  • wait polls /history/<id> and /queue until every id is done or error, or until the timeout. When the timeout runs out, it returns each job's live status (queued/running) with timed_out: true. A timeout is not a failure, so you can call wait again. If one id can't be fetched, its error is reported for that id alone and the other ids still return.
  • cancel checks where the job is. A running job gets POST /interrupt. A queued job gets POST /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 nodes key, it is UI format: re-export it with "Save (API)".
  • --set values are parsed as JSON when possible, so --set 5.width=1024 sends a number.
  • If /prompt returns node_errors, show them and run comfyui-preflight. Don't retry blindly.