FastMCP FastMCP
Sign In

openclaw / nanobanana-pro-fallback

Generate or edit images via Gemini Image API with automatic model fallback.

Design
0 views
0 installs
Source: https://github.com/openclaw/skills/tree/main/skills/yazelin/nanobanana-pro-fallback

Skill Content

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