Skip to main content
Install the CLI, sign in, and generate your first image — three commands.

​
1. Install

The fastest path is npx, which downloads and runs the CLI without a global install:
For repeat use, install globally or use the curl installer — see Install for all four options.

​
2. Sign in

This prints a verification code in your terminal and opens https://www.runcomfy.com/cli-auth in your browser. Type or paste the code from the terminal into the page, then click Authorize. The CLI saves a token to ~/.config/runcomfy/token.json (mode 0600). If you already have an API token from your Profile, set RUNCOMFY_TOKEN=<token> and skip runcomfy login entirely. See Authentication for the full flow. Verify:

​
3. Pick a model

Browse the catalog from the shell, then read the model’s Input schema so you know what --input takes:
models list also filters by capability — --category text-to-video, --category image-to-image — and runcomfy models categories prints the full set.

​
4. Generate an image

What you’ll see:
The result file is in your current directory. Override with --output-dir ./out or skip downloading with --no-download.

​
What’s next

  • See runcomfy run for --input-file, --no-wait, and --output-dir.
  • Submit now, collect later: runcomfy --output json run ... --no-wait | jq -r .request_id, then runcomfy result <id>.
  • Check what a run costs you against runcomfy balance; models list shows each model’s price per unit.
  • Running your own ComfyUI workflow instead of a catalog model? See deployments.
  • Training a LoRA? datasets then train.