01 / GENERATE↗
Start from words
Turn a prompt into production-ready artwork with explicit size and aspect-ratio controls.
Nano Banana, bottled for the terminal
Your image studio has a command line.
Generate, edit, and art-direct images with Google Gemini models—without breaking your creative flow.
v2.1.0 · Node.js 22+ · MIT licensed · built for humans and agents
TEXT
TO
IMAGE
TO
IMAGE
UP TO
4K
4K
Try it
$ npm install -g @crapthings/nb-cli
Three focused tools
Create. Change. Ship.
nb-cli turns Gemini's image models into predictable terminal commands for new visuals, precise edits, and clean app icons.
02 / EDIT↗
Edit with intent
Bring an existing image and describe the exact change in natural language.
03 / ICON↗
Make the mark
Generate a focused 1:1 icon with prompt guidance tailored to simple visual identities.
Direct the model
Fast drafts or full-resolution detail.
Choose the model that fits the moment. Nano Banana 2.1 is the default, with 1K output and support for 2K and 4K. Use Lite for fast 1K exploration, or select nano-banana-2 for 512 drafts.
DEFAULT · NANO BANANA 2.1LITE · FAST 1K1K → 4K
creative-session — zsh
# Generate a cinematic wide image nb generate "a glass pavilion in a pine forest" \ --size 2k --aspect-ratio 16:9 \ --output pavilion.jpg # Change only the atmosphere nb edit pavilion.jpg \ "replace daylight with blue hour" \ --output pavilion-blue.jpg # Fast 1K concept nb generate "playful banana sticker" --model lite
Shape the frame
Built for real deliverables.
From app icons to ultrawide hero art, choose a useful resolution and a composition that already fits its destination.
Resolution
Aspect ratios
21:916:94:33:21:14:53:49:161:41:8
For coding agents
Give your agent an art department.
The bundled Codex skill teaches agents how to frame prompts, choose image parameters, and use nb-cli inside a project workflow.
npx skills add https://github.com/crapthings/nb-cli --skill nb-cli
Your next image starts here