🎨 Pollinations Image Generation Skill

A clean, modular, and user-friendly image generation tool powered by 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

# 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?

# 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

📖 Commands

generate (or g)

Generate an image with your prompt.

# 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)
• --model, -m - Model to use (overrides default)
• --width, -w - Image width (default: 1024)
• --height, -h - Image height (default: 1024)
• --seed, -s - Random seed for reproducibility
• --filename, -f - Custom output filename
• --nologo - Remove Pollinations watermark
• --enhance - Let AI improve your prompt

models (or m)

Display all available models with ratings.

./generate.sh models

model MODEL_NAME

Show detailed information about a specific model.

./generate.sh model klein-large

set-model MODEL_NAME

Set your default model for all future generations.

./generate.sh set-model zimage

Note: This saves to .user.conf and persists across sessions.

config

Display your current configuration.

./generate.sh config

help

Show help message.

./generate.sh help

⚙️ Configuration

User preferences are stored in .user.conf:

# Example .user.conf
DEFAULT_IMAGE_MODEL=flux