Slideforge

Transform structured content into professional PowerPoint presentations.

AI-powered presentation generator that converts markdown outlines, JSON structures, and documents into well-designed PPTX files.

Overview

Slideforge uses intelligent content transformation to create high-quality presentations from various input formats. Built for educators, business professionals, and anyone who needs to create presentations efficiently.

Key Features

• Multiple Input Formats: Markdown, JSON outlines, plain text documents
• Smart Content Transformation: Automatically structures content for slides
• Template Support: Apply custom themes and corporate branding
• Speaker Notes: Detailed presenter notes generated automatically
• Best Practices Built-in: 6x6 rule, visual hierarchy, consistent styling
• Slide Type Variety: Title, content, comparison, image, quote slides

Quick Start

Installation

cd scripts
pip install -r requirements.txt

Basic Usage

From JSON:

cd scripts/pptx-generator
python pptx_generator.py --input content.json --output presentation.pptx

With Theme:

python pptx_generator.py -i content.json -o output.pptx -t themes/corporate.pptx

Python API

frompptx_generatorimportPPTXGenerator# Create presentationgenerator=PPTXGenerator()
generator.add_title_slide("My Presentation", "Subtitle here")
generator.add_content_slide("Key Points", [
"First important point",
"Second important point",
"Third important point"
])
generator.save("output.pptx")

Input Formats

Markdown

# Presentation Title## Introduction### Overview- First key point
- Second key point
- Third key point
## Main Content### Details- Supporting information
- Additional context

JSON

{
"metadata": {
"title": "Presentation Title",
"author": "Your Name",
"date": "2024-01-01"
},
"sections": [
{
"title": "Introduction",
"slides": [
{
"type": "content",
"title": "Overview",
"content": {
"bullets": ["Point 1", "Point 2", "Point 3"]
},
"notes": "Speaker notes here..."
}
]
}
]
}

Slide Types

Type	Description
title	Opening slide with title and subtitle
section_header	Section transition slide
content	Standard bullet point slide
two_content	Two-column layout
comparison	Side-by-side comparison with headers
image	Image-focused slide
quote	Quote with attribution
blank	Empty slide for custom content

Project Structure

/Slideforge/
├── CLAUDE.md # AI orchestration guide
├── README.md # This file
├── agents/ # AI agent specifications
├── scripts/
│ └── pptx-generator/ # Core generation module
├── schemas/
│ └── presentation/ # JSON schemas
├── templates/
│ └── pptx/ # Theme templates
├── inputs/ # Source content
└── exports/ # Generated presentations

Design Principles

Slideforge follows presentation best practices:

• 6x6 Rule: Maximum 6 bullet points per slide, 6 words per bullet
• One Idea Per Slide: Focus on a single concept
• Visual Hierarchy: Clear titles and logical flow
• Speaker Notes: Detailed notes for presenters
• Consistent Styling: Uniform layouts throughout

Documentation

• Getting Started - Quick start guide
• Workflow Reference - Detailed protocols
• Slide Design Guide - Design best practices

Dependencies

python-pptx>=0.6.21
Pillow>=9.0.0
beautifulsoup4>=4.9.0
jsonschema>=4.0.0

License

MIT License - See LICENSE file for details.

Contributing

Contributions welcome! Please read our contributing guidelines before submitting PRs.