← Back to Skills Marketplace
2577
Downloads
4
Stars
6
Active Installs
8
Versions
Install in OpenClaw
/install 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.
Usage Guidance
This skill appears coherent and implements an image-generation wrapper around the Gemini API. Before installing, confirm you trust the GEMINI API endpoint and the author: the script will send prompts and (optionally) user-supplied image bytes to Google’s Gemini service using the GEMINI_API_KEY. Keep your API key private (avoid passing it on shared CLI history), and consider setting limited-scope credentials if the provider supports them. Review the public repo (homepage) if you want further assurance. Installing 'uv' via Homebrew is expected; inspect what 'uv' will install on your platform. If you plan to supply local images, ensure you only pass files you intend to upload to the remote API.
Capability Analysis
Type: OpenClaw Skill
Name: nanobanana-pro-fallback
Version: 0.4.4
The skill bundle is benign. Its purpose is to generate and edit images using the Gemini Image API, with model fallback. The `scripts/generate_image.py` script correctly handles API key retrieval, loads user-provided input images, makes calls to the Google Gemini API, and saves the resulting image to a user-specified path. All file system and network operations are directly aligned with the stated purpose. The `SKILL.md` instructions for the agent are clear and include a benign safety instruction ('Do not read the image back; report the saved path only'), with no evidence of malicious prompt injection or other harmful behaviors.
Capability Assessment
Purpose & Capability
Name/description (image generation/editing via Gemini) match the actual files and declared requirements. The script uses the Gemini client, accepts an API key, and requires the 'uv' runner as described. Requiring GEMINI_API_KEY and the uv binary is proportional to the stated functionality.
Instruction Scope
SKILL.md and the included script instruct the agent to run the bundled script with 'uv run', operate on user-supplied input images, and save an output file (printing a MEDIA: line). The instructions do not request unrelated files, extra credentials, or exfiltration endpoints. The script only reads input image paths provided by the user and writes the specified output file.
Install Mechanism
Install uses a Homebrew formula to install 'uv', a known runner. There are no downloads from arbitrary/personal URLs or extract steps that write unknown code to disk. 'uv' will manage Python dependencies at runtime (expected for this project).
Credentials
Only GEMINI_API_KEY is required (primaryEnv). An optional env var (NANOBANANA_FALLBACK_MODELS) is documented for configuration. No unrelated secrets or excessive environment access are requested.
Persistence & Privilege
The skill is not always-included and does not request elevated or cross-skill config changes. It does not modify other skills' settings or request persistent system-wide privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nanobanana-pro-fallback - After installation, invoke the skill by name or use
/nanobanana-pro-fallback - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.4.4
Improve description for search
v0.4.3
Fix: image_size param only for gemini-3 models, prevents 400 INVALID_ARGUMENT on gemini-2.5-flash
v0.4.2
Rich description with full usage command for agent system prompt
v0.4.1
Added bash wrapper script (scripts/generate) that forces uv run
v0.4.0
Based on official nano-banana-pro: same script structure, only added model fallback
v0.3.0
Single-file design: uv run auto-installs deps, merged generate/edit/restore into one script
v0.2.0
Zero dependencies: pure stdlib, no pip/uv needed
v0.1.0
Initial release of nanobanana-pro, an AI image generation tool with automatic fallback.
- Generate, edit, or restore images using Gemini image models.
- Automatic fallback through multiple models if one fails (configurable via environment variable).
- Supports resolutions: 1K (default), 2K, and 4K.
- Command-line scripts for generation, editing (including multi-image), and restoration.
- Requires GEMINI_API_KEY environment variable.
- OpenClaw integration with special outputs and config options.
Metadata
Frequently Asked Questions
What is Nanobanana Pro?
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. It is an AI Agent Skill for Claude Code / OpenClaw, with 2577 downloads so far.
How do I install Nanobanana Pro?
Run "/install nanobanana-pro-fallback" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Nanobanana Pro free?
Yes, Nanobanana Pro is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Nanobanana Pro support?
Nanobanana Pro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Nanobanana Pro?
It is built and maintained by yazelin (@yazelin); the current version is v0.4.4.
More Skills