Back to Details

nanobanana-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Nanobanana Image Generation Skill

Nanobanana 图片生成Skill

Generate or edit images using Google Gemini API through the nanobanana tool.
通过nanobanana工具使用Google Gemini API生成或编辑图片。

Requirements

要求

  1. GEMINI_API_KEY: Must be configured in 
    ~/.nanobanana.env
    or 
    export GEMINI_API_KEY=<your-api-key>
  2. Python3 with depedent packages installed: google-genai, Pillow, python-dotenv. They could be installed via 
    python3 -m pip install -r ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/requirements.txt
    if not installed yet.
  3. Executable: 
    ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py
  1. GEMINI_API_KEY: 必须在
    ~/.nanobanana.env
    中配置，或通过
    export GEMINI_API_KEY=<your-api-key>
    设置
  2. 安装了依赖包的Python3：需要安装google-genai、Pillow、python-dotenv。如果尚未安装，可通过
    python3 -m pip install -r ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/requirements.txt
    进行安装
  3. 可执行文件：
    ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py

Instructions

使用说明

For image generation

图片生成步骤

  1. Ask the user for:
    • What they want to create (the prompt)
    • Desired aspect ratio/size (optional, defaults to 9:16 portrait)
    • Output filename (optional, auto-generates UUID if not specified)
    • Model preference (optional, defaults to gemini-3-pro-image-preview)
    • Resolution (optional, defaults to 1K)
  2. Run the nanobanana script with appropriate parameters:
    bash
    python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py --prompt "description of image" --output "filename.png"
  3. Show the user the saved image path when complete
  1. 向用户确认以下信息：
    • 想要生成的内容（提示词）
    • 期望的宽高比/尺寸（可选，默认9:16竖屏）
    • 输出文件名（可选，未指定则自动生成UUID）
    • 模型偏好（可选，默认gemini-3-pro-image-preview）
    • 分辨率（可选，默认1K）
  2. 使用合适的参数运行nanobanana脚本：
    bash
    python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py --prompt "description of image" --output "filename.png"
  3. 完成后告知用户保存的图片路径

For image editing

图片编辑步骤

  1. Ask the user for:
    • Input image file(s) to edit
    • What changes they want (the prompt)
    • Output filename (optional)
  2. Run with input images:
    bash
    python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py --prompt "editing instructions" --input image1.png image2.png --output "edited.png"
  1. 向用户确认以下信息：
    • 要编辑的输入图片文件
    • 想要进行的修改（提示词）
    • 输出文件名（可选）
  2. 携带输入图片运行脚本：
    bash
    python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py --prompt "editing instructions" --input image1.png image2.png --output "edited.png"

Available Options

可用选项

Aspect Ratios (--size)

宽高比（--size）

  • 1024x1024
    (1:1) - Square
  • 832x1248
    (2:3) - Portrait
  • 1248x832
    (3:2) - Landscape
  • 864x1184
    (3:4) - Portrait
  • 1184x864
    (4:3) - Landscape
  • 896x1152
    (4:5) - Portrait
  • 1152x896
    (5:4) - Landscape
  • 768x1344
    (9:16) - Portrait (default)
  • 1344x768
    (16:9) - Landscape
  • 1536x672
    (21:9) - Ultra-wide
  • 1024x1024
    (1:1) - 正方形
  • 832x1248
    (2:3) - 竖屏
  • 1248x832
    (3:2) - 横屏
  • 864x1184
    (3:4) - 竖屏
  • 1184x864
    (4:3) - 横屏
  • 896x1152
    (4:5) - 竖屏
  • 1152x896
    (5:4) - 横屏
  • 768x1344
    (9:16) - 竖屏（默认）
  • 1344x768
    (16:9) - 横屏
  • 1536x672
    (21:9) - 超宽屏

Models (--model)

模型（--model）

  • gemini-3-pro-image-preview
    (default) - Higher quality
  • gemini-2.5-flash-image
    - Faster generation
  • gemini-3-pro-image-preview
    （默认）- 更高质量
  • gemini-2.5-flash-image
    - 生成速度更快

Resolution (--resolution)

分辨率（--resolution）

  • 1K
    (default)
  • 2K
  • 4K
  • 1K
    （默认）
  • 2K
  • 4K

Examples

示例

Generate a simple image

生成简单图片

bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py --prompt "A serene mountain landscape at sunset with a lake"
bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py --prompt "A serene mountain landscape at sunset with a lake"

Generate with specific size and output

指定尺寸和输出文件名生成

bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Modern minimalist logo for a tech startup" \
  --size 1024x1024 \
  --output "logo.png"
bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Modern minimalist logo for a tech startup" \
  --size 1024x1024 \
  --output "logo.png"

Generate landscape image with high resolution

生成高分辨率横屏图片

bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Futuristic cityscape with flying cars" \
  --size 1344x768 \
  --resolution 2K \
  --output "cityscape.png"
bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Futuristic cityscape with flying cars" \
  --size 1344x768 \
  --resolution 2K \
  --output "cityscape.png"

Edit existing images

编辑现有图片

bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Add a rainbow in the sky" \
  --input photo.png \
  --output "photo-with-rainbow.png"
bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Add a rainbow in the sky" \
  --input photo.png \
  --output "photo-with-rainbow.png"

Use faster model

使用更快的模型

bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Quick sketch of a cat" \
  --model gemini-2.5-flash-image \
  --output "cat-sketch.png"
bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/nanobanana-skill/nanobanana.py \
  --prompt "Quick sketch of a cat" \
  --model gemini-2.5-flash-image \
  --output "cat-sketch.png"

Error Handling

错误处理

If the script fails:
  • Check that 
    GEMINI_API_KEY
    is exported or set in ~/.nanobanana.env
  • Verify input image files exist and are readable
  • Ensure the output directory is writable
  • If no image is generated, try making the prompt more specific about wanting an image
如果脚本运行失败：
  • 检查
    GEMINI_API_KEY
    是否已导出或在~/.nanobanana.env中配置
  • 验证输入图片文件是否存在且可读取
  • 确保输出目录可写入
  • 如果未生成图片，尝试将提示词修改得更明确，强调需要生成图片

Best Practices

最佳实践

  1. Be descriptive in prompts - include style, mood, colors, composition
  2. For logos/graphics, use square aspect ratio (1024x1024)
  3. For social media posts, use 9:16 for stories or 1:1 for posts
  4. For wallpapers, use 16:9 or 21:9
  5. Start with 1K resolution for testing, upgrade to 2K/4K for final output
  6. Use gemini-3-pro-image-preview for best quality, gemini-2.5-flash-image for speed
  1. 提示词要详细描述 - 包含风格、氛围、色彩、构图
  2. 生成标志/图形时，使用正方形宽高比（1024x1024）
  3. 生成社交媒体内容时，故事类用9:16，帖子类用1:1
  4. 生成壁纸时，用16:9或21:9
  5. 测试时先使用1K分辨率，最终输出再升级到2K/4K
  6. 追求最佳质量用gemini-3-pro-image-preview，追求速度用gemini-2.5-flash-image