Create, edit, compare, and review Gemini images from Claude Code.
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.
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.
- Ask: describe the outcome in normal language.
- Plan: Banana Claude builds the visual brief and chooses a route.
- Review: inspect the prompt, references, privacy settings, and estimate.
- Approve: one short-lived approval authorizes one provider attempt.
- Create: the image and a privacy-conscious metadata sidecar are saved.
- Check: review the actual pixels, then fix, regenerate, or ship.
- 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.
- 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.
- User guide: installation, upgrades, workflows, and direct scripts
- Prompt craft: visual briefs, consistency, composition, and recovery
- MCP tools: planning and execution contracts
- Security: credentials, approvals, outputs, state, and reporting
- Changelog, version 3.1 release notes, and version 3 release notes
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.
MIT License, see LICENSE.
Built by Agrici Daniel, AI Workflow Architect.
Blog · AI Marketing Hub · YouTube · More open-source projects
