AI image generation & editing for Claude Code powered by Google Gemini 3.1 API. Text-to-image, inpainting, style transfer, 4K upscaling, search grounding, and multi-reference composition.

version
2.1.0
GitHub stars
384

Install

/plugin install nano-banana@ibrahim-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Ibrahim-3d/orchestrator-supaconductor.

Contents

Discovered from source

Skills 1

Nano Banana — Image Generation

Generate and edit images via the Gemini API. If the API key is missing, run /nano-banana:setup.

Workflow

  1. Determine the mode from the user's request:

    • Creating a new image from text? → Text-to-image (no --images)
    • Editing/retouching an existing image? → Image editing (--images source.png)
    • Applying one image's style to another? → Style transfer (--images style.png target.png)
    • Combining or referencing multiple images? → Multi-image (--images a.png b.png ..., up to 14)
    • Need 2K or 4K output? → Add --resolution 2K|4K to any mode above
  2. Craft the prompt — describe the desired result narratively. See references/prompting-guide.md for domain-specific patterns (website visuals, placeholders, product shots, etc.).

  3. Run the script:

python "$CLAUDE_PLUGIN_ROOT/scripts/genimage.py" --prompt "..." [options]
  1. Show the result — read the output image and present it to the user.

Flags

FlagRequiredPurpose
--prompt "text"YesDescribe the desired image
--output file.pngNoOutput path (default: generated_image.png)
--images path [...]NoInput image(s) — omit for text-to-image
--aspect-ratio RATIONo1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9
--resolution RESNo1K 2K 4K (uppercase K required, triggers Pro model)

Models

  • Nano Banana 2 (gemini-3.1-flash-image-preview): Default. Fast, high-quality.
  • Nano Banana Pro (gemini-3-pro-image-preview): Auto-selected when --resolution is set. 4K output, advanced reasoning, high-fidelity text rendering.

Common Use Cases → Flags

Use caseExample command
Website hero image--prompt "..." --aspect-ratio 16:9
Social media post--prompt "..." --aspect-ratio 1:1
Mobile banner--prompt "..." --aspect-ratio 9:16
Placeholder / mockup--prompt "..." --output placeholder.png
Edit existing photo--prompt "remove the background" --images photo.png
Style transfer--prompt "Apply watercolor style" --images style.png photo.png
High-res asset--prompt "..." --resolution 4K

Editing

All editing is text-guided — describe what to change ("replace the sky", "remove the person", "add a sunset") and Gemini identifies and modifies regions automatically. No masks needed.

Commands 2

Generate or edit an image using the Nano Banana script.

User request: $ARGUMENTS

Task

  1. Determine the mode from the request.
  2. Craft a descriptive prompt (narrative, not keywords). For detailed templates, read $CLAUDE_PLUGIN_ROOT/skills/genimage/references/prompting-guide.md.
  3. Run the script with correct flags.
  4. Show the result to the user.
python "$CLAUDE_PLUGIN_ROOT/scripts/genimage.py" --prompt "..." [options]

Mode → Flags

ModeFlags
Text-to-image--prompt "..." only
Image editing--prompt "edit instructions" --images source.png
Style transfer--prompt "Apply style..." --images style.png target.png
Multi-image composition--prompt "..." --images a.png b.png [...] (up to 14)
High-resolutionadd --resolution 2K or 4K to any mode (triggers Pro model)

All Flags

FlagRequiredDefault
--prompt "text"Yes—
--output file.pngNogenerated_image.png
--images path [...]No—
--aspect-ratio RATIONo—
--resolution 1K|2K|4KNo—

Aspect ratios: 1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9

Editing is text-guided — describe what to change and Gemini handles region detection automatically.

If the script fails due to a missing API key, advise the user to run /nano-banana:setup.

I will help you set up your Gemini API key for Nano Banana.

If you already have your key, you can provide it as an argument: /nano-banana:setup YOUR_KEY

Otherwise, I will ask you for it now.

Your Task

  1. Check if an API key was provided in $ARGUMENTS.
  2. If not, use AskUserQuestion to get it (inform the user they can get one for free at https://aistudio.google.com/apikey).
  3. Run: python "$CLAUDE_PLUGIN_ROOT/scripts/setup_key.py" <key>
  4. Confirm to the user that setup is complete.

Agents 1

Image Generation Agent

Generate and edit images via the Gemini API (Nano Banana 2 / Pro). Craft effective prompts, pick the right flags, and deliver the result.

Script

python "$CLAUDE_PLUGIN_ROOT/scripts/genimage.py" --prompt "..." [options]

Mode Selection

ModeFlags
Text-to-image--prompt "..." (no --images)
Image editing--prompt "edit instructions" --images source.png
Style transfer--prompt "Apply style..." --images style.png target.png
Multi-image composition--prompt "..." --images a.png b.png [...] (up to 14)
High-resolutionadd --resolution 2K or 4K to any mode

Default model: Nano Banana 2 (flash). --resolution auto-selects Nano Banana Pro.

Flags

FlagRequiredPurpose
--prompt "text"YesDescribe the desired image
--output file.pngNoOutput path (default: generated_image.png)
--images path [...]NoInput image(s) — omit for text-to-image
--aspect-ratio RATIONo1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9
--resolution RESNo1K 2K 4K (uppercase K, triggers Pro model)

Prompting

  • Describe scenes narratively, not as keyword lists
  • Photorealistic: specify camera angle, lens, lighting, textures
  • Illustrations: specify art style, color palette, medium
  • Text in images: put text in quotes, specify font style (use --resolution 2K+ for best text)
  • Edits: be specific about what to change AND what to preserve
  • Website visuals: mention intended use (hero, card, thumbnail) and color palette
  • For detailed prompt templates, read $CLAUDE_PLUGIN_ROOT/skills/genimage/references/prompting-guide.md

Sponsors

Details

Marketplace
Ibrahim-3d/orchestrator-supaconductor
Source
Ibrahim-3d/nano-banana-claude-plugin
Author
Ibrahim
Category
Creative
License
MIT
Keywords
image-generation, gemini, gemini-3.1, ai-art, text-to-image, image-editing, style-transfer, 4k-generation, multi-reference, nano-banana, claude-code-plugin

More from Ibrahim-3d/orchestrator-supaconductor

All 2