How do I install the Nanobanana skill?

Run npx skillmds@latest add eyadsibai/nanobanana in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Nanobanana safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nanobanana?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nanobanana free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Nanobanana?

eyadsibai (@eyadsibai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nanobanana by eyadsibai — Agent Skill

Name: Nanobanana
Rating: 4.5 (4 reviews)
Author: eyadsibai

File contents

Nanobanana Image Generation

Generate and edit images using Google Gemini API.

Prerequisites

Requirement	Setup
API Key	Export `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

Task	Command
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

Size	Ratio	Use Case
`1024x1024`	1:1	Square, logos
`768x1344`	9:16	Portrait, stories (default)
`1344x768`	16:9	Landscape, wallpapers
`832x1248`	2:3	Portrait photos
`1248x832`	3:2	Landscape photos
`1536x672`	21:9	Ultra-wide

Use --size WIDTHxHEIGHT to specify.

Models

Model	Trade-off
`gemini-3-pro-image-preview`	Higher quality (default)
`gemini-2.5-flash-image`	Faster generation

Use --model MODEL to specify.

Resolution

Resolution	Use Case
`1K`	Testing, drafts (default)
`2K`	Good quality
`4K`	Final output, print

Use --resolution RES to specify.

Best Practices

Practice	Why
Be descriptive	Include style, mood, colors, composition
Use 1:1 for logos	Clean square format
Use 9:16 for stories	Standard mobile format
Use 16:9 for wallpapers	Standard widescreen
Start with 1K	Test before using higher resolution
Use flash model for iteration	Save time during drafting

Examples

Generate landscape:

python3 nanobanana.py --prompt "Mountain sunset with lake" --size 1344x768 --output "landscape.png"

Generate logo:

python3 nanobanana.py --prompt "Minimalist tech logo" --size 1024x1024 --output "logo.png"

Edit existing image:

python3 nanobanana.py --prompt "Add rainbow to sky" --input photo.png --output "edited.png"

High quality output:

python3 nanobanana.py --prompt "Professional portrait" --resolution 2K --output "portrait.png"

Troubleshooting

Issue	Solution
Script fails	Check `GEMINI_API_KEY` is set
No image generated	Make prompt more specific
Can't read input	Verify file exists and is readable
Can't write output	Check directory is writable

---name: nanobananadescription: Use when "nanobanana", "generate image", "create image", "edit image", "AI drawing", "Gemini image", "image generation"--- # Nanobanana Image Generation Generate and edit images using Google Gemini API. --- ## Prerequisites | Requirement | Setup | |-------------|-------| | **API Key** | Export `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 | Task | Command | |------|---------| | **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 | Size | Ratio | Use Case | |------|-------|----------| | `1024x1024` | 1:1 | Square, logos | | `768x1344` | 9:16 | Portrait, stories (default) | | `1344x768` | 16:9 | Landscape, wallpapers | | `832x1248` | 2:3 | Portrait photos | | `1248x832` | 3:2 | Landscape photos | | `1536x672` | 21:9 | Ultra-wide | Use `--size WIDTHxHEIGHT` to specify. --- ## Models | Model | Trade-off | |-------|-----------| | `gemini-3-pro-image-preview` | Higher quality (default) | | `gemini-2.5-flash-image` | Faster generation | Use `--model MODEL` to specify. --- ## Resolution | Resolution | Use Case | |------------|----------| | `1K` | Testing, drafts (default) | | `2K` | Good quality | | `4K` | Final output, print | Use `--resolution RES` to specify. --- ## Best Practices | Practice | Why | |----------|-----| | Be descriptive | Include style, mood, colors, composition | | Use 1:1 for logos | Clean square format | | Use 9:16 for stories | Standard mobile format | | Use 16:9 for wallpapers | Standard widescreen | | Start with 1K | Test before using higher resolution | | Use flash model for iteration | Save 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 | Issue | Solution | |-------|----------| | Script fails | Check `GEMINI_API_KEY` is set | | No image generated | Make prompt more specific | | Can't read input | Verify file exists and is readable | | Can't write output | Check directory is writable |

Frequently asked questions

Nanobanana