Banana Claude

AI image generation skill for Claude Code where Claude acts as Creative Director using Google's Gemini Nano Banana models.

Unlike simple API wrappers, Claude interprets your intent, selects domain expertise, constructs optimized prompts using Google's official 5-component formula, and orchestrates Gemini for the best possible results.

Blog: See banana-claude in action

• Installation
• Quick Start
• Commands
• How It Works
• What Makes This Different
• The 5-Component Prompt Formula
• Domain Modes
• Models
• Architecture
• Requirements
• Changelog
• Contributing
• License

Installation

Plugin Install (Recommended)

Add the marketplace and install:

/plugin marketplace add AgriciDaniel/banana-claude
/plugin install banana-claude@banana-claude-marketplace

Or test locally:

git clone --depth 1 https://github.com/AgriciDaniel/banana-claude.git
claude --plugin-dir ./banana-claude

git clone --depth 1 https://github.com/AgriciDaniel/banana-claude.git
bash banana-claude/install.sh

One-liner (curl):

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/banana-claude/main/install.sh | bash

With MCP Setup:

git clone --depth 1 https://github.com/AgriciDaniel/banana-claude.git
cd banana-claude
./install.sh --with-mcp YOUR_API_KEY

Get a free API key at Google AI Studio.

Quick Start

# Start Claude Code
claude

# Generate an image
/banana generate "a hero image for a coffee shop website"

# Edit an existing image
/banana edit ~/photo.png "remove the background"

# Multi-turn creative session
/banana chat

# Browse 2,500+ prompt database
/banana inspire

Claude will ask about your brand, select the right domain mode (Cinema, Product, Portrait, Editorial, UI, Logo, Landscape, Infographic, Abstract), construct a detailed prompt with lighting and composition, set the right aspect ratio, and generate.

Commands

How It Works

What Makes This Different

• Intent Analysis -- Understands what you actually need (blog header? app icon? product shot?)
• Domain Expertise -- Selects the right creative lens (Cinema, Product, Portrait, Editorial, UI, Logo, Landscape, Infographic, Abstract)
• 5-Component Prompt Formula -- Constructs prompts with Subject + Action + Location/Context + Composition + Style (includes lighting)
• Prompt Adaptation -- Translates patterns from a 2,500+ curated prompt database to Gemini's natural language format
• Post-Processing -- Crops, removes backgrounds, converts formats, resizes for platforms
• Batch Variations -- Generates N variations rotating different components
• Session Consistency -- Maintains character/style across multi-turn conversations
• 4K Resolution Output -- Up to 4096×4096 with imageSize control
• 14 Aspect Ratios -- Including ultra-wide 21:9 for cinematic compositions

The 5-Component Prompt Formula

Instead of sending "a cat in space" to Gemini, Claude constructs:

A medium shot of a tabby cat floating weightlessly inside the cupola module
of the International Space Station, paws outstretched toward a floating
droplet of water, Earth visible through the circular windows behind. Soft
directional light from the windows illuminates the cat's fur with a
blue-white rim light, while the interior has warm amber instrument panel
glow. Captured with a Canon EOS R5, 35mm f/2.0 lens, slight barrel
distortion emphasizing the curved module interior. In the style of a
National Geographic cover story on the ISS, with the sharp documentary
clarity of NASA mission photography.

Components used: Subject (tabby cat, physical detail) → Action (floating, paw gesture) → Location/Context (ISS cupola, Earth visible) → Composition (medium shot, curved framing) → Style (Canon R5, National Geographic documentary, directional window light + amber instruments)

Domain Modes

Models

Architecture

banana-claude/                         # Claude Code Plugin
├── .claude-plugin/
│   ├── plugin.json                    # Plugin manifest
│   └── marketplace.json               # Marketplace catalog
├── skills/banana/                     # Main skill
│   ├── SKILL.md                       # Creative Director orchestration (v1.4)
│   ├── references/
│   │   ├── prompt-engineering.md      # 5-component formula, banned keywords, safety rephrase
│   │   ├── gemini-models.md           # Model specs, rate limits, capabilities
│   │   ├── mcp-tools.md              # MCP tool parameters and responses
│   │   ├── post-processing.md        # ImageMagick/FFmpeg pipelines, green screen
│   │   ├── cost-tracking.md          # Pricing table, usage guide
│   │   └── presets.md                # Brand preset schema and examples
│   └── scripts/
│       ├── setup_mcp.py              # Configure MCP in Claude Code
│       ├── validate_setup.py         # Verify installation
│       ├── generate.py               # Direct API fallback -- generation
│       ├── edit.py                   # Direct API fallback -- editing
│       ├── cost_tracker.py           # Cost logging and summaries
│       ├── presets.py                # Brand/style preset management
│       └── batch.py                  # CSV batch workflow parser
└── agents/
    └── brief-constructor.md           # Subagent for prompt construction

Requirements

• Claude Code
• Node.js 18+ (for npx)
• Google AI API key (free tier: ~5-15 RPM / ~20-500 RPD, cut ~92% Dec 2025)
• ImageMagick (optional, for post-processing)

Uninstall

Plugin:

/plugin uninstall banana-claude@banana-claude-marketplace

Standalone:

bash banana-claude/install.sh --uninstall

Contributing

Contributions welcome! Please open an issue or submit a pull request.

License

MIT License -- see LICENSE for details.

Built for Claude Code by @AgriciDaniel