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.