Skill: yazelin/nanobanana-pro-fallback (version 0.4.4)

--- 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: ["uv"] env: ["GEMINI_API_KEY"] primaryEnv: GEMINI_API_KEY install: - id: uv-brew kind: brew formula: uv bins: ["uv"] label: "Install uv (brew)" 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) ```bash {baseDir}/scripts/generate --prompt "your image description" --filename "output.png" --resolution 1K ``` Generate (option B: uv run) ```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 - `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.

path: README.md
content: # 🍌 Nano Banana Pro (Fallback Edition)

AI 圖片生成 Agent Skill，支援自動模型切換。

Fork of [OpenClaw's nano-banana-pro](https://clawhub.com) — same interface, added **automatic model fallback**.

## Features

- 🔄 **Auto Fallback** — `gemini-2.5-flash-image` → `gemini-2.0-flash-exp-image-generation`
- 🖼️ **Generate** — Text-to-image
- ✏️ **Edit** — Image-to-image, up to 14 input images
- 📐 **Auto Resolution** — Detects optimal resolution from input image size
- 📦 **Zero Config** — Just set `GEMINI_API_KEY` and go

## Install

```bash
# Via ClawHub
clawhub install nanobanana-pro-fallback

# Or clone directly
git clone https://github.com/yazelin/nanobanana-pro.git
```

## Usage

```bash
# Generate
uv run scripts/generate_image.py --prompt "a cat in a garden" --filename "cat.png"

# Edit
uv run scripts/generate_image.py --prompt "make it sunset" --filename "out.png" -i input.png

# Multi-image composition
uv run scripts/generate_image.py --prompt "combine these" --filename "out.png" -i a.png -i b.png

# Resolution options: 1K (default), 2K, 4K
uv run scripts/generate_image.py --prompt "hi-res landscape" --filename "out.png" --resolution 2K
```

## Requirements

- Python 3.10+
- [uv](https://docs.astral.sh/uv/) (auto-installs dependencies)
- `GEMINI_API_KEY` environment variable

## Configuration

| Env Variable | Description |
|---|---|
| `GEMINI_API_KEY` | Gemini API key (required) |
| `NANOBANANA_FALLBACK_MODELS` | Custom model chain, comma-separated |

## vs Original

| | nano-banana-pro | nanobanana-pro-fallback |
|---|---|---|
| Model | Fixed `gemini-3-pro-image-preview` | Auto fallback chain |
| Resolution detect | Manual only | Auto from input |
| ClawHub slug | `nanobanana-pro` | `nanobanana-pro-fallback` |

## License

MIT


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)