Run any model on RunComfy from the command line. The `runcomfy` CLI is one binary, one auth, hundreds of model endpoints — image generation, image edit, video generation, image-to-video, lip-sync, face swap, video edit, inpainting, outpainting, extend, ControlNet, relight, upscale, LoRA training and

RunComfy CLI One binary, one auth, every RunComfy model. Install once, sign in once, then call any text to image, video, edit, lip sync, face swap, or LoRA training endpoint with runcomfy run <model id input '{...}' . This skill is the foundation every other runcomfy skill builds on. [runcomfy.com](https://www.runcomfy.com/?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [CLI docs](https://docs.runcomfy.com/cli/introduction?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [All models](https://www.runcomfy.com/models?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) Install this skill Install the CLI Pick one: A standalone curl pipe installer also exists for environments without Node — see [docs.runcomfy.com/cli/install](https://docs.runcomfy.com/cli/install?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli). Inspect any install script before piping it into a shell. This skill only invokes the CLI via Bash(runcomfy ) after you have installed it through one of the verified package managers above. Confirm: Full options on the [Install page](https://docs.runcomfy.com/cli/install?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli). Sign in Interactive (opens browser): CI / containers (no browser): Verify: Full flow + token rotation: [Authentication](https://docs.runcomfy.com/cli/auth?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli). Run a model The general shape: Example — generate an image with GPT Image 2: You will see: By default the result is downloaded to the current directory. Override with output dir ./out , skip downloading with no download . Quickstart: [docs.runcomfy.com/cli/quickstart](https://docs.runcomfy.com/cli/quickstart?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli). Discover model schemas Every model has an API tab on its detail page with the exact input schema. Browse the catalog: Or search by collection / capability: URL What [ /models ](https://www.runcomfy.com/models?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) All featured models [ /models/all ](https://www.runcomfy.com/models/all?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) The full catalog [ /models/collections/recently added ](https://www.runcomfy.com/models/collections/recently added?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) Fresh additions [ /models/collections/nano banana ](https://www.runcomfy.com/models/collections/nano banana?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /seedream ](https://www.runcomfy.com/models/collections/seedream?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /flux kontext ](https://www.runcomfy.com/models/collections/flux kontext?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /kling ](https://www.runcomfy.com/models/collections/kling?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /seedance ](https://www.runcomfy.com/models/collections/seedance?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /veo 3 ](https://www.runcomfy.com/models/collections/veo 3?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /wan models ](https://www.runcomfy.com/models/collections/wan models?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /hailuo ](https://www.runcomfy.com/models/collections/hailuo?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) · [ /qwen image ](https://www.runcomfy.com/models/collections/qwen image?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) Curated brand collections [ /models/feature/lip sync ](https://www.runcomfy.com/models/feature/lip sync?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) Lip sync capability [ /models/feature/character swap ](https://www.runcomfy.com/models/feature/character swap?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) Character / face swap [ /models/feature/upscale video ](https://www.runcomfy.com/models/feature/upscale video?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli) Video upscalers Commands runcomfy run <model id Synchronous run — submit, poll, download. Flag What input '<JSON ' Inline JSON body. Strings can contain newlines; quote escape as needed input file <path Read body from a file (JSON or YAML by extension) output dir <path Where to download result files (default: cwd) no download Skip the download step; only print the result JSON no wait Submit and return request id immediately; don't poll timeout <seconds Cap the polling wait. Default: model dependent output json Print machine readable JSON for piping (default human readable) quiet Suppress progress, keep only the final result line runcomfy login / runcomfy whoami / runcomfy logout login runs the device code flow; whoami prints the active identity; logout removes the local token file. Set RUNCOMFY TOKEN env var to override the file entirely. runcomfy status <request id Check status of a no wait job: Full command reference: [docs.runcomfy.com/cli/commands](https://docs.runcomfy.com/cli/commands?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli). Scripting patterns Pipe friendly JSON Batch from a file of prompts Submit now, poll later Retry on transient failure The CLI returns exit code 75 on retryable errors (timeout, 429). Wrap with a shell retry loop: Exit codes code meaning retry? 0 success — 64 bad CLI args no 65 bad input JSON / schema mismatch no 69 upstream 5xx yes (after backoff) 75 retryable: timeout / 429 yes 77 not signed in or token rejected no — re auth 130 interrupted (Ctrl C); remote request is cancelled before exit — Full reference: [docs.runcomfy.com/cli/troubleshooting](https://docs.runcomfy.com/cli/troubleshooting?utm source=skills.sh&utm medium=skill&utm campaign=runcomfy cli). How it works The CLI does three things for each run call: 1. Submit — POSTs the JSON body to model api.runcomfy.net with your bearer token. 2. Poll — GETs the request every ~2s until status is completed , failed , or canceled . 3. Download — for each output URL under .runcomfy.net / .runcomfy.com , fetch into output dir . Ctrl C sends DELETE to the request endpoint to cancel the remote job before exit, so you don't get billed for work you abandoned. Security & Privacy Install via verified package manager only. This skill recommends npm i g @runcomfy/cli or npx y @runcomfy/cli . A standalone curl pipe installer exists in the official docs but agents must not pipe an arbitrary remote script into a shell on the user's behalf — if the user wants the curl path, they should review the script themselves first. Token storage : runcomfy login writes the API token to ~/.config/runcomfy/token.json with mode 0600 (owner only read/write). Set RUNCOMFY TOKEN env var to bypass the file entirely in CI / containers. Never log the token, never echo it into prompts, never check it into a repo. Input boundary (shell injection) : prompts are passed as a JSON string via input . The CLI does not shell expand prompt content; it transmits the JSON body directly to the Model API over HTTPS. There is no shell injection surface from prompt content , even when the prompt contains backticks, quotes, or $(...) patterns. Indirect prompt injection (third party content) : image / audio / video URLs and enable web search outputs are untrusted . They are fetched by the RunComfy model server and can influence generation through embedded instructions inside the asset (e.g. text painted into an image, hidden instructions in EXIF, web search results steering style). Mitigations the agent should apply: Only ingest URLs the user explicitly provided for this task. Don't auto resolve URLs the user pasted in unrelated context. When generation behavior diverges from the prompt, suspect the reference asset, not the prompt. For enable web search , default to false ; set true only when the user names a real world entity that requires grounding. Outbound endpoints (allowlist) : only model api.runcomfy.net (request submission) and .runcomfy.net / .runcomfy.com (download whitelist for generated outputs). No telemetry. No callbacks to third parties. Generated file size cap : the CLI aborts any single download 2 GiB to prevent disk fill from a runaway model output. Scope of this skill's bash usage : declared allowed tools: Bash(runcomfy ) . The skill never instructs the agent to run anything other than runcomfy <subcommand — npm , curl , export RUNCOMFY TOKEN=... lines in this document are install / one time setup steps for the operator , not commands the skill itself executes on each call. See also Sibling intent routed skills that all dispatch through this CLI: [ ai image generation ](https://www.skills.sh/agentspace so/runcomfy agent skills/ai image generation) — text to image / image to image router across FLUX 2, GPT Image 2, Nano Banana, Seedream, and more [ ai video generation ](https://www.skills.sh/agentspace so/runcomfy agent skills/ai video generation) — t2v / i2v / video extend router across HappyHorse, Wan, Seedance, Kling, Veo [ ai avatar video ](https://www.skills.sh/agentspace so/runcomfy agent skills/ai avatar video) — talking head / lip sync video router [ image edit ](https://www.skills.sh/agentspace so/runcomfy agent skills/image edit) — full image edit treatment (mask, batch, multi ref) [ video edit ](https://www.skills.sh/agentspace so/runcomfy agent skills/video edit) — video restyle, motion control, identity stable edit [ image to video ](https://www.skills.sh/agentspace so/runcomfy agent skills/image to video) — animate a still [ face swap ](https://www.skills.sh/agentspace so/runcomfy agent skills/face swap) · [ lipsync ](https://www.skills.sh/agentspace so/runcomfy agent skills/lipsync) · [ image inpainting ](https://www.skills.sh/agentspace so/runcomfy agent skills/image inpainting) · [ image outpainting ](https://www.skills.sh/agentspace so/runcomfy agent skills/image outpainting) · [ video extend ](https://www.skills.sh/agentspace so/runcomfy agent skills/video extend) · [ controlnet pose ](https://www.skills.sh/agentspace so/runcomfy agent skills/controlnet pose) · [ relight ](https://www.skills.sh/agentspace so/runcomfy agent skills/relight) — narrow technique routers

runcomfy-cli