nanobanana-pro-fallback
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.
Why use this skill?
Generate and edit images via Gemini API with automatic model fallback. Supports 1K/2K/4K resolutions, multi-image composition, and seamless integration with OpenClaw.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/yazelin/nanobanana-pro-fallbackWhat This Skill Does
Nano Banana Pro with Fallback is a sophisticated AI agent skill designed for OpenClaw that enables seamless image generation and transformation using the Gemini Image API. It functions as a robust wrapper around the Gemini ecosystem, providing an automated fallback mechanism that ensures high uptime for visual tasks. By leveraging gemini-2.5-flash-image and falling back to gemini-2.0-flash-exp-image-generation if necessary, users experience reliable image creation regardless of individual model availability. The skill supports text-to-image generation for conceptual art, image-to-image editing for modification of existing visual assets, and complex multi-image composition for up to 14 source files. Designed for stability, it requires the uv toolchain to manage isolated environments, ensuring all dependencies are handled correctly without polluting the global Python namespace.
Installation
To integrate Nano Banana Pro into your OpenClaw environment, ensure you have the uv package manager installed. Run the following command in your terminal: clawhub install openclaw/skills/skills/yazelin/nanobanana-pro-fallback. Once installed, you must configure your authentication by providing a GEMINI_API_KEY. This can be set via environment variables or directly within your ~/.openclaw/openclaw.json configuration file under skills.nanobanana-pro-fallback.apiKey. Always verify that your system paths allow execution of the uv command to ensure the script triggers the isolated virtual environment.
Use Cases
This skill is ideal for creative professionals and developers needing rapid prototyping of visual assets directly from the CLI. Use it for generating mood boards, UI elements, or illustrative content for documentation. The image-to-image feature is particularly useful for applying style transfers or editing existing design drafts. The multi-image composition functionality allows for advanced workflows, such as combining several reference sketches into a single cohesive piece, making it a versatile tool for workflow automation.
Example Prompts
- "Nano Banana, please generate a 2K resolution image of a cyberpunk coffee shop with neon lights at night and save it as 2023-10-27-10-00-00-cyber-cafe.png."
- "Use the nanobanana-pro-fallback skill to edit input.png to look like a pencil sketch and save it as sketch-version.png."
- "Combine these three reference images into a single landscape scene for my project presentation, using 4K resolution."
Tips & Limitations
Always prioritize using the generate wrapper script or uv run to execute the code, as direct execution with python3 will fail due to dependency mismatches. Remember that image resolutions are configurable between 1K, 2K, and 4K; larger resolutions consume more API credits and take longer to process. For better file management, strictly follow the recommended timestamping convention in your filenames. Note that the skill outputs a MEDIA: string for automated attachment in supported chat interfaces—ensure your client supports this for a seamless experience. Finally, the skill does not perform read-back operations on generated files, so treat the output path provided by the script as your primary source of truth for downstream operations.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-yazelin-nanobanana-pro-fallback": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, external-api, code-execution