imageflare 1.0.0

CLI tool for image editing and generation via Cloudflare Workers AI

imageflare

A CLI tool for image editing and generation powered by Cloudflare Workers AI.

Features

• Generate images from text prompts using state-of-the-art AI models
• Edit existing images with a text prompt (img2img)
• Multi-reference support — supply up to 3 additional reference images
• Dynamic model list — fetches available models live from your Cloudflare account
• Interactive config wizard — first-run setup guides you through credentials and model selection
• Spinner feedback, seed control, auto-open output, configurable output path

Installation

pip install imageflare

Requires Python 3.8+ and a Cloudflare account with Workers AI access.

Quick Start

# First-time setup (interactive wizard)
imageflare config

# Generate an image
imageflare generate --prompt "a red fox sitting on a snow-covered log"

# Edit an existing image
imageflare edit photo.jpg --prompt "make it look like a watercolor painting"

# Edit with extra reference images
imageflare edit photo.jpg --prompt "apply this style" --ref style.png

# Specify output path and open after saving
imageflare generate --prompt "sunset over mountains" --output sunset.png --open

Configuration

Credentials are stored at ~/.config/imageflare/config.

imageflare config            # interactive wizard
imageflare config show       # view current settings
imageflare config models     # list available AI models
imageflare config set --account-id YOUR_ID --api-token YOUR_TOKEN
imageflare config set --model "@cf/black-forest-labs/flux-1-schnell"

You'll need:

• Account ID — found on your Cloudflare dashboard (right sidebar)
• API Token — create one at My Profile → API Tokens with Workers AI: Read permission

Commands

generate

Generate an image from a text prompt.

imageflare generate [OPTIONS]

  -p, --prompt TEXT       Description of the image to generate  [required]
  -m, --model TEXT        Model ID to use
      --width INTEGER     Output width in pixels (default: 1024)
      --height INTEGER    Output height in pixels (default: 1024)
      --seed INTEGER      Random seed for reproducibility
  -o, --output PATH       Output file path (default: imageflare_<timestamp>.png)
      --open              Open the image after saving

edit

Edit an existing image using a text prompt.

imageflare edit IMAGE_PATH [OPTIONS]

  -p, --prompt TEXT       Editing instruction  [required]
  -r, --ref PATH          Additional reference image (up to 3, repeatable)
  -m, --model TEXT        Model ID to use
      --width INTEGER     Output width in pixels (default: 1024)
      --height INTEGER    Output height in pixels (default: 1024)
      --seed INTEGER      Random seed for reproducibility
  -o, --output PATH       Output file path (default: imageflare_<timestamp>.png)
      --open              Open the image after saving

config

imageflare config                         # interactive setup wizard
imageflare config show                    # print current settings
imageflare config models                  # list available models
imageflare config set --model MODEL_ID    # update a single setting
imageflare config set --account-id ID --api-token TOKEN

Models

imageflare works with any Cloudflare Workers AI text-to-image model. Your live model list is fetched automatically from the API once credentials are configured.

Default model: @cf/black-forest-labs/flux-2-klein-4b

License

MIT