Pollinations Image

# 🎨 Pollinations Image Generation Skill

A clean, modular, and user-friendly image generation tool powered by [Pollinations.ai](https://pollinations.ai).

## ✨ Features

- 🎁 **5,000 free images/month** with pollen grants
- 🔄 **Easy model switching** - change anytime
- 💾 **Persistent defaults** - remember your preferences
- 📊 **Clear model comparison** - quality, speed, cost
- 🔧 **Modular design** - easy to extend

## 🚀 Quick Start

### First Time Setup

```bash
# 1. Clone or copy the skill
cd pollinations-image/

# 2. (Optional) Configure your API key
cp .env.example .env
# Edit .env and add your key from https://enter.pollinations.ai

# 3. (Optional) Set your default model  
cp .user.conf.example .user.conf
# Edit .user.conf to change DEFAULT_IMAGE_MODEL

# 4. List all available models
./generate.sh models

# 5. Generate your first image
./generate.sh "a cute purple cat"
```

### Already Configured?

```bash
# List all available models
./generate.sh models

# Set your default model (optional)
./generate.sh set-model flux

# Generate an image
./generate.sh generate --prompt "a cute purple cat"

# Or use the shortcut
./generate.sh "a cute purple cat"
```

## 📋 Available Models

| Model | Type | Speed | Quality | Cost |
|-------|------|-------|---------|------|
| `flux` | 🎁 Free | ⚡⚡ | ⭐⭐⭐⭐⭐ | ~0.0002 pollen/img |
| `zimage` | 🎁 Free | ⚡ | ⭐⭐⭐⭐ | ~0.0002 pollen/img |
| `klein` | 💰 Paid | ⚡⚡ | ⭐⭐⭐⭐⭐ | ~0.008 pollen/img |
| `klein-large` | 💰 Paid | ⚡⚡⚡ | ⭐⭐⭐⭐⭐⭐ | ~0.012 pollen/img |
| `gptimage` | 💰 Paid | ⚡⚡ | ⭐⭐⭐⭐⭐ | 2.0-8.0 pollen/M |

## 📖 Commands

### `generate` (or `g`)
Generate an image with your prompt.

```bash
# Full command
./generate.sh generate --prompt "a sunset over mountains" --model flux --width 1024 --height 1024

# Short options
./generate.sh g -p "a sunset" -m zimage -w 512 -h 512

# Even shorter (prompt only)
./generate.sh "a cute cat"
```

**Options:**
- `--prompt, -p` - Image description (required...