v0.4.1 Python 3.12+ MIT License CLI

Lumina: High-Resolution Image Generation with Gemini 3 Pro & Flash Image

A CLI tool for generating and editing images using Google's Gemini 3 Pro Image (gemini-3-pro-image, Nano Banana Pro) and Gemini 3.1 Flash Image models via the modern google-genai SDK.

uv tool install --python 3.12 git+https://github.com/charles-forsyth/lumina.git

View Repository Explore Terminal Output

Key Capabilities

Designed and tuned for modern terminal workflows and automated pipelines.

✨

Gemini 3 Pro & Flash Image

State-of-the-art image synthesis powered by Google's Nano Banana Pro and Nano Banana 2 models.

✨

Inpainting & Reference Editing

Modify existing images or compose visual elements from multiple input reference photos.

✨

Automated Prompt Optimization

Optionally rewrite terse prompts or raw datasets into rich visual descriptors with Gemini 3.8 Flash.

✨

High-Res 1K, 2K & 4K Output

Flexible aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4) and strict image count guarantees.

Terminal Showcase

Real, unmodified terminal outputs captured directly from the CLI engine.

lumina --help

Usage Examples

Quick command recipes for terminal operations.

Basic Generation with Style

Generate styled image with cinematic lighting:

lumina -p "A city street" --style "Cyberpunk" --variation "Cinematic Lighting"

Image Modification

Edit an existing reference image:

lumina -p "Add a red hat to the cat" -i cat.png

4K Widescreen Output

High-resolution 4K render at 16:9:

lumina -p "Deep space fleet battle" --aspect-ratio "16:9" --image-size "4K"

Piping & Prompt Optimization

Pipe data from stdin with AI prompt expansion:

echo "A futuristic street food vendor" | lumina --optimize

Citation

If you use this tool in your research or applications, please cite:

Forsyth, C. E. III (2026). Lumina: Modernized Gemini Image Generation CLI (Version 0.4.1) [Computer software]. University of California, Riverside. https://doi.org/10.5281/zenodo.23755685

@software{forsyth2026lumina,
  author       = {Forsyth, Charles E. III},
  title        = {Lumina: Modernized Gemini Image Generation CLI},
  version      = {0.4.1},
  year         = {2026},
  publisher    = {Zenodo},
  affiliation  = {University of California, Riverside},
  doi          = {10.5281/zenodo.23755685},
  url          = {https://github.com/charles-forsyth/lumina}
}