> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runcomfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

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:

```bash theme={null}
npx -y @runcomfy/cli --version
```

For repeat use, install globally or use the curl installer — see [Install](/cli/install) for all four options.

***

## 2. Sign in

```bash theme={null}
runcomfy login
```

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](https://www.runcomfy.com/profile), set `RUNCOMFY_TOKEN=<token>` and skip `runcomfy login` entirely. See [Authentication](/cli/auth) for the full flow.

Verify:

```bash theme={null}
runcomfy whoami
# 📛 you@example.com
#    token type: cli
#    user id: ...
```

***

## 3. Generate an image

```bash theme={null}
runcomfy run openai/gpt-image-2/text-to-image \
  --input '{"prompt": "a small purple cat at sunset, photorealistic"}'
```

What you'll see:

```
⏳ Submitting request to openai/gpt-image-2/text-to-image
   request_id: 8a3f...
⏳ Polling status (every 2s)...
   in_queue
   in_progress
   completed
✅ completed
{
  "images": [
    "https://playgrounds-storage-public.runcomfy.net/.../result.png"
  ]
}
📥 Downloading 1 file(s) to .
   ./result.png
```

The result file is in your current directory. Override with `--output-dir ./out` or skip downloading with `--no-download`.

***

## What's next

* Browse models at [runcomfy.com/models](https://www.runcomfy.com/models) — every model page shows its `model_id` and Input schema.
* See [`runcomfy run`](/cli/commands#run) for `--input-file`, `--no-wait`, and `--output-dir`.
* Pipe-friendly mode: `runcomfy --output json run ... --no-wait | jq -r .request_id` returns just the id for scripting.