v1.0.3 • Powered by Google Gemini

AI-Native Image Engineering from your CLI.

Integrate the power of Nano Banana (Gemini 3.1 Flash Image Preview) directly into your terminal workflow. Create, edit, and optimize images with professional-grade precision.

$ npm install -g @crapthings/nb-cli

High-Fidelity Generation

Leverage Gemini's advanced latent diffusion to generate assets ranging from photorealistic environments to minimalist icons.

Semantic Editing

Modify existing images using natural language. Update styles, add objects, or change lighting without leaving your terminal.

Workflow Optimized

Support for standard resolutions (512 to 4k) and multiple aspect ratios (21:9 to 1:8). Ready for CI/CD and automation scripts.

CLI Reference

Powerful commands designed for intuitive use.

Command: Generate nb generate [prompt]
# Generate a ultra-wide cinematic landscape
nb generate "A brutalist concrete library in a misty forest" \
  --output library.jpg \
  --aspect-ratio 21:9 \
  --size 2k
Command: Edit nb edit [file] [prompt]
# Modify the previous image
nb edit library.jpg "Add warm interior lighting visible through windows" \
  -o library-edited.jpg
Command: Icon nb icon [prompt]
# Generate a 1:1 minimalist vector-style icon
nb icon "abstract banana" -o logo.jpg

Install The `nb-cli` Skill

If you use Codex skills, install the bundled nb-cli skill from this repository so your agent can use the CLI with the repo's prompt guidance and image-generation references.

npx skills add https://github.com/crapthings/nb-cli --skill nb-cli
Example Triggers
  • Use $nb-cli to generate a 16:9 SaaS hero image with soft daylight and editorial composition
  • Use $nb-cli to create a minimalist coffee cup icon for my app
  • Use $nb-cli to edit hero.jpg and change only the background to a warm sunset gradient
Why Install It
  • Use the CLI from agent workflows without leaving the terminal.
  • Reuse the repo's still-image prompt guidance for framing, lighting, composition, and style.
  • Keep image-generation requests aligned with the bundled skills/nb-cli skill.

Shout-out to grokfilm.app. The bundled still-image technique references were inspired by the film and photography vocabulary collected there.

Built for scale.

The nb-cli is built on the latest Node.js runtime and leverages the Gemini API's streaming capabilities for fast response times and efficient resource management.

  • StandardJS Compliant Clean, idiomatic codebase following modern JavaScript standards.
  • MIME Type Detection Use `.jpg` filenames for generated and edited images.
# Configuration
export GEMINI_API_KEY=your_key
# Verification
nb generate --help
Usage: nb generate [options] [prompt]

Options:
  -o, --output <path>
  -s, --size <size>
  -a, --aspect-ratio <ratio>