gemini-image-simple

Generate and edit images with Gemini API using pure Python stdlib. Zero dependencies - works on locked-down environments where pip/uv aren't available.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "gemini-image-simple" with this command: npx skills add Cluka-399/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

FeatureThis SkillOthers (nano-banana-pro, etc.)
DependenciesNone (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 complexityJust set API keyInstall packages first

Bottom line: This skill works anywhere Python 3 exists. No package managers, no virtual environments, no permission issues.

Quick Start

# 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

python3 {baseDir}/scripts/generate.py "your prompt" output.png

Edit existing image

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

# 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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

clawhub-install

Download and install skills from ClawHub directly via curl, bypassing official CLI rate limits. Use when the user wants to install one or more ClawHub skills...

Registry SourceRecently Updated
0199
upupc
Coding

Homebrew Bridge

Expose Mac Homebrew tools like brew, gh, and other /opt/homebrew/bin CLIs on a Linux OpenClaw gateway by installing explicit same-LAN SSH wrappers with optio...

Registry SourceRecently Updated
0177
matthewxmurphy
Coding

Dev Tools Pack

Collection of developer tools including Chrome extension templates, AI code reviews, GitHub README generators, SaaS landing pages, tech blogs, and tweet thre...

Registry SourceRecently Updated
0159
Sunshine-del-ux