corespeed-nanobanana

name

corespeed-nanobanana

description

Generate and edit images using Gemini via Corespeed AI Gateway. Use when a user asks to create, draw, design, or generate an image, picture, illustration, icon, logo, banner, thumbnail, or screenshot mockup. Also triggers on image editing (remove background, resize, recolor, combine photos), image analysis (describe, compare, OCR), and text generation with Gemini models (gemini-2.5-flash-image, gemini-2.5-flash, gemini-2.5-pro). Trigger phrases include: "画一个", "生成图片", "做一张图", "帮我P图", "make me an image", "generate a picture", "edit this photo", "what's in this image".

Corespeed NanoBanana — Gemini Image & Text Generation

Auth

Requires CS_AI_GATEWAY_BASE_URL and CS_AI_GATEWAY_API_TOKEN environment variables. These are often already configured — check with echo $CS_AI_GATEWAY_BASE_URL before asking the user to set them. Only prompt the user if they are genuinely missing.

The Corespeed AI Gateway authenticates via Authorization: Bearer <token> header only. The google-genai library defaults to sending x-goog-api-key, which the gateway does not use for auth and will forward to Google upstream — causing a rejection if the value is invalid. The script handles this by:

1. Setting api_key="gateway" (placeholder required by the library)
2. Injecting Authorization: Bearer <token> via HttpOptions.headers
3. Overriding x-goog-api-key to empty string in the same headers dict to prevent upstream rejection

If you modify the client setup or write new scripts against this gateway, follow the same pattern.

Workflow

1. Pick a model from the table below (default: gemini-2.5-flash-image for image generation)
2. Run the script with your prompt

Usage

uv run {baseDir}/scripts/gemini.py --prompt "your prompt" -f output.ext [-i input.ext] [--model MODEL]

• --prompt, -p — Text prompt (required)
• --filename, -f — Output filename (required)
• --input, -i — Input image file(s), repeat for multiple
• --model, -m — Model name (default: gemini-2.5-flash-image)
• --modalities — Response type: auto, image, text, image+text (default: auto)
• --json — Output structured JSON (recommended for agent consumption)

Output format is determined by file extension: .png/.jpg → image generation, .txt/.md → text output.

Image Generation

# Text-to-image
uv run {baseDir}/scripts/gemini.py -p "a watercolor fox in autumn forest" -f fox.png

# Image editing
uv run {baseDir}/scripts/gemini.py -p "Remove background, add beach sunset" -f edited.png -i photo.jpg

# Multi-image compositing
uv run {baseDir}/scripts/gemini.py -p "Blend these two scenes together" -f blend.png -i scene1.png -i scene2.png

Image Analysis

# Describe an image
uv run {baseDir}/scripts/gemini.py -p "Describe this image" -f desc.txt -i photo.jpg --model gemini-2.5-flash

# Compare images
uv run {baseDir}/scripts/gemini.py -p "What are the differences?" -f diff.txt -i before.jpg -i after.jpg --model gemini-2.5-flash

Text Generation

# Use the most capable model for complex tasks
uv run {baseDir}/scripts/gemini.py -p "Write a haiku about coding" -f haiku.txt --model gemini-2.5-pro

Models

Model	Type	Best For
gemini-2.5-flash-image	Image + Text	Image generation & editing (default)
gemini-2.5-flash	Text	Fast analysis, vision, general tasks
gemini-2.5-pro	Text	Complex reasoning, highest quality
gemini-2.5-flash-lite	Text	Fastest, simple tasks

Notes

• No manual Python setup required. The script uses PEP 723 inline metadata. uv run automatically creates an isolated virtual environment and installs the google-genai dependency on first run.
• Image output is returned inline as base64 from the Gemini API — no separate download step.
• Use timestamps in filenames: yyyy-mm-dd-hh-mm-ss-name.ext.
• Script prints MEDIA: line for OpenClaw to auto-attach generated images.
• Do not read generated media back; report the saved path only.
• Only gemini-2.5-flash-image can generate images. Other models are text-only.
• Use --json for structured output: {"ok": true, "files": [...], "text": "...", "model": "...", "tokens": {...}}

Support

Built by Corespeed. If you need help or run into issues:

• 💬 Discord: discord.gg/mAfhakVRnJ
• 🐦 X/Twitter: @CoreSpeed_io
• 🐙 GitHub: github.com/corespeed-io/skills