smart-meme-generator

由人工智能驱动的模因生成器，可以从任何主题或情况创建完美的、上下文感知的模因。当用户想要创建模因、需要反应图像、想要使笑话可视化或需要病毒式社交媒体内容时使用。自动选择最佳模因模板并根据上下文生成诙谐的标题。

## 概述（中文）

由人工智能驱动的模因生成器，可以从任何主题或情况创建完美的、上下文感知的模因。当用户想要创建模因、需要反应图像、想要使笑话可视化或需要病毒式社交媒体内容时使用。自动选择最佳模因模板并根据上下文生成诙谐的标题。

## 原文

# Smart Meme Generator 🎭

Generate actual meme images from any topic. Uses imgflip API (free) for real image generation — returns shareable URLs.

## How It Works

Two-step process:
1. **Template selection** — analyzes topic keywords to pick the best meme format
2. **Image generation** — creates the actual meme image with your captions via imgflip API

The agent (you) provides the creative captions. The script handles template matching and image creation.

## Commands

### Select best template for a topic
```bash
python3 scripts/generate_meme.py "your topic here"
```
Returns recommended template and box count.

### Generate actual meme image
```bash
python3 scripts/generate_meme.py --template drake --captions "Bad option" "Good option"
```
Returns a real image URL (e.g., `https://i.imgflip.com/xxxxx.jpg`).

### List all templates
```bash
python3 scripts/generate_meme.py --list
```

### JSON output (for automation)
```bash
python3 scripts/generate_meme.py --template drake --captions "text1" "text2" --json
```

## Available Templates (20+)

| Key | Name | Boxes | Best For |
|-----|------|-------|----------|
| drake | Drake Hotline Bling | 2 | Comparisons, preferences |
| distracted | Distracted Boyfriend | 3 | Temptation, switching loyalties |
| fine | This Is Fine | 2 | Chaos, denial, everything's broken |
| brain | Expanding Brain | 4 | Escalating levels, galaxy brain takes |
| cat | Woman Yelling at Cat | 2 | Arguments, confusion |
| change | Change My Mind | 1 | Hot takes, controversial opinions |
| buttons | Two Buttons | 3 | Impossible choices, dilemmas |
| pikachu | Surprised Pikachu | 2 | Obvious/predictable outcomes |
| stonks | Stonks | 1 | Money, trading, crypto |
| panik | Panik Kalm Panik | 3 | Panic-relief-panic sequences |
| buff_doge | Buff Doge vs Cheems | 4 | Then vs now comparisons |
| uno | UNO Draw 25 | 2 | Refusing to do something |
| always_has_been | Always Has Been | 2 | Revelations |
| gru_plan | Gru's Plan | 4 | Plans that backfire |
| trade_offer | Trade Offer | 3 | Deals, exchanges |
| bernie | Bernie Asking | 1 | Repeated requests |
| left_exit | Left Exit Off Ramp | 3 | Ignoring the obvious choice |
| disaster_girl | Disaster Girl | 2 | Evil satisfaction |
| hide_pain | Hide the Pain Harold | 2 | Pretending everything's OK |
| think_about_it | Think About It | 2 | Big brain logic |

## Workflow for Agent

When user asks for a meme:
1. Run template selection with their topic to get the best format
2. Write witty, specific captions that fit the template (be creative, match internet humor)
3. Generate the image with `--captions`
4. Send the image URL to the user

**Caption tips:**
- Keep text SHORT — memes aren't essays
- Use internet humor conventions (lowercase, no periods, specific > generic)
- Match the template's energy (drake = preference, pikachu = obvious outcome, etc.)
- Be specific to the topic — generic captions are never funny

## Setup

The skill ships with a free imgflip account. To use your own:
```bash
export IMGFLIP_USER="your_username"
export IMGFLIP_PASS="your_password"
```
Register free at https://imgflip.com/signup

## Dependencies
None — pure Python stdlib (urllib only).