---
name: gemini-nano-images
description: Generate ultra-realistic images and Instagram content using Gemini 2.0 Flash Experimental. Use when creating photorealistic images, social media content, or visual assets for Instagram workflows. Supports standalone image generation and complete Instagram post creation (image + caption).
---

# Gemini Nano Images

Generate ultra-realistic, photorealistic images using Google's Gemini 2.0 Flash Experimental model with native image generation capabilities.

## Quick Start

### 1. Set API Key

```bash
export GEMINI_API_KEY="your-api-key-here"
```

Get your API key at: https://aistudio.google.com/app/apikey

### 2. Generate Single Image

```bash
python3 scripts/generate_image.py "A cozy family breakfast scene with warm morning light"
```

### 3. Generate Full Instagram Post

```bash
python3 scripts/generate_instagram_post.py "Morning routine with kids" --mood cozy
```

## Scripts

### generate_image.py

Creates ultra-realistic images from text prompts.

**Usage:**
```bash
python3 scripts/generate_image.py "PROMPT" [options]
```

**Options:**
- `-o, --output DIR` - Output directory (default: current)
- `-k, --api-key KEY` - Gemini API key
- `--style {realistic,artistic,minimal}` - Style preset

**Example:**
```bash
python3 scripts/generate_image.py "Father reading bedtime story to child" -o ~/images
```

### generate_instagram_post.py

Creates complete Instagram posts: image + caption.

**Usage:**
```bash
python3 scripts/generate_instagram_post.py "TOPIC" [options]
```

**Options:**
- `-m, --mood MOOD` - Post mood: inspiring, cozy, energetic, calm, family, productive
- `-o, --output DIR` - Output directory (default: ~/.openclaw/workspace/assets)
- `-k, --api-key KEY` - Gemini API key

**Example:**
```bash
python3 scripts/generate_instagram_post.py "Organized family calendar" --mood productive
```

## Mood Presets

| Mood | Description |
|------|-------------|
| `inspiring` | Uplifting, motivational, golden hour |
| `cozy` | Warm, comfortable, soft lighting |
| `energetic` | Vibrant, dynamic, bright colors |
| `calm` | Peaceful, serene, soft pastels |
| `family` | Loving family moments, candid |
| `productive` | Organized, clean, modern aesthetic |

## Output

- **Images**: Saved as PNG with timestamp prefix
- **Captions**: Saved as .txt file alongside image
- **Location**: Default is `~/.openclaw/workspace/assets`

## Integration with Instagram Workflow

Generated content can be directly used with the Social Media Suite:

1. Generate content:
   ```bash
   python3 scripts/generate_instagram_post.py "Weekend family adventure"
   ```

2. Results saved to assets folder, ready for posting

3. Use with instagram-poster or instagrapi workflow

### Stock-Only Mode (Community Building Phase)

Für 1-2 Wochen nur Stockfotos posten (keine KI-Generierung):

```bash
# Stock-Only Mode für 14 Tage aktivieren
cd ~/.openclaw/workspace/skills/ig-automation
python3 smart_poster_v4.py --set-mode stock_only --stock-days 14

# Stockfotos in Ordner legen
mkdir -p assets/stock
cp ~/deine-stockfotos/*.jpg assets/stock/

# Jetzt werden nur Stockfotos gepostet (zufällige Auswahl, keine Doppelungen)
python3 smart_poster_v4.py

# Nach 14 Tagen automatischer Wechsel zu "auto" (KI + Stock)
```

**Modes:**
- `auto` - Bevorzugt KI, Fallback zu Stock
- `stock_only` - Nur Stockfotos aus `assets/stock/`
- `ai_only` - Nur KI-generierte Bilder

**Wichtig:** Bei Stockfotos kein Wasserzeichen (Logo) - sieht authentischer aus!

## Requirements

```bash
pip install google-genai
```

## Model Details

- **Model**: Gemini 2.0 Flash Experimental
- **Capability**: Native image generation
- **Resolution**: Up to 1024x1024
- **Style**: Photorealistic by default

See [references/gemini_api.md](references/gemini_api.md) for API details.


---
Source attribution: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/gemini-nano-images/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2025 skill-library-mcp contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/gemini-nano-images/SKILL.md
Attribution basis: Source repository record

Fields of work: Design, Marketing
Roles: Content Marketer, Graphic Designer, Influencer Marketer, Social Media Manager, UX Designer
Specialties: Design
Tools: Google Ads, Google Analytics, Gemini 2.0 Flash Experimental
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: a5a9f798ad22fa85ba2a7a9e180d2584745dee4e40f489e02a826570584ca643