deck-generator

name	deck-generator
description	Generate professional presentations with AI-generated images. Use when asked to create a deck, presentation, pitch deck, or slides. Supports style presets (whiteboard, corporate, minimalist, etc). Uses Imagen 4.0 API for image generation and Google Slides API for assembly. Produces full decks from markdown content specs in minutes.

Deck Generator

Generate complete presentations where every slide is an AI-generated image in a consistent visual style.

Quick Start

1. Read the content spec (user provides slide content or a markdown file)
2. Read references/styles.md to pick or customize a visual style
3. Run scripts/generate-deck.py with content + style

Workflow

Step 1: Content Spec

Accept slide content in any format. Normalize to this structure per slide:

• Title: Bold headline
• Body: Key points, stats, or narrative
• Visual cues: Icons, diagrams, layouts described in words

If user provides a markdown file with --- separators, parse each section as a slide. If user provides a topic only, generate 10-14 slides following standard deck structures.

Step 2: Style Selection

Available style presets:

Style	Description
whiteboard	Hand-drawn sketch on white. Black ink, orange accents.
corporate	Navy/white/gold. Clean sans-serif. Professional.
minimalist	Pure white, electric blue accent. Maximum negative space.
dark-tech	Near-black background, neon green. Terminal aesthetic.
playful	Bright pastels, rounded shapes. Modern startup vibe.
editorial	Black/white with red spot color. Magazine aesthetic.

Default: whiteboard. User can specify any preset or describe a custom style.

Step 3: Generate

# Set your API key
export GEMINI_API_KEY="your-gemini-api-key"

# Run the generator
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "Deck Title" \
  [--output-dir ./output] \
  [--aspect 16:9]

The script:

1. Generates each slide image via Imagen 4.0 API
2. Saves all images to the output directory
3. Optionally creates a Google Slides presentation (requires Google Slides API credentials)
4. Returns paths to all generated images

Step 4: Review & Iterate

To regenerate individual slides:

python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --slides 3,7 \
  --output-dir ./output

Key Details

• Cost: ~4 cents per image. A 14-slide deck costs roughly 56 cents in API calls.
• Speed: ~2 minutes for 14 slides.
• API: Imagen 4.0 via Google's Generative Language API
• Auth: Set $GEMINI_API_KEY environment variable
• Aspect ratios: 16:9 (default), 1:1, 4:3, 3:4, 9:16
• Image models: imagen-4.0-generate-001 (best quality), imagen-4.0-fast-generate-001 (faster)

Content JSON Format

[
  {"name": "01-title", "prompt": "Title slide: 'Your Deck Title' with company logo placeholder"},
  {"name": "02-problem", "prompt": "Problem slide showing frustrated marketer staring at dashboard with declining metrics"},
  {"name": "03-solution", "prompt": "Solution slide: AI agent workflow diagram with 3 connected boxes"}
]

Google Slides Integration (Optional)

To automatically create a Google Slides presentation, set up Google Slides API credentials:

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "My Deck" \
  --google-slides \
  --google-account [e-mail]