runcomfy-cli

Execute RunComfy model endpoints via CLI with JSON inputs and outputs.

12|2|Updated May 18, 2026
One-click install
npx skills add https://github.com/runcomfy-com/skills --skill runcomfy-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: runcomfy-cli
Source: https://github.com/runcomfy-com/skills/tree/main/runcomfy-cli
Command: npx skills add https://github.com/runcomfy-com/skills --skill runcomfy-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of installing, authenticating, and operating RunComfy model endpoints by giving you a single command-line workflow for submitting requests, polling status, and downloading outputs.

Core Features & Use Cases

  • One-binary model execution: Run text-to-image, image-to-video, edits, lip-sync, face swap, upscaling, and more through a consistent interface.
  • Auth + request lifecycle: Install the verified CLI, sign in once, then submit jobs with input JSON, poll for completion, and download results.
  • Operational reliability patterns: Supports streaming-friendly JSON output, no-wait submission with later status checks, and documented retryable exit codes for resilience.

Quick Start

Run a text-to-image request by telling the agent: runcomfy run openai/gpt-image-2/text-to-image --input '{"prompt":"a small purple cat at sunset, photorealistic"}'.

Frequently Asked Questions about runcomfy-cli

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

FAQPage Schema
How do I run text-to-image generation from the command line?

Run text-to-image generation by executing a single CLI command with your input JSON, allowing you to submit model requests and download outputs directly from scripts or the terminal.

How do I automate job polling for media generation workflows?

Automate job polling for media generation workflows by submitting a no-wait request and checking its status later, supporting consistent terminal-based automation for video and image edits.

Can I use JSON workflows for lip-sync and face swap tasks in scripts?

Yes, you can use JSON workflows for lip-sync and face swap tasks by passing JSON bodies as input to the command-line interface, enabling scripted and automated execution.

Do I need to handle authentication separately for model inference in the terminal?

No, you do not need to handle authentication separately for model inference; the workflow includes sign-in once and automates request submission and result download for you.

What are the limitations of running model inference via a CLI interface?

Limitations of running model inference via a CLI interface include operating within defined tool scopes and handling retryable failure exit codes, requiring inputs strictly as JSON bodies.