nano-banana-use

name	nano-banana-use
description	Generate, edit, and compose images using Gemini Nano Banana models via portable Python scripts. Handles authentication via API Key or Vertex AI environment variables. Available parameters: prompt, model, aspect-ratio, safety-filter-level. Always confirm parameters with the user or explicitly state defaults before running.

Nano Banana Use

Use this skill to generate, edit, and compose images using Gemini's Nano Banana models (gemini-2.5-flash-image and gemini-3-pro-image-preview).

This skill uses portable Python scripts managed by uv.

Prerequisites

Ensure you have one of the following authentication methods configured in your environment:

1. API Key:

   • GOOGLE_API_KEY or GEMINI_API_KEY

2. Vertex AI:

   • GOOGLE_CLOUD_PROJECT
   • GOOGLE_CLOUD_LOCATION
   • GOOGLE_GENAI_USE_VERTEXAI=1

Usage

Generate an Image

Step 1: Confirm Parameters Before running the script, confirm the following parameters with the user or state the defaults you will use:

• Prompt: The image description.
• Model: Default is gemini-3-pro-image-preview.
• Aspect Ratio: Default is 1:1.
• Safety Filter: Default is BLOCK_MEDIUM_AND_ABOVE.

Step 2: Run the Script Run the python script using uv:

uv run skills/nano-banana-use/scripts/generate_image.py "A futuristic banana city" --output city.png

Edit an Image

Modify an existing image based on a text prompt.

uv run skills/nano-banana-use/scripts/edit_image.py original.png "Make the sky purple" --output edited.png

Compose Images

Generate a new image based on multiple input images and a prompt.

uv run skills/nano-banana-use/scripts/compose_image.py --image style.png --image subject.jpg "A painting of the subject in the style of the first image" --output composition.png

Options

• prompt: The text description of the image.
• --model: The model to use. Defaults to gemini-3-pro-image-preview.
• --output: The filename for the saved image. Defaults to generated_image.png.
• --aspect-ratio: The aspect ratio of the generated image. Defaults to 1:1. Supported: 1:1, 16:9, 4:3, 3:4, 9:16.
• --safety-filter-level: Safety filter threshold. Defaults to BLOCK_MEDIUM_AND_ABOVE.