banana-claude

AI image generation skill for Claude Code - Creative Director powered by Gemini

Automatically checked · GitHub checked 2026-11-12

Overview

Banana Claude character cycling through thirty artistic urban looks while the Banana Claude title and pixel banana remain fixed

Banana Claude

Create, edit, compare, and review Gemini images from Claude Code.

Validation Version 3.1.0 MIT License

Banana Claude turns a plain-language creative request into a planned and reviewable Gemini image workflow. It shows the prompt, model, data settings, output destination, and nominal estimate before any paid request.

Start here

Requirements: Claude Code 2.1.199 or newer, Python 3.11 or newer with python3 on PATH, and a Gemini API key for a billing-enabled Google AI project. Image generation and editing run on Linux and macOS. Native Windows is not yet supported because output publication needs an atomic no-replace rename that the client does not implement there; planning fails with output_exclusive_rename_unavailable before any provider call. Use WSL on Windows.

/plugin marketplace add AgriciDaniel/banana-claude
/plugin install banana-claude@banana-claude-marketplace
/plugin enable banana-claude@banana-claude-marketplace
/reload-plugins

Then ask for the image you want:

/banana-claude:banana generate an urban 16:9 GitHub hero with clean left-side copy space

Banana Claude plans offline first. Review the exact plan, then approve the paid request when it matches your intent.

The workflow is simple

  1. Ask: describe the outcome in normal language.
  2. Plan: Banana Claude builds the visual brief and chooses a route.
  3. Review: inspect the prompt, references, privacy settings, and estimate.
  4. Approve: one short-lived approval authorizes one provider attempt.
  5. Create: the image and a privacy-conscious metadata sidecar are saved.
  6. Check: review the actual pixels, then fix, regenerate, or ship.

What you can make

  • Generate: campaign visuals, covers, product scenes, diagrams, concepts, social assets, and more.
  • Edit: make one clear change while protecting identity, geometry, and brand details.
  • Continue: iterate with stored Nano Banana 2.1 or Pro sessions, or attach the last result as a fresh reference.
  • Compare: test up to three prompts across three model routes in one bounded portfolio.
  • Review: check copy, crop, composition, consistency, artifacts, rights, and provenance.
  • Typeset: add approved copy, fonts, logos, and trusted raster art locally when exact text matters.

Banana Claude routes across Google's current Nano Banana 2.1 (the default), Nano Banana 2 Lite, and Nano Banana Pro models, and keeps the deprecated Nano Banana 2 route only for 512 drafts. See the dated Gemini model reference for current capabilities and pricing.

Built for control

  • The plugin installs disabled because image generation is a paid service.
  • API keys stay out of commands, request URLs, metadata, and public CI.
  • Every paid tool shows its plan and requires a user decision before execution.
  • One approval permits one provider attempt. A changed plan needs a new approval.
  • Cost records stay private and omit raw prompts by default.
  • Generated output is never treated as automatically correct or production ready.

Gemini output is probabilistic. Banana Claude cannot guarantee consistency, spelling, geometry, policy acceptance, rights clearance, or a final invoice. Those remain review conditions, not marketing claims.

Read Security and privacy before production use.

Documentation

Contributing

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request. For help or a reproducible bug, open an issue without keys, private media, or full environment dumps.

License

MIT License, see LICENSE.

Built by Agrici Daniel, AI Workflow Architect.

Blog · AI Marketing Hub · YouTube · More open-source projects