Swarmclaw nano-banana-pro

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro). Use when asked to create, generate, or edit images and a Gemini API key is available. Supports text-to-image generation, single-image editing, and multi-image composition (up to 14 images).

install
source · Clone the upstream repo
git clone https://github.com/swarmclawai/swarmclaw
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/swarmclawai/swarmclaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/nano-banana-pro" ~/.claude/skills/swarmclawai-swarmclaw-nano-banana-pro && rm -rf "$T"
manifest: skills/nano-banana-pro/SKILL.md
source content

Nano Banana Pro (Gemini 3 Pro Image)

Use the bundled script to generate or edit images.

Generate

uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png" --resolution 1K

Edit (Single Image)

uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" -i "/path/in.png" --resolution 2K

Multi-Image Composition (up to 14 images)

uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scene" --filename "output.png" -i img1.png -i img2.png -i img3.png

API Key

Set

GEMINI_API_KEY
as an environment variable, or pass
--api-key <KEY>
to the script.

Aspect Ratio (optional)

uv run {baseDir}/scripts/generate_image.py --prompt "portrait photo" --filename "output.png" --aspect-ratio 9:16

Notes

  • Resolutions:
    1K
    (default),
    2K
    ,
    4K
    .
  • Aspect ratios:
    1:1
    ,
    2:3
    ,
    3:2
    ,
    3:4
    ,
    4:3
    ,
    4:5
    ,
    5:4
    ,
    9:16
    ,
    16:9
    ,
    21:9
    . Without
    --aspect-ratio
    , the model picks freely.
  • Use timestamps in filenames for uniqueness:
    yyyy-mm-dd-hh-mm-ss-name.png
    .
  • Do not read the image back into context; report the saved path only.