comfy-deploy-failures

Diagnose Comfy Cloud deployment failures by mapping deploy error codes to fixes.

961|148|Updated Apr 14, 2024
One-click install
npx skills add https://github.com/Comfy-Org/comfy-cli --skill comfy-deploy-failures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comfy-deploy-failures
Source: https://github.com/Comfy-Org/comfy-cli/tree/main/comfy_cli/skills/comfy-deploy-failures
Command: npx skills add https://github.com/Comfy-Org/comfy-cli --skill comfy-deploy-failures

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a comfy deploy command is refused, a deployment never reaches ready, or a submitted job fails, the raw error code alone does not tell you what to do next. This Skill maps every deploy_* error code to its meaning and the exact command or action that clears it, so you stop guessing and stop paying for duplicate billed jobs.

Core Features & Use Cases

  • Error code reference: Covers all deploy lifecycle codes (build, quota, billing, conflicts) and workflow submission codes (format validation, asset uploads, idempotency, job failures) with the specific move that resolves each one.
  • Failure triage order: Prescribes reading comfy deploy status, then events, then logs to distinguish billing problems from transient states and stuck deployments like stop_failed or unhealthy.
  • Cost-safety guardrails: Explains why deploy_job_submit_unknown must never trigger an automatic resubmit, why endpoint trust refusals must not be bypassed, and how to probe class registration with a minimal billed test job.
  • Use Case: Your deployment is stuck in provisioning and a job submission timed out. Use this Skill to read the deployment events, identify deploy_compute_unavailable, pick another GPU/region pair, and avoid double-billing on the ambiguous submission.

Quick Start

Ask the assistant to read the comfy-deploy-failures skill and explain why my deployment is stuck and what command fixes the deploy error code I received.

Frequently Asked Questions about comfy-deploy-failures

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a comfy deploy error code?

Each deploy_* error code maps to a specific cause and fix. For example, deploy_build_not_pushed means run comfy build push, and deploy_no_deployable_release means create a release with comfy build release create --target linux/nvidia. Start by reading comfy deploy status and events.

Why is my Comfy Cloud deployment stuck in provisioning?

Read comfy deploy events for the transition messages. If compute could not be allocated, the code is deploy_compute_unavailable, and the fix is choosing another GPU/region pair from comfy deploy refs compute.

Should I resubmit a job after a deploy_job_submit_unknown timeout?

No. The job may already exist, and every run uses a fresh idempotency key, so resubmitting creates a second billed job. There is no job lookup endpoint, so report the deployment status and let the user decide.

What does deploy stop_failed mean and is it still billing?

stop_failed means the stop did not take and the deployment may still be billing. Run comfy deploy stop --deployment <id> again and warn the user it may keep charging until the stop succeeds.

How do I check if a custom node class is registered in a deployment?

There is no free lookup; object_info returns 401 and is not exposed on serverless. Submit a minimal single-node probe workflow with the class's required inputs filled in, then read the job error to distinguish an unknown class from a missing input.

What should I do about deploy_endpoint_unknown or deploy_insecure_url errors?

These are refusals to trust the server, not transport failures. Surface the error to the user and stop; do not fetch the URL manually or widen the allowed host suffix list to bypass the refusal.