nb-cli | Generative AI Image 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.png \
  --aspect-ratio 21:9 \
  --size 2k

Command: Edit nb edit [file] [prompt]

# Modify the previous image
nb edit library.png "Add warm interior lighting visible through windows" \
-o library-edited.png

Command: Icon nb icon [prompt]

# Generate a 1:1 minimalist vector-style icon
nb icon "abstract banana" -o logo.png

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 Intelligent format handling for PNG, JPG, and WEBP outputs.

# 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>