Skip to main content
The runcomfy CLI is a single statically-linked Rust binary. Pick whichever install matches your environment.

​
Option 1: npx (no install)

For a one-off run or to try the CLI before committing to an install:
npx downloads @runcomfy/cli, runs its postinstall hook (which fetches the per-platform binary from GitHub Releases), and invokes it. Subsequent npx runs reuse the cached package. No PATH changes, no admin privileges.

​
Option 2: npm global

Same package as npx, but runcomfy is on your PATH permanently. Update with npm i -g @runcomfy/cli@latest.

​
Option 3: curl install script

For developers who don’t want Node on the install path, or for quick provisioning into containers / VMs:
The script:
  • Detects your OS and CPU architecture
  • Downloads the matching binary from the latest GitHub Release
  • Verifies the SHA-256 checksum
  • Installs to ~/.local/bin/runcomfy (or /usr/local/bin/runcomfy if you have write access)
  • Adds the install dir to your PATH if needed (with a one-line printed instruction)
To install a specific version:

​
Option 4: Build from source

Requires Rust 1.75+ (rustup install stable).

​
Supported platforms

​
Shell completion

After install, generate a completion script for your shell:
Re-source your shell rc file (or open a new terminal) to pick it up. runcomfy <Tab> will then list subcommands; runcomfy run <Tab> will offer flags.

​
Verify the install

The output includes the git short SHA and commit date so you can pin a specific build.