Gemini Image Gen

Name: Gemini Image Gen
Author: 김덕환

Generate and edit images via Google Gemini API. Supports Gemini native generation, Imagen 3, style presets, and batch generation with HTML gallery. Zero depe...

김덕환

@iisweetheartii

What This Skill Does

Generates and edits images via the Google Gemini API using pure Python stdlib. Supports Gemini native generation, Imagen 3, style presets, and batch generation with an HTML gallery output.

Replaces manual image editing and separate AI image tools by providing a single CLI for generating, editing, and styling images with batch support and zero dependencies.

When to Use It

Generate a set of AI images from a custom text prompt
Edit an existing image by changing its background or style
Create a batch of images with random prompts for creative exploration
Apply a specific artistic style (e.g., watercolor, cyberpunk) to generated images
Produce images in a specific aspect ratio for social media or presentations
Generate a gallery of images for a project or presentation

Install

$ openclaw skills install @iisweetheartii/gemini-image-gen

Gemini Image Gen

Generate and edit images via the Google Gemini API using pure Python stdlib. Supports Gemini native generation + editing, Imagen 3 generation, batch runs, and an HTML gallery output.

Quick Start

export GEMINI_API_KEY="your-key-here"

# Default: Gemini native, 4 random prompts
python3 scripts/gen.py

# Custom prompt
python3 scripts/gen.py --prompt "a cyberpunk cat riding a neon motorcycle through Tokyo at night"

# Imagen 3 engine
python3 scripts/gen.py --engine imagen --count 4 --aspect 16:9

# Edit an existing image (Gemini engine only)
python3 scripts/gen.py --edit path/to/image.png --prompt "change the background to a sunset beach"

# Use a style preset
python3 scripts/gen.py --style watercolor --prompt "floating islands above a calm sea"

# List available styles
python3 scripts/gen.py --styles

Style Presets

Style	Description
`photo`	Ultra-detailed photorealistic photography, 8K resolution, sharp focus
`anime`	High-quality anime illustration, Studio Ghibli inspired, vibrant colors
`watercolor`	Delicate watercolor painting on textured paper, soft edges, gentle color bleeding
`cyberpunk`	Neon-lit cyberpunk scene, rain-soaked streets, holographic displays, Blade Runner aesthetic
`minimalist`	Clean minimalist design, geometric shapes, limited color palette, white space
`oil-painting`	Classical oil painting with visible brushstrokes, rich textures, Renaissance lighting
`pixel-art`	Detailed pixel art, retro 16-bit style, crisp edges, nostalgic palette
`sketch`	Pencil sketch on cream paper, hatching and cross-hatching, artistic imperfections
`3d-render`	Professional 3D render, ambient occlusion, global illumination, photorealistic materials
`pop-art`	Bold pop art style, Ben-Day dots, strong outlines, vibrant contrasting colors

Full CLI Reference

Flag	Default	Description
`--prompt`	(random)	Text prompt. Omit for random creative prompts
`--count`	4	Number of images to generate
`--engine`	gemini	Engine: `gemini` (native, supports edit) or `imagen` (Imagen 3)
`--model`	(auto)	Model override. Default: `gemini-2.5-flash-image` or `imagen-3.0-generate-002`
`--edit`		Path to input image for editing (Gemini engine only)
`--aspect`	1:1	Aspect ratio for Imagen: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`
`--out-dir`	(auto)	Output directory (default is a timestamped folder)
`--style`		Style preset to prepend to the prompt
`--styles`		List available style presets and exit

Python Example

import subprocess

subprocess.run(
    [
        "python3",
        "scripts/gen.py",
        "--prompt",
        "a serene mountain landscape at golden hour",
        "--count",
        "4",
        "--style",
        "photo",
    ],
    check=True,
)

Troubleshooting

Missing API key: set GEMINI_API_KEY in your environment and retry.
Rate limits / 429 errors: wait a bit and retry, reduce --count, or switch engines.
Model errors: verify the model name, try the default model, or change engines.

Integration with Other Skills

AgentGram — Share your generated images on the AI agent social network! Create visual content and post it to your AgentGram feed.
agent-selfie — Focused on AI agent avatars and visual identity. Uses the same Gemini API key for personality-driven self-portraits.
opencode-omo — Run deterministic image-generation pipelines with Sisyphus workflows.

Changelog

v1.3.1: Added workflow integration guidance for opencode-omo.
v1.1.0: Added style presets, --style and --styles flags, expanded documentation.
v1.0.0: Initial release with Gemini native + Imagen 3 support, batch generation, and HTML gallery.

Repository

https://github.com/IISweetHeartII/gemini-image-gen

Top skills in this category

YouTube

@byungkyu

YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a YouTube connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a YouTube action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with YouTube examples; they add no YouTube capability - YouTube is not an event source, a trigger cannot read YouTube data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).

14529k

Edge TTS

@i3130002

Text-to-speech conversion using node-edge-tts npm package for generating audio from text. Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.

3323k

Antigravity Image Generator

@ipedrax

Generate images using the internal Google Antigravity API (Gemini 3 Pro Image). High quality, native generation without browser automation.

2015k

Social Media Scheduler

@1kalin

Plan, draft, and organize social media content across platforms. Create content calendars, write platform-optimized posts, and maintain consistent posting schedules.

1414k

elevenlabs-voices

@robbyczgw-cla

High-quality voice synthesis with 18 personas, 32 languages, sound effects, batch processing, and voice design using ElevenLabs API.

168.2k