nanobanana-pro-fallback

name	nanobanana-pro-fallback
description	Nano Banana Pro with auto model fallback — generate/edit images via Gemini Image API. Run via: uv run {baseDir}/scripts/generate_image.py --prompt 'desc' --filename 'out.png' [--resolution 1K|2K|4K] [-i input.png]. Supports text-to-image + image-to-image (up to 14); 1K/2K/4K. Fallback chain: gemini-2.5-flash-image → gemini-2.0-flash-exp. MUST use uv run, not python3.
version	0.4.4
license	MIT
homepage	https://github.com/yazelin/nanobanana-pro
author	yazelin
compatibility	{"platforms":["openclaw","ching-tech-os"]}
metadata	{"openclaw":{"emoji":"🍌","requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"GEMINI_API_KEY","install":["[Truncated]"]},"ctos":{"requires_app":"","mcp_servers":""}}

Nano Banana Pro with Fallback

Use the bundled script to generate or edit images. Automatically falls back through multiple Gemini models if one fails.

⚠️ IMPORTANT: MUST use uv run or the generate wrapper. Do NOT use python3 directly — dependencies won't be available.

Generate (option A: wrapper script)

{baseDir}/scripts/generate --prompt "your image description" --filename "output.png" --resolution 1K

Generate (option B: uv run)

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

• GEMINI_API_KEY env var
• Or set skills."nanobanana-pro-fallback".apiKey / skills."nanobanana-pro-fallback".env.GEMINI_API_KEY in ~/.openclaw/openclaw.json

Notes

• Resolutions: 1K (default), 2K, 4K.
• Models tried in order: gemini-2.5-flash-image → gemini-2.0-flash-exp-image-generation (configurable via NANOBANANA_FALLBACK_MODELS env var).
• Use timestamps in filenames: yyyy-mm-dd-hh-mm-ss-name.png.
• The script prints a MEDIA: line for OpenClaw to auto-attach on supported chat providers.
• Do not read the image back; report the saved path only.