mcpField
N
nano-banana

nano-banana

github.com/dennisonbertramCreative & media960 installsUpdated 41w ago
Repository

About nano-banana

nano-banana is a skill for generating images with Google's Gemini Image models. It enhances prompts before generation and supports settings for resolution, aspect ratio, and output path.

Key features

  1. 01Enhance image-generation prompts
  2. 02Generate 1K, 2K, or 4K images
  3. 03Set image aspect ratio
  4. 04Choose an output path
  5. 05Generate in the background and notify on completion

Use cases

  1. 01Generate an image from a brief description
  2. 02Create a widescreen wallpaper or vertical image
  3. 03Save a generated image to a chosen location

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dennisonbertram/claude-media-skills --skill nano-banana

After installing, type/nano-bananain Claude Code to confirm it loaded.

Bundled filesPROMPTING.mdscripts/generate.sh

Details

From the project README

Nano-Banana Image Generation

Generate images using Google's Gemini Image models.

IMPORTANT: Enhance User Prompts

Before generating, always enhance the user's prompt using the techniques in PROMPTING.md.

Quick Enhancement Formula

[Subject] + [Style] + [Lighting] + [Composition] + [Quality]

Example Enhancement
  • User says: "a cat"
  • Enhanced: "A fluffy orange tabby cat with bright green eyes, photorealistic, soft natural window lighting, shallow depth of field, rule of thirds composition"

For detailed prompting techniques, templates, and style keywords, see PROMPTING.md.

Quick Start

~/.claude/skills/nano-banana/scripts/generate.sh "your prompt here"

Options

OptionDescriptionDefault
--output PATHSave to specific file~/Pictures/nano-banana/<timestamp>.png
--size SIZEResolution: 1K, 2K, 4K1K
--aspect RATIOAspect ratio1:1
--flashUse Flash model (faster, lower quality)Pro
Aspect Ratios

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3

Resolutions
  • 1K - Standard (default, fast)
  • 2K - High resolution (requires Pro model)
  • 4K - Maximum resolution (requires Pro model)

Interpreting User Requests

Parse the user's request and map to script options:

User saysScript call
"Generate a cat"generate.sh "a cat"
"Create a 4K image of mountains"generate.sh "mountains" --size 4K
"Make a landscape wallpaper"generate.sh "landscape" --aspect 16:9
"High quality portrait of a robot"generate.sh "portrait of a robot" --pro --aspect 3:4
"Generate a sunset, save to desktop"generate.sh "a sunset" --output ~/Desktop/sunset.png
"4K widescreen cyberpunk city"generate.sh "cyberpunk city" --size 4K --aspect 16:9
Keywords to watch for:
  • Resolution: "4K", "high res", "high resolution", "2K", "large" → use --size
  • Quality: "high quality", "detailed", "professional" → use --pro
  • Orientation: "landscape", "widescreen", "wallpaper" → --aspect 16:9
  • Orientation: "portrait", "vertical", "phone wallpaper" → --aspect 9:16
  • Save location: "save to", "put it in", "output to" → --output

Behavior

  • Runs in background (won't block Claude)
  • Sends macOS notification when complete
  • Auto-opens the image when done
  • Images saved to ~/Pictures/nano-banana/ by default

Troubleshooting

Check the error log:

cat ~/.claude/skills/nano-banana/last-error.log

Verify API key:

security find-generic-password -a "$USER" -s "GEMINI_API_KEY" -w | head -c 10

Comments

Markdown supported