How do I install the Gemini Image Proxy skill?

Run npx skillmds@latest add dvcrn/gemini-image-proxy in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gemini Image Proxy skill do?

Generate and edit images with Gemini API using the OpenAI Python SDK. It is listed under Integrations & APIs on SkillMD.

Is Gemini Image Proxy safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gemini Image Proxy?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gemini Image Proxy free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gemini Image Proxy?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gemini Image Proxy by dvcrn — Agent Skill

Name: Gemini Image Proxy
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Gemini Image Simple

Generate and edit images using Gemini 3 Pro Image via the OpenAI Python SDK and an OpenAI-compatible API endpoint.

Why This Skill

Feature	This Skill	Others (nano-banana-pro, etc.)
Dependencies	openai (SDK)	google-genai, pillow, etc.
Requires pip/uv	✅ Yes	✅ Yes
Works on Fly.io free	✅ Yes (with pip)	❌ Fails
Works in containers	✅ Yes (with pip)	❌ Often fails
Image generation	✅ Full	✅ Full
Image editing	✅ Yes	✅ Yes
Setup complexity	Install SDK + set API key	Install packages first

Bottom line: This skill uses the OpenAI SDK, so you must install openai once with pip.

Install

python3 -m pip install openai

Quick Start

# Set env
export GOOGLE_PROXY_API_KEY="your_api_key"
export GOOGLE_PROXY_BASE_URL="https://example.com/v1"

# 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 these environment variables:

GOOGLE_PROXY_API_KEY (your API key)
GOOGLE_PROXY_BASE_URL (OpenAI-compatible base URL, e.g. https://example.com/v1)

How It Works

Uses Gemini 3 Pro Image (gemini-3-pro-image) via the OpenAI Python SDK:

client.images.generate(...) for new images
client.images.edits(...) for edits
Requires the openai package

That's it. Works on any Python 3.10+ installation with openai installed.

Model

Currently using: gemini-3-pro-image

Other available models (can be changed in generate.py if needed):

gemini-3-pro-image-preview - Preview variant
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

---name: gemini-image-proxydescription: Generate and edit images with Gemini API using the OpenAI Python SDK.---# Gemini Image SimpleGenerate and edit images using **Gemini 3 Pro Image** via the OpenAI Python SDK and an OpenAI-compatible API endpoint.## Why This Skill| Feature | This Skill | Others (nano-banana-pro, etc.) || ------------------------ | ------------------------- | ------------------------------ || **Dependencies** | openai (SDK) | google-genai, pillow, etc. || **Requires pip/uv** | ✅ Yes | ✅ Yes || **Works on Fly.io free** | ✅ Yes (with pip) | ❌ Fails || **Works in containers** | ✅ Yes (with pip) | ❌ Often fails || **Image generation** | ✅ Full | ✅ Full || **Image editing** | ✅ Yes | ✅ Yes || **Setup complexity** | Install SDK + set API key | Install packages first |**Bottom line:** This skill uses the OpenAI SDK, so you must install `openai` once with pip.## Install```bashpython3 -m pip install openai```## Quick Start```bash# Set envexport GOOGLE_PROXY_API_KEY="your_api_key"export GOOGLE_PROXY_BASE_URL="https://example.com/v1"# Generatepython3 /data/clawd/skills/gemini-image-simple/scripts/generate.py "A cat wearing a tiny hat" cat.png# Edit existing imagepython3 /data/clawd/skills/gemini-image-simple/scripts/generate.py "Make it sunset lighting" edited.png --input original.png```## Usage### Generate new image```bashpython3 {baseDir}/scripts/generate.py "your prompt" output.png```### Edit existing image```bashpython3 {baseDir}/scripts/generate.py "edit instructions" output.png --input source.png```Supported input formats: PNG, JPG, JPEG, GIF, WEBP## EnvironmentSet these environment variables:- `GOOGLE_PROXY_API_KEY` (your API key)- `GOOGLE_PROXY_BASE_URL` (OpenAI-compatible base URL, e.g. https://example.com/v1)## How It WorksUses **Gemini 3 Pro Image** (`gemini-3-pro-image`) via the OpenAI Python SDK:- `client.images.generate(...)` for new images- `client.images.edits(...)` for edits- Requires the `openai` packageThat's it. Works on any Python 3.10+ installation with `openai` installed.## ModelCurrently using: `gemini-3-pro-image`Other available models (can be changed in generate.py if needed):- `gemini-3-pro-image-preview` - Preview variant- `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# Landscapepython3 {baseDir}/scripts/generate.py "Misty mountains at sunrise, photorealistic" mountains.png# Product shotpython3 {baseDir}/scripts/generate.py "Minimalist product photo of a coffee cup, white background" coffee.png# Edit: change stylepython3 {baseDir}/scripts/generate.py "Convert to watercolor painting style" watercolor.png --input photo.jpg# Edit: add elementpython3 {baseDir}/scripts/generate.py "Add a rainbow in the sky" rainbow.png --input landscape.png```

Frequently asked questions

Gemini Image Proxy