nanobanana

Original🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

Use when "nanobanana", "generate image", "create image", "edit image", "AI drawing", "Gemini image", "image generation"

2installs
Added on

NPX Install

npx skill4agent add eyadsibai/ltk nanobanana

Tags

Translated version includes tags in frontmatter

Nanobanana Image Generation

Generate and edit images using Google Gemini API.

Prerequisites

RequirementSetup
API KeyExport
GEMINI_API_KEY
or add to
~/.nanobanana.env
Dependencies
pip install google-genai Pillow python-dotenv
Script
${CLAUDE_PLUGIN_ROOT}/skills/core/nanobanana/nanobanana.py

Basic Usage

TaskCommand
Generate image
python3 nanobanana.py --prompt "description" --output "file.png"
Edit image
python3 nanobanana.py --prompt "changes" --input source.png --output "edited.png"

Aspect Ratios

SizeRatioUse Case
1024x1024
1:1Square, logos
768x1344
9:16Portrait, stories (default)
1344x768
16:9Landscape, wallpapers
832x1248
2:3Portrait photos
1248x832
3:2Landscape photos
1536x672
21:9Ultra-wide
Use
--size WIDTHxHEIGHT
to specify.

Models

ModelTrade-off
gemini-3-pro-image-preview
Higher quality (default)
gemini-2.5-flash-image
Faster generation
Use
--model MODEL
to specify.

Resolution

ResolutionUse Case
1K
Testing, drafts (default)
2K
Good quality
4K
Final output, print
Use
--resolution RES
to specify.

Best Practices

PracticeWhy
Be descriptiveInclude style, mood, colors, composition
Use 1:1 for logosClean square format
Use 9:16 for storiesStandard mobile format
Use 16:9 for wallpapersStandard widescreen
Start with 1KTest before using higher resolution
Use flash model for iterationSave time during drafting

Examples

Generate landscape:
bash
python3 nanobanana.py --prompt "Mountain sunset with lake" --size 1344x768 --output "landscape.png"
Generate logo:
bash
python3 nanobanana.py --prompt "Minimalist tech logo" --size 1024x1024 --output "logo.png"
Edit existing image:
bash
python3 nanobanana.py --prompt "Add rainbow to sky" --input photo.png --output "edited.png"
High quality output:
bash
python3 nanobanana.py --prompt "Professional portrait" --resolution 2K --output "portrait.png"

Troubleshooting

IssueSolution
Script failsCheck
GEMINI_API_KEY
is set
No image generatedMake prompt more specific
Can't read inputVerify file exists and is readable
Can't write outputCheck directory is writable