Back to Skills

nano-banana-pro

Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image). Use for image create/modify requests incl. edits. Supports text-to-image + image-to-image; 1K/2K/4K; use --input-image.

1,738stars165forksUpdated 2/10/2026

Security Assessment

Safe(100/100)
Security Score100/100

About nano-banana-pro

The nano-banana-pro skill leverages Google's Gemini 3 Pro Image API to facilitate the generation and editing of high-quality images. It solves the problem of quickly creating and modifying images through a simple, command-line interface. Users can generate entirely new images or modify existing ones based on detailed prompts and editing instructions, offering a flexible tool for various visual projects. This skill provides a streamlined workflow to help users get quick results with options for different image resolutions, all from their command line environment.

FAQ

How do I generate a new image with nano-banana-pro?

You can generate a new image by running the command: `uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 1K|2K|4K] [--api-key KEY]`.

How do I edit an existing image?

To edit an existing image, use the `--input-image` parameter with the path to your image, and provide editing instructions in the prompt. For example: `uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K] [--api-key KEY]`.

What are the resolution options for images?

The skill supports three resolution options: 1K (~1024px), 2K (~2048px), and 4K (~4096px). You can specify the resolution with the `--resolution` parameter.

What do I do if I get an 'Error: No API key provided.'?

Ensure you either pass the `--api-key` argument with your API key or set the `GEMINI_API_KEY` environment variable.

What is the filename format for generated images?

The filename format for images follows the pattern: `yyyy-mm-dd-hh-mm-ss-name.png`, where the timestamp is the current date/time and the name is a concise, descriptive label based on the image content.

Install nano-banana-pro

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill