nano-banana

**Generate and edit images right inside Claude Code, powered by Google Gemini 3.1**
*Describe what you want. Get an image back. It's that simple.*
Features · Install · Get Started · Examples · Models · Contributing
---
---
What is this?
Nano Banana lets you create and edit images without ever leaving Claude Code. Just type what you want in plain English and the plugin handles the rest — picking the right model, enhancing your prompt, and saving the result.
That's a real command. It works exactly like that. No config files, no boilerplate, no switching between tools.
Under the hood it uses Google's Gemini 3.1 Flash for fast generation and Gemini 3 Pro when you need high-resolution output. You don't need to think about which model to use — Nano Banana picks the right one automatically.
Part of the **Ibrahim Plugins** collection for Claude Code, alongside SupaConductor for multi-agent orchestration.
---
Features
- **Text-to-image** — describe anything, get an image back
- **Image editing** — "replace the sky with a sunset" and it just works, no masks needed
- **Style transfer** — apply the look of one image to another
- **Multi-image composition** — blend up to 14 reference images for consistent characters and scenes
- **High-resolution output** — go up to 4K for professional assets
- **Search-grounded generation** — images informed by real-time Google Search data
- **Every aspect ratio** — 1:1, 16:9, 9:16, 4:3, 21:9, and more
- **Iterative editing** — keep refining your image through conversation
All of this runs through a single /genimage command. The agent figures out which mode you need from context.
---
Installation
The quickest way:
Or clone it yourself:
Restart Claude Code after installing to activate the plugin.
---
Get Started
You'll need a Gemini API key. It's free — grab one at Google AI Studio if you don't have one already.
Then inside Claude Code:
That's it. Your image gets saved to the current directory. From here you can keep generating, edit what you've made, or try any of the examples below.
---
Usage Examples
Create images from text
Go high-res (2K / 4K)
Just mention the resolution — the plugin switches to the Pro model automatically:
Edit existing images
All editing is text-guided. Describe the change you want and Nano Banana figures out what to modify:
Iterate on your work
Generate a base image, then keep refining it:
You can chain as many edits as you like — each one builds on the last.
---
Models
Nano Banana uses two Gemini models and picks the right one for you:
| Model | We call it | When it's used |
|-------|-----------|----------------|
| gemini-3.1-flash-image-preview | **Nano Banana 2** | Everything by default — fast, versatile, great quality |
| gemini-3-pro-image-preview | **Nano Banana Pro** | When you ask for 2K or 4K resolution |
You don't need to select a model manually. If you pass --resolution 2K or --resolution 4K, Pro kicks in automatically.
---
Under the Hood
Everything runs through one Python script:
The mode is determined by the flags you pass: