Runware CLI

Runware
in your terminal.

Drop in your API key and run any model with one command.

A single static binary for image, video, audio, text, and 3D, plus model search, presets, uploads, and account management.

SINGLE BINARY · macOS, LINUX, WINDOWS
Terminal

$

How it works

Key in. First image out.

1· Install

One line for your platform.

2· Authenticate

Store your key once.

3· Run

Generate from any model.

Terminal

$

Showing install, auth, and run flow for macOS

One command

One command, every modality.

Give runware run a model's AIR identifier and key=value parameters. It reads the model's schema to detect the task type, then downloads the result.

Terminal
$ runware run runware:400@1 positivePrompt="A woman wearing flowers on top of her head." width=1024 height=1024
saved path=outputs/1253900f….jpg
Woman wearing flowers on her head, generated with FLUX.2 [dev] (runware:400@1)

1253900f….jpg · 1024×1536

Showing Image example

Always current

Every new model, the day it ships.

run reads each model's schema at call time, so a model works the moment it's live on Runware. No CLI update, no waiting. The whole catalog is one command away, from major providers to thousands of community models.

Scripting

Built to pipe.

Every command prints a table, or JSON and YAML for machines. Logs and progress go to stderr, so stdout stays clean for piping. Set RUNWARE_API_KEY and it drops straight into CI.

Pipe the output

Terminal

$ runware run runware:400@1 positivePrompt="Product hero" width=1024 height=1024 --format json --no-download | jq -r '.imageURL'

https://im.runware.ai/image/os/.../1d0c0c3a.jpg

Run it in CI

.github/workflows/render.yml

Commands

The whole API, one binary.

More than generation. Search the catalog, upload your own models and assets, save presets, and manage your account, all from the terminal.

Terminal
$ runware run runware:400@1 positivePrompt="A woman wearing flowers on top of her head." width=1024 height=1024
saved path=outputs/1253900f….jpg

Showing terminal output for run

Runware MCP

Building with an agent instead?

Connect Claude, Cursor, Codex, or any MCP client to Runware with one URL. Same key, same balance, plain-language generation inside your agent.

Explore Runware MCP
FAQ

Questions, answered.

A single binary that runs the Runware inference API from your terminal: image, video, audio, text, and 3D, plus search, presets, uploads, and account management.

Runware CLI

From install to first generation in minutes.

Install, authenticate, run.