claude-banana

<!-- Updated: 2026-03-19v2 -->  # 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. [](https://claude.ai/claude-code) [](CHANGELOG.md) [](LICENSE) > **Blog:** [See banana-claude in action](https://agricidaniel.com/blog/banana-claude-ai-image-generation) <details> <summary>Table of Contents</summary> - [Installation](#installation) - [Quick Start](#quick-start) - [Commands](#commands) - [How It Works](#how-it-works) - [What Makes This Different](#what-makes-this-different) - [The 5-Component Prompt Formula](#the-5-component-prompt-formula) - [Domain Modes](#domain-modes) - [Models](#models) - [Architecture](#architecture) - [Requirements](#requirements) - [Changelog](CHANGELOG.md) - [Contributing](#contributing) - [License](#license) </details> ## Installation ### Plugin Install (Recommended) Add the marketplace and install: ```shell /plugin marketplace add AgriciDaniel/banana-claude /plugin install banana-claude@banana-claude-marketplace ``` Or test locally: ```bash git clone --depth 1 https://github.com/AgriciDaniel/banana-claude.git claude --plugin-dir ./banana-claude ``` <details> <summary>Standalone Install (without plugin system)</summary> ```bash git clone --depth 1 https://github.com/AgriciDaniel/banana-claude.git bash banana-claude/install.sh ``` **One-liner (curl):** ```bash curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/banana-claude/main/install.sh | bash ``` **With MCP Setup:** ```bash git clone --depth 1 https://github.com/AgriciDaniel/banana-claude.git cd banana-claude ./install.sh --with-mcp YOUR_API_KEY ``` </details> Get a free API key at [Google AI Studio](https://aistudio.google.com/apikey). ## Quick Start ```bash # 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 | Command | Description | |---------|-------------| | `/banana` | Interactive -- Claude detects intent and guides you | | `/banana generate <idea>` | Full Creative Director pipeline | | `/banana edit <path> <instructions>` | Intelligent image editing | | `/banana chat` | Multi-turn visual session (maintains consistency) | | `/banana inspire [category]` | Browse 2,500+ prompt database | | `/banana batch <idea> [N]` | Generate N variations (default: 3) | | `/banana setup` | Configure MCP and API key | | `/banana preset [list\|create\|show\|delete]` | Manage brand/style presets | | `/banana cost [summary\|today\|estimate]` | View cost tracking and estimates | ## 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  | Mode | Best For | Example | |------|----------|---------| | **Cinema** | Dramatic, storytelling | "A noir detective scene in a rain-soaked alley" | | **Product** | E-commerce, packshots | "Photograph my handmade candle for Etsy" | | **Portrait** | People, characters | "A cyberpunk character portrait for my game" | | **Editorial** | Fashion, lifestyle | "Vogue-style fashion shot for my brand" | | **UI/Web** | Icons, illustrations | "A set of onboarding illustrations" | | **Logo** | Branding, identity | "A minimalist logo for a tech startup" | | **Landscape** | Backgrounds, wallpapers | "A misty mountain sunrise for my desktop" | | **Infographic** | Data, diagrams | "Visualize our Q1 sales growth" | | **Abstract** | Generative art, textures | "Voronoi tessellation in neon gradients" | ## Models | Model | ID | Notes | |-------|----|-------| | Flash 3.1 (default) | `gemini-3.1-flash-image-preview` | Fastest, newest, 14 aspect ratios, up to 4K | | Flash 2.5 | `gemini-2.5-flash-image` | Stable fallback | ## 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](https://github.com/anthropics/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:** ```shell /plugin uninstall banana-claude@banana-claude-marketplace ``` **Standalone:** ```bash bash banana-claude/install.sh --uninstall ``` ## Contributing Contributions welcome! Please open an issue or submit a pull request. ## License MIT License -- see [LICENSE](LICENSE) for details. --- Built for Claude Code by [@AgriciDaniel](https://github.com/AgriciDaniel) --- ## Author Built by [Agrici Daniel](https://agricidaniel.com/about) - AI Workflow Architect. - [Blog](https://agricidaniel.com/blog) - Deep dives on AI marketing automation - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub) - Free community, 2,800+ members - [YouTube](https://www.youtube.com/@AgriciDaniel) - Tutorials and demos - [All open-source tools](https://github.com/AgriciDaniel)