nano-banana-pro
Create images from text descriptions or edit existing images with AI-powered generation. Supports resolutions from 512px to 4K, with a recommended workflow that starts at 1K for quick iteration before finalizing at higher resolutions. Requires a Gemini API key and the uv package manager.
Nano Banana Pro generates new images or edits existing ones from text prompts using Google's Gemini API.
AI-generated summary based on this skill's SKILL.md
Install
steipete/agent-scripts/nano-banana-pro · repository language: Shell
git clone https://github.com/steipete/agent-scripts
cp -r agent-scripts/skills/nano-banana-pro ~/.claude/skills/nano-banana-pronpx skillfed install steipete/agent-scripts/nano-banana-proFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I generate an image from a text prompt using nano-banana-pro?
nano-banana-pro generates images from text descriptions by leveraging AI-powered image synthesis. You provide a text prompt describing what you want to create, and the tool produces an image matching your description. The skill supports multiple resolution outputs from 512px up to 4K, allowing you to start with lower resolutions for quick iteration before finalizing at higher quality.
Can nano-banana-pro edit existing images with AI instructions?
Yes, nano-banana-pro can edit and modify existing images using natural language instructions. Beyond generating new images from scratch, the tool lets you take an existing image and apply AI-powered edits by describing the changes you want in plain text, enabling seamless image refinement workflows.
What resolutions does nano-banana-pro support for image creation?
nano-banana-pro creates images at multiple resolutions ranging from 512px up to 4K. The recommended workflow starts at 1K resolution for quick iteration and draft exploration, then finalizes at higher resolutions once you're satisfied with your composition and content.
How can I iterate quickly on image prompts with nano-banana-pro?
nano-banana-pro supports a draft-to-final workflow designed for rapid iteration. Start by generating drafts at lower resolutions like 512px or 1K to explore ideas quickly and cheaply, then refine your prompts based on results before creating final versions at higher resolutions like 4K.
Does nano-banana-pro offer command-line API automation?
Yes, nano-banana-pro can be automated via command-line API, enabling batch image generation and editing workflows. This allows you to integrate image creation and modification into scripts and automated pipelines for efficient processing of multiple images.
What are the requirements to use nano-banana-pro?
nano-banana-pro requires a Gemini API key for accessing the AI image generation and editing capabilities. You'll also need the uv package manager installed. The tool is released under the MIT license, making it free to use and modify.
SKILL.md
rendered from the published skill — quoted content, verbatim
Nano Banana 2 Image Generation & Editing
Generate new images or edit existing ones using Google's Nano Banana 2 API (Gemini 3.1 Flash Image).
Usage
Run the script using absolute path (do NOT cd to skill directory first):
Generate new image:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
Edit existing image:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
Important: Always run from the user's current working directory so images are saved where the user is working, not in the skill directory.
Default Workflow (draft → iterate → final)
Goal: fast iteration without burning time on 4K until the prompt is correct.
- Draft (1K): quick feedback loop
- `uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<draft prompt>"
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
skills/nano-banana-pro/SKILL.md
skills/nano-banana-pro/scripts/generate_image.py