Deck Generator
Generate complete presentations where every slide is an AI-generated image in a consistent visual style.
Quick Start
- Read the content spec (user provides slide content or a markdown file)
- Read
references/styles.mdto pick or customize a visual style - Run
scripts/generate-deck.pywith 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:
- Generates each slide image via Imagen 4.0 API
- Saves all images to the output directory
- Optionally creates a Google Slides presentation (requires Google Slides API credentials)
- 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 ./outputKey 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_KEYenvironment 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 your-email@example.com