nano-banana

name

nano-banana

description

Use when the user asks to create or generate an image, visual, logo, thumbnail, infographic, product shot, hero image, OG image, blog/Substack header, sticker, portrait, or any text-to-image or image-generation task; edit a photo; compose multiple images; refine an image iteratively; set aspect ratio/resolution; or visualize real-time data (weather, stocks, news) with Gemini's Nano Banana Pro. Not for text generation, design feedback (design:design-critique), or template designs (Canva MCP).

Nano Banana Pro

Image generation skill powered by Google's Gemini 3 Pro Image model. Enables text-to-image generation, image editing, multi-image composition, and real-time data visualization.

Requirements

• GEMINI_API_KEY environment variable set
• Python packages: google-genai, Pillow

Install dependencies:

pip install -r requirements.txt

Quick Start

Generate an Image

python scripts/generate_image.py "A cat wearing a wizard hat" cat.png

Edit an Existing Image

python scripts/edit_image.py photo.png "Add a sunset to the background" edited.png

Compose Multiple Images

python scripts/compose_images.py "Create a group photo in an office" team.png person1.png person2.png

Available Scripts

Script	Purpose
generate_image.py	Text-to-image generation
edit_image.py	Edit/modify existing images
compose_images.py	Combine up to 14 reference images
chat_image.py	Interactive multi-turn refinement
search_grounded_image.py	Generate images with real-time search data

Generation Options

Aspect Ratios

1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

Resolutions

1K (1024px), 2K, 4K

Usage with Options

python scripts/generate_image.py "Futuristic motorcycle on Mars" mars.png --aspect 16:9 --size 4K

Task Workflows

Logo Generation

python scripts/generate_image.py "Clean black-and-white logo with text 'Daily Grind', sans-serif font, coffee bean icon, minimalist style" logo.png --aspect 1:1

Product Mockup

python scripts/generate_image.py "Studio-lit product photo on polished concrete, 3-point softbox, 45-degree angle, professional e-commerce style" product.png --aspect 4:3 --size 4K

Photorealistic Portrait

python scripts/generate_image.py "A photorealistic close-up portrait, shot on 85mm lens, golden hour lighting, shallow depth of field, cinematic" portrait.png --size 4K

Stylized Art (Anime/Sticker)

python scripts/generate_image.py "A kawaii red panda sticker, bold outlines, cel-shading, white background, cute expression" sticker.png

Iterative Design Refinement

Use the chat script for back-and-forth refinement:

python scripts/chat_image.py

Then interact:

> Create a logo for 'Acme Corp'
[Image generated]
> Make the text bolder and add a blue gradient
[Refined image]
> save acme_logo.png

Real-Time Data Visualization

Generate infographics with current data:

python scripts/search_grounded_image.py "Visualize today's weather in Tokyo as an infographic" tokyo_weather.png --aspect 9:16

Use cases:

• Live stock-market infographics
• Breaking-news visuals
• Weather dashboards
• Current event visualizations

Multi-Image Composition

Combine reference images:

python scripts/compose_images.py "Create a product comparison shot with these items side by side, professional lighting" comparison.png item1.png item2.png item3.png --aspect 16:9

Use cases:

• Product comparison shots
• Character sheets
• Team photos
• Style-consistent image series

Inline Python Usage

For integration in larger scripts:

import os
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents=["A serene mountain landscape at dawn"],
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        )
    )
)

for part in response.parts:
    if part.inline_data:
        image = part.as_image()
        image.save("landscape.png")

Editing with Inline Code

from PIL import Image
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
img = Image.open("input.png")

response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents=["Add dramatic clouds to the sky", img],
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

Prompting Tips

Photorealistic: Include camera settings, lighting, lens details

"Shot on 85mm lens, golden hour lighting, shallow depth of field"

Logos: Specify style, colors, typography

"Clean minimalist logo, sans-serif font, monochrome, vector style"

Product shots: Describe studio setup

"Studio-lit, 3-point softbox, polished surface, 45-degree angle"

Stylized art: Name the style explicitly

"Anime style, cel-shading, bold outlines, vibrant colors"