# 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).

- Skill: `swarmclawai/nano-banana-pro` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add swarmclawai/nano-banana-pro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/swarmclawai/nano-banana-pro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: swarmclawai (https://skillmd.com/u/swarmclawai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/swarmclawai/nano-banana-pro

---


# Nano Banana Pro (Gemini 3 Pro Image)

Use the bundled script to generate or edit images.

## Generate

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

## Edit (Single Image)

```bash
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)

```bash
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)

```bash
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.