nanobanana

[!NOTE]
Nano Banana 2 (gemini-3.1-flash-image-preview) is now the default model (v1.0.11+)!

You can still use the Pro model by setting the NANOBANANA_MODEL environment variable to gemini-3-pro-image-preview.

Nano Banana - Claude Code Plugin

A professional Claude Code plugin for generating and manipulating images using the Nano Banana models, powered by Google's Gemini image generation API.

Features

• Text-to-Image Generation: Create stunning images from descriptive prompts
• Image Editing: Modify existing images with natural language instructions
• Image Restoration: Restore and enhance old or damaged photos
• Smart File Management: User-friendly filenames with automatic duplicate prevention

Prerequisites

1. Claude Code installed and configured (setup guide)
2. Node.js 20+ and npm
3. Gemini API Key - get one from Google AI Studio

API Key Setup

Your API key is handled securely by the Claude Code plugin system. You don't need to set environment variables or create .env files.

During install: Claude Code automatically prompts you for your Gemini API key when you enable the plugin. The key is stored in your system keychain (macOS Keychain / Windows Credential Manager / Linux secret service) - never in plain text.

To change your key later:

1. Run /plugin in Claude Code
2. Go to the Installed tab
3. Select nanobanana
4. Choose configure to update your API key

The key is passed to the MCP server securely via the plugin's userConfig system.

Model Selection

The following Nano Banana models are supported:

• gemini-3.1-flash-image-preview (Nano Banana 2 - default)
• gemini-3-pro-image-preview (Nano Banana Pro)
• gemini-2.5-flash-image (Nano Banana v1)

To use a different model, set the NANOBANANA_MODEL environment variable:

export NANOBANANA_MODEL=gemini-3-pro-image-preview

Installation

Plugin Install (recommended)

Add the marketplace and install the plugin from within Claude Code:

/plugin marketplace add tayzar-tznw/claude-nanobana-plugin
/plugin install nanobanana@nanobanana

You'll be prompted for your Gemini API key during setup. That's it - all commands and the MCP server are ready to use.

Local Development Install

If you want to test or develop the plugin locally:

git clone https://github.com/tayzar-tznw/claude-nanobana-plugin
cd claude-nanobana-plugin
npm install
claude --plugin-dir .

Available Commands

Once installed, the following slash commands will be available in Claude Code (namespaced under nanobanana:):

• /nanobanana:generate - Single or multiple image generation with style/variation options
• /nanobanana:edit - Image editing
• /nanobanana:restore - Image restoration
• /nanobanana:icon - Generate app icons, favicons, and UI elements in multiple sizes
• /nanobanana:pattern - Generate seamless patterns and textures for backgrounds
• /nanobanana:story - Generate sequential images that tell a visual story or process
• /nanobanana:diagram - Generate technical diagrams, flowcharts, and architectural mockups
• /nanobanana:nanobanana - Natural language interface

Usage

The plugin provides multiple command options for different use cases:

Specific Commands (Recommended)

Generate Images:

# Single image
/generate "a watercolor painting of a fox in a snowy forest"

# Multiple variations with preview
/generate "sunset over mountains" --count=3 --preview

# Style variations
/generate "mountain landscape" --styles="watercolor,oil-painting" --count=4

# Specific variations with auto-preview
/generate "coffee shop interior" --variations="lighting,mood" --preview

Edit Images:

/edit my_photo.png "add sunglasses to the person"
/edit portrait.jpg "change background to a beach scene" --preview

Restore Images:

/restore old_family_photo.jpg "remove scratches and improve clarity"
/restore damaged_photo.png "enhance colors and fix tears" --preview

Generate Icons:

# App icon in multiple sizes
/icon "coffee cup logo" --sizes="64,128,256" --type="app-icon" --preview

# Favicon set
/icon "company logo" --type="favicon" --sizes="16,32,64"

# UI elements
/icon "settings gear icon" --type="ui-element" --style="minimal"

Create Patterns:

# Seamless pattern
/pattern "geometric triangles" --type="seamless" --style="geometric" --preview

# Background texture
/pattern "wood grain texture" --type="texture" --colors="mono"

# Wallpaper pattern
/pattern "floral design" --type="wallpaper" --density="sparse"

Generate Stories:

# Visual story sequence
/story "a seed growing into a tree" --steps=4 --type="process" --preview

# Step-by-step tutorial
/story "how to make coffee" --steps=6 --type="tutorial"