se-gemini-imagegen

Files (7)

• SKILL.md
• requirements.txt
• compose_images.py · scripts/
• edit_image.py · scripts/
• gemini_images.py · scripts/
• generate_image.py · scripts/
• multi_turn_chat.py · scripts/

SKILL.md (first lines)

# Gemini Image Generation (Nano Banana Pro)

**Pi tools (preferred when registered):** three of the five python scripts ship as typed Pi tools. Use the tool surface; the scripts stay on disk as fallback.

| Tool | Wraps | Use when |
|---|---|---|
| `gemini_image_generate` | `scripts/generate_image.py` | Creating a new image from a text prompt |
| `gemini_image_edit` | `scripts/edit_image.py` | Modifying an existing image with a natural-language instruction |
| `gemini_image_compose` | `scripts/compose_images.py` | Combining 1–14 input images into a new image |

`scripts/multi_turn_chat.py` and `scripts/gemini_images.py` remain script-only — they're interactive REPL flows that don't fit a single tool-call shape.

**Pre-flight:** Always confirm `GEMINI_API_KEY` is set before calling any of the three tools. The scripts fail fast without it; surfacing the missing-env check before invoking avoids wasted call attempts.

Generate and edit images using Google's Gemini API. The environment variable `GEMINI_API_KEY` must be set.

## Default Model

| Model | Resolution | Best For |
|-------|------------|----------|
| `gemini-3-pro-image-preview` | 1K-4K | All image generation (default) |

**Note:** Always use this Pro model. Only use a different model if explicitly requested.

## Quick Reference

### Default Settings
- **Model:** `gemini-3-pro-image-preview`
- **Resolution:** 1K (default, options: 1K, 2K, 4K)
- **Aspect Ratio:** 1:1 (default)

### Available Aspect Ratios
`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`

### Available Resolutions
`1K` (default), `2K`, `4K`

## Core API Pattern

```python
import os
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

# Basic generation (1K, 1:1 - defaults)
response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents=["Your prompt here"],
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
    ),
)

for part in response.parts:
    if part.text:
        print(part.text)
    elif part.inline_data:
        image = part.as_image()
        image.save("output.png")
```

## Custom Resolution & Aspect Ratio

```python
from google.genai import types

response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents=[prompt],
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",  # Wide format
            image_size="2K"       # Higher resolution
        ),
    )
)
```

### Resolution Examples

```python
# 1K (default) - Fast, good for previews
image_config=types.ImageConfig(image_size="1K")

# 2K - Balanced quality/speed
image_config=types.ImageConfig(image_size="2K")

# 4K - Maximum quality, slower
image_config=types.ImageConfig(image_size="4K")
```

### Aspect Ratio Examples

```python
# Square (default)
image_config=types.ImageConfig(aspect_ratio="1:1")

# Landscape wide
image_config=types.ImageConfig(aspect_ratio="16:9")

# Ultra-wide panoramic
image_config=types.ImageConfig(aspect_ratio="21:9")

# Portrait
image_config=types.ImageConfig(aspect_ratio="9:16")

# Photo standard
image_config=types.ImageConfig(aspect_ratio="4:3")
```

## Editing Images

Pass existing images with text prompts:

```python
from PIL import Image

From simonwjackson/pi-software-engineering, MIT.

More from simonwjackson/pi-software-engineering