gemini-image-simple

# Gemini Image Simple Generate and edit images using Google's **Nano Banana Pro** (Gemini 3 Pro Image) - the highest quality image generation model. ## Why This Skill | Feature | This Skill | Others (nano-banana-pro, etc.) | |---------|------------|-------------------------------| | **Dependencies** | None (stdlib only) | google-genai, pillow, etc. | | **Requires pip/uv** | ❌ No | ✅ Yes | | **Works on Fly.io free** | ✅ Yes | ❌ Fails | | **Works in containers** | ✅ Yes | ❌ Often fails | | **Image generation** | ✅ Full | ✅ Full | | **Image editing** | ✅ Yes | ✅ Yes | | **Setup complexity** | Just set API key | Install packages first | **Bottom line:** This skill works anywhere Python 3 exists. No package managers, no virtual environments, no permission issues. ## Quick Start ```bash # Generate python3 /data/clawd/skills/gemini-image-simple/scripts/generate.py "A cat wearing a tiny hat" cat.png # Edit existing image python3 /data/clawd/skills/gemini-image-simple/scripts/generate.py "Make it sunset lighting" edited.png --input original.png ``` ## Usage ### Generate new image ```bash python3 {baseDir}/scripts/generate.py "your prompt" output.png ``` ### Edit existing image ```bash python3 {baseDir}/scripts/generate.py "edit instructions" output.png --input source.png ``` Supported input formats: PNG, JPG, JPEG, GIF, WEBP ## Environment Set `GEMINI_API_KEY` environment variable. Get one at https://aistudio.google.com/apikey ## How It Works Uses **Nano Banana Pro** (`nano-banana-pro-preview`) - Google's highest quality image generation model: - Pure `urllib.request` for HTTP (no requests library) - Pure `json` for parsing (stdlib) - Pure `base64` for encoding (stdlib) That's it. No external packages. Works on any Python 3.10+ installation. ## Model Currently using: `nano-banana-pro-preview` (also known as Gemini 3 Pro Image) Other available models (can be changed in generate.py if needed): - `gemini-3-pro-image-preview` - Same as Nano Banana Pro - `imagen-4.0-ultra-generate-001` - Imagen 4.0 Ultra - `imagen-4.0-generate-001` - Imagen 4.0 - `gemini-2.5-flash-image` - Gemini 2.5 Flash with image gen ## Examples ```bash # Landscape python3 {baseDir}/scripts/generate.py "Misty mountains at sunrise, photorealistic" mountains.png # Product shot python3 {baseDir}/scripts/generate.py "Minimalist product photo of a coffee cup, white background" coffee.png # Edit: change style python3 {baseDir}/scripts/generate.py "Convert to watercolor painting style" watercolor.png --input photo.jpg # Edit: add element python3 {baseDir}/scripts/generate.py "Add a rainbow in the sky" rainbow.png --input landscape.png ```