Skip to content
Back to search

nano-banana-2-skill-marketplace

MarketplaceWorks with Claude CodeGitHub

AI image generation CLI powered by Gemini 3 Pro. Green screen transparency, reference images, style transfer. Also a Claude Code plugin.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kingbootoshi--nano-banana-2-skill/badge.svg)](/listings/kingbootoshi--nano-banana-2-skill)

HTML

<a href="/listings/kingbootoshi--nano-banana-2-skill"><img src="/api/listings/kingbootoshi--nano-banana-2-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Requirements:** [Bun](https://bun.sh), [FFmpeg](https://ffmpeg.org) + [ImageMagick](https://imagemagick.org) (for transparent mode)

# Clone the repo
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2
cd ~/tools/nano-banana-2

# Install dependencies
bun install

# Link globally (no sudo needed - uses Bun's global bin)
bun link

# Set up your API key
mkdir -p ~/.nano-banana
echo "GEMINI_API_KEY=your_key_here" > ~/.nano-banana/.env

Get a Gemini API key at [Google AI Studio](https://aistudio.google.com/apikey).

Now you can use `nano-banana` from anywhere.

As a Claude Code Skill

When installed as a Claude Code skill, just say `/init` and Claude will clone the repo, install deps, and link the command for you. Then use it by saying "generate an image of..." and Claude handles the rest.

Fallback (if `bun link` doesn't work)

mkdir -p ~/.local/bin
ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "nano-banana-2-skill-marketplace",
  3. "owner": {
  4. "name": "Bootoshi",
  5. "url": "https://github.com/kingbootoshi"
  6. },
  7. "metadata": {
  8. "description": "AI image generation CLI powered by Gemini 3.1 Flash (default) and Gemini 3 Pro. Multi-resolution, aspect ratios, cost tracking, green screen transparency, reference images, style transfer.",
  9. "version": "2.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "nano-banana",
  14. "source": "./plugins/nano-banana",
  15. "description": "AI image generation with Gemini 3.1 Flash and Pro. Generates 512-4K images with aspect ratio control, cost tracking, reference image support, and broadcast-grade green screen transparency.",
  16. "version": "2.0.0",
  17. "category": "creative tools",
  18. "keywords": ["image-generation", "ai", "gemini", "pixel-art", "green-screen", "chroma-key", "style-transfer", "nano-banana"]
  19. }
  20. ]
  21. }
README.md · README · 238 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Nano Banana 2 Skill
  2. AI image generation CLI powered by Gemini 3.1 Flash Image Preview (default) with support for Gemini 3 Pro and any Gemini model. Multi-resolution (512-4K), aspect ratios, cost tracking, broadcast-grade green screen transparency, reference images, and style transfer.
  3. Also ships as a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skill for AI-assisted image generation workflows.
  4. ## Install
  5. **Requirements:** [Bun](https://bun.sh), [FFmpeg](https://ffmpeg.org) + [ImageMagick](https://imagemagick.org) (for transparent mode)
  6. ```bash
  7. # Clone the repo
  8. git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2
  9. cd ~/tools/nano-banana-2
  10. # Install dependencies
  11. bun install
  12. # Link globally (no sudo needed - uses Bun's global bin)
  13. bun link
  14. # Set up your API key
  15. mkdir -p ~/.nano-banana
  16. echo "GEMINI_API_KEY=your_key_here" > ~/.nano-banana/.env
  17. ```
  18. Get a Gemini API key at [Google AI Studio](https://aistudio.google.com/apikey).
  19. Now you can use `nano-banana` from anywhere.
  20. ### As a Claude Code Skill
  21. When installed as a Claude Code skill, just say `/init` and Claude will clone the repo, install deps, and link the command for you. Then use it by saying "generate an image of..." and Claude handles the rest.
  22. ### Fallback (if `bun link` doesn't work)
  23. ```bash
  24. mkdir -p ~/.local/bin
  25. ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana
  26. echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  27. source ~/.zshrc
  28. ```
  29. ## Usage
  30. ```bash
  31. # Basic - generates 1K image to current directory
  32. nano-banana "minimal dashboard UI with dark theme"
  33. # Custom output name
  34. nano-banana "luxury product mockup" -o product
  35. # Higher resolution
  36. nano-banana "detailed landscape painting" -s 2K
  37. # Ultra high res
  38. nano-banana "cinematic widescreen scene" -s 4K -a 16:9
  39. # Lower resolution (fast, cheap)
  40. nano-banana "quick sketch concept" -s 512
  41. # Custom output directory
  42. nano-banana "UI screenshot" -o dashboard -d ~/Pictures
  43. ```
  44. ### Models
  45. ```bash
  46. # Default - Nano Banana 2 (Gemini 3.1 Flash, fast and cheap)
  47. nano-banana "your prompt"
  48. # Pro - highest quality, 2x cost
  49. nano-banana "your prompt" --model pro
  50. # Any model ID
  51. nano-banana "your prompt" --model gemini-2.5-flash-image
  52. ```
  53. | Alias | Model | Best For |
  54. |-------|-------|----------|
  55. | `flash`, `nb2` | Gemini 3.1 Flash Image Preview | Speed, cost, high-volume |
  56. | `pro`, `nb-pro` | Gemini 3 Pro Image Preview | Highest quality, complex composition |
  57. ### Aspect Ratios
  58. ```bash
  59. # Widescreen
  60. nano-banana "cinematic landscape" -a 16:9
  61. # Portrait
  62. nano-banana "mobile app screenshot" -a 9:16
  63. # Ultra-wide
  64. nano-banana "panoramic scene" -a 21:9
  65. # Standard photo
  66. nano-banana "product photo" -a 4:3
  67. ```
  68. Supported: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `4:5`, `5:4`, `21:9`
  69. ### Reference Images
  70. Edit, transform, or combine existing images:
  71. ```bash
  72. # Edit an existing image
  73. nano-banana "change the background to pure white" -r dark-ui.png -o light-ui
  74. # Style transfer - multiple references
  75. nano-banana "combine these two UI styles into one" -r style1.png -r style2.png -o combined
  76. # Color correction
  77. nano-banana "make this image more vibrant and increase contrast" -r photo.jpg
  78. ```
  79. ### Transparent Assets
  80. Generate assets with transparent backgrounds using AI-powered background removal:
  81. ```bash
  82. # Basic transparent asset
  83. nano-banana "robot mascot character" -t -o mascot
  84. # Logo with transparency
  85. nano-banana "minimalist tech logo" -t -o logo
  86. # Game asset
  87. nano-banana "pixel art treasure chest" -t -o chest
  88. ```
  89. The `-t` flag automatically prompts the AI to generate on a green screen, then uses FFmpeg `colorkey` + `despill` to key out the background and remove green spill from edge pixels. ImageMagick trims the result. Requires: `brew install ffmpeg imagemagick`
  90. ### Exact Dimensions
  91. Control output dimensions by using a blank image as the last reference:
  92. ```bash
  93. # First -r: your style reference
  94. # Last -r: blank image in target dimensions
  95. nano-banana "pixel art character, 256x256" -r style.png -r blank-256x256.png -o sprite
  96. ```
  97. ## Options
  98. | Option | Default | Description |
  99. |--------|---------|-------------|
  100. | `-o, --output` | `nano-gen-{timestamp}` | Output filename (no extension) |
  101. | `-s, --size` | `1K` | Image size: `512`, `1K`, `2K`, or `4K` |
  102. | `-a, --aspect` | model default | Aspect ratio: `1:1`, `16:9`, `9:16`, etc. |
  103. | `-m, --model` | `flash` | Model: `flash`/`nb2`, `pro`/`nb-pro`, or any model ID |
  104. | `-d, --dir` | current directory | Output directory |
  105. | `-r, --ref` | - | Reference image (can use multiple times) |
  106. | `-t, --transparent` | - | Generate on green screen, remove background (FFmpeg) |
  107. | `--api-key` | - | Gemini API key (overrides env/file) |
  108. | `--costs` | - | Show cost summary from generation history |
  109. | `-h, --help` | - | Show help |
  110. ## Sizes and Costs
  111. | Size | Resolution | Flash Cost | Pro Cost |
  112. |------|-----------|------------|----------|
  113. | `512` | ~512x512 | ~$0.045 | N/A (Flash only) |
  114. | `1K` | ~1024x1024 | ~$0.067 | ~$0.134 |
  115. | `2K` | ~2048x2048 | ~$0.101 | ~$0.201 |
  116. | `4K` | ~4096x4096 | ~$0.151 | ~$0.302 |
  117. ## Cost Tracking
  118. Every generation logs its cost to `~/.nano-banana/costs.json`. View your spending:
  119. ```bash
  120. nano-banana --costs
  121. ```
  122. Shows total generations, total spend, and per-model breakdown.
  123. ## API Key Configuration
  124. The CLI resolves the Gemini API key in priority order:
  125. 1. `--api-key` flag on the command line
  126. 2. `GEMINI_API_KEY` environment variable
  127. 3. `.env` file in the current working directory
  128. 4. `.env` file in the repo root (next to `src/`)
  129. 5. `~/.nano-banana/.env`
  130. Get a free key at [Google AI Studio](https://aistudio.google.com/apikey).
  131. ```bash
  132. # Option 1: Environment variable
  133. export GEMINI_API_KEY=your_key_here
  134. # Option 2: .env file in current directory
  135. echo "GEMINI_API_KEY=your_key_here" > .env
  136. # Option 3: Global config
  137. mkdir -p ~/.nano-banana
  138. echo "GEMINI_API_KEY=your_key_here" > ~/.nano-banana/.env
  139. # Option 4: Pass directly
  140. nano-banana "your prompt" --api-key your_key_here
  141. ```
  142. ## How Transparent Mode Works
  143. The `-t` flag uses a 3-step pipeline for pixel-perfect transparency:
  144. 1. **Green screen prompt** - The CLI automatically appends green screen instructions to your prompt, so the AI generates on a solid green background
  145. 2. **FFmpeg colorkey + despill** - `colorkey` removes the green background. `despill` reconstructs edge pixel colors by mathematically removing green contamination from the RGB channels - this is why edges are clean instead of having green fringe
  146. 3. **Auto-crop** - ImageMagick trims transparent padding and resets canvas
  147. The key color is auto-detected from corner pixels (the AI generates near-green like `#05F904`, not exact `#00FF00`). Requires FFmpeg and ImageMagick: `brew install ffmpeg imagemagick`
  148. ## Use Cases
  149. - **Landing page assets** - product mockups, UI previews
  150. - **Image editing** - transform existing images with text prompts
  151. - **Style transfer** - combine multiple reference images
  152. - **Marketing materials** - hero images, feature illustrations
  153. - **UI iterations** - quickly generate design variations
  154. - **Transparent assets** - icons, logos, mascots with no background
  155. - **Game assets** - sprites, tilesets, characters
  156. - **Video production** - visual elements for Remotion/video compositions
  157. ## Claude Code Skill
  158. When installed as a Claude Code plugin, the skill triggers on phrases like:
  159. - "generate an image"
  160. - "create a sprite"
  161. - "make an asset"
  162. - "generate artwork"
  163. Claude will construct the appropriate `nano-banana` command based on your request, handling model selection, resolution, aspect ratio, reference images, transparency, and output configuration automatically.
  164. ## License
  165. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.