>_ usage

commands, with the images they make

Every image command routes through one of naba's providers (Gemini, OpenRouter, or AWS Bedrock) — see config for provider and key setup. Each example below shows the exact command and the image it produced; captions note the prompt and the model used. (These are real naba outputs, mostly on the fast gemini-3.1-flash-image tier, with one on the higher-quality gemini-3-pro-image tier.)

generate

Turn a text prompt into an image.

naba generate "a red apple on a white background"

A red apple on a white background — "a red apple on a white background"gemini-3.1-flash-image

naba generate "a serene mountain lake" --style watercolor

A serene mountain lake in watercolor style — "a serene mountain landscape lake, soft watercolor painting style"gemini-3.1-flash-image

naba generate "a futuristic city skyline at dusk" --style pixel-art

A futuristic city skyline at dusk in pixel-art style — "a futuristic city skyline at dusk, pixel-art style, 16-bit"gemini-3.1-flash-image

naba generate "a sweeping desert canyon vista at golden hour" --quality high --aspect 16:9

A sweeping desert canyon vista at golden hour — "a sweeping desert canyon vista at golden hour, ultra detailed" · --aspect 16:9gemini-3-pro-image (--quality high)

Aspect ratio & resolution. --aspect and --resolution set the Gemini imageConfig and are available on all generative commands. Valid --aspect: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 (and the wide 1:4 … 8:1 extremes). Valid --resolution: 512, 1K, 2K, 4K (uppercase K). On Gemini, --quality high selects the gemini-3-pro-image tier; --quality fast (default) is gemini-3.1-flash-image.

edit

Modify an existing image with a natural-language instruction.

naba edit lake.jpg "make the sky dramatic and stormy"

Calm mountain lake under a clear sky, before edit — before input image

The same lake with a dramatic stormy sky, after edit — after"make the sky dramatic and stormy with heavy clouds"gemini-3.1-flash-image

restore

Enhance or repair an old or degraded image.

naba restore old-photo.jpg "sharpen and improve colors"

A low-quality, degraded vintage portrait, before restore — before degraded input

The restored, sharpened portrait, after restore — after"sharpen, denoise, and improve colors"gemini-3.1-flash-image

icon

Generate app icons in one or more sizes.

naba icon "rocket ship" --style flat --size 512

"rocket ship" · --style flatgemini-3.1-flash-image

pattern

Seamless, tileable textures and backgrounds.

naba pattern "circuit board" --style tech --colors mono

A seamless monochrome circuit-board pattern — "circuit board" · --style tech --colors monogemini-3.1-flash-image

story

A sequence of images that tell a visual narrative.

naba story "a small sailboat's voyage from calm harbor to open sea at sunset" --steps 3

Story frame 1: sailboat in a calm harbor — frame 1

Story frame 2: sailboat heading out — frame 2

Story frame 3: sailboat on the open sea at sunset — frame 3

"a small sailboat's voyage from calm harbor to open sea at sunset" · --steps 3 · gemini-3.1-flash-image

diagram

Rendered technical diagrams from a description.

naba diagram "user authentication flow" --type flowchart

A user authentication flowchart — "user authentication flow" · --type flowchartgemini-3.1-flash-image

provider

List the registered providers and which have resolvable credentials. A * marks the provider a bare image call would use (the effective default); each row shows its credential status and effective default model.

naba provider
naba provider --json          # machine-readable {status, data} envelope

models

List a provider's available models via a live API call. With no --provider, it lists the resolved default provider's models; pass --provider to target another (it needs a resolvable key for that provider).

naba models                       # the default provider's models
naba models --provider bedrock    # a specific provider's models
naba models --provider openrouter --json

Managing the binary itself — naba self update, naba doctor, and the naba skills lifecycle — lives on the config page.