Prompt2Deck ✨

Transform plain text into professional slide decks with AI

An AI-powered presentation generator that converts topics, outlines, or bullet points into polished PowerPoint presentations in seconds. Supports 6 themes, 8 starter templates, multiple export formats, and works with or without an API key.

⭐ If you find this useful, please star the repo — it helps a lot!

🎯 Features

Core

🤖 Multi-LLM Support — OpenAI, Anthropic (Claude), Groq, and Ollama (local/free)
📝 Multiple Input Formats — Simple topics, bullet lists, or nested outlines
🎨 6 Professional Themes — Professional, Modern, Minimal, Dark, Nature, Corporate
🗣️ Speaker Notes — Auto-generated presentation guidance for each slide
🖼️ Image Support — Optional DALL-E 3 integration for slide visuals (OpenAI)
💰 Cost-Effective — ~$0.01-0.05 per presentation, or free with Ollama
⚙️ UI Settings — Configure API keys and models from the web interface (no .env editing)

Export & Formats

📊 PowerPoint (PPTX) — Primary output with themed formatting
📄 PDF Export — Via LibreOffice headless conversion
📝 Markdown Export — Plain text version of your slides
🌐 HTML Export — Standalone web presentation with print support

Templates & History

📋 8 Starter Templates — Pitch Deck, Research Talk, Tutorial, QBR, and more
📁 Deck History — Browse, download, and manage past generations
📊 Usage Statistics — Track decks generated, slides created, themes used

Developer Experience

🖥️ Full CLI — Generate decks from the terminal with python cli.py generate "topic"
🌐 REST API — 10+ endpoints for programmatic access
🐳 Docker Support — One-command deployment with docker-compose
🌙 Dark Mode — Full dark mode support in the web UI
🔧 Mock Mode — Works without an API key using placeholder content
🔄 Hot Reload — Change LLM provider/model from the UI, no restart needed

📸 Demo

Input:                                    Output:
┌─────────────────────────┐              ┌─────────────────────────┐
│ Introduction to ML      │              │ ✅ 6-slide PPTX deck    │
│ * What is ML?           │    ──────►   │ ✅ Speaker notes        │
│ * Types of Learning     │              │ ✅ Themed formatting    │
│ * Real-world Apps       │              │ ✅ Markdown + HTML      │
└─────────────────────────┘              └─────────────────────────┘

🚀 Quick Start

Option 1: Automated Setup (Recommended)

git clone https://github.com/Abelo9996/Prompt2Deck.git
cd Prompt2Deck

# Run setup script
./setup.sh    # macOS/Linux
setup.bat     # Windows

# Optional: Add OpenAI key for AI content (works without it in mock mode)
cd backend
cp .env.example .env
# Edit .env: OPENAI_API_KEY=your_key_here

# Start backend
python main.py

Option 2: Docker

git clone https://github.com/Abelo9996/Prompt2Deck.git
cd Prompt2Deck

# Optional: set your key
echo "OPENAI_API_KEY=your_key_here" > .env

docker-compose up

Option 3: Manual Setup

# Backend
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
python main.py

# Frontend (separate terminal)
cd frontend
npm install
npm run dev

API: http://localhost:8000
Web UI: http://localhost:3000

🖥️ CLI Usage

cd backend

# Generate a deck
python cli.py generate "Introduction to AI" --theme modern

# Preview without generating
python cli.py preview "Machine Learning Basics"

# With all exports
python cli.py generate "Cloud Computing" -t dark --markdown --html

# List themes and templates
python cli.py themes
python cli.py templates

# View history and stats
python cli.py history
python cli.py stats

# Start the API server
python cli.py serve --port 8000

💻 Web Interface

The web UI features three tabs:

Tab	Description
✨ Generate	Input text, preview slides, configure options, generate deck
📋 Templates	Browse 8 starter templates across Business, Education, Academic, Marketing
📁 History	View, download, and delete past generations
⚙️ Settings	Configure LLM provider, API key, model — supports OpenAI, Anthropic, Groq, Ollama

Plus: dark mode toggle, stats bar, theme selector with 6 options, and multi-format export.

📡 API Reference

Method	Endpoint	Description
`GET`	`/`	Health check + endpoint list
`GET`	`/themes`	List available themes
`GET`	`/templates`	List starter templates
`GET`	`/templates/{id}`	Get specific template
`POST`	`/preview`	Preview slide structure
`POST`	`/generate`	Generate deck (PPTX + optional exports)
`GET`	`/settings`	Get current AI config (keys masked)
`POST`	`/settings`	Update AI provider/key/model
`POST`	`/settings/test`	Test API connection
`GET`	`/download/{filename}`	Download generated file
`GET`	`/history`	List generation history
`DELETE`	`/history/{deck_id}`	Delete history item
`GET`	`/stats`	Usage statistics

📚 See examples/api_examples.md for full examples.

📝 Input Formats

Simple Topic

Explain Large Language Models

→ Auto-generates 5-slide presentation

Bullet List

Introduction to Cloud Computing
* Infrastructure as a Service
* Platform as a Service
* Software as a Service

→ Each bullet becomes a slide

Nested Outline

Machine Learning Basics
1. Introduction
   - What is ML?
   - Why it matters
2. Types of Learning
   - Supervised
   - Unsupervised

→ Full control over slide structure

📚 See examples/sample_inputs.md for more examples

🎨 Themes

Theme	Style	Best For
Professional	Navy & blue, corporate	Business presentations
Modern	Coral & green, bold	Startups, pitches
Minimal	Black & white, clean	Academic, research
Dark	Dark bg, red accents	Tech talks, demos
Nature	Green tones, organic	Environmental, health
Corporate	Navy & teal, formal	Enterprise, finance

📋 Templates

Template	Category	Slides
Startup Pitch Deck	Business	~8
Project Status Update	Business	~7
Academic Lecture	Education	~8
Research Presentation	Academic	~8
Product Launch	Marketing	~8
Technical Tutorial	Education	~9
Quarterly Business Review	Business	~8
Workshop / Training	Education	~8

🛠️ Tech Stack

Component	Technology
Backend	Python 3.10+, FastAPI, python-pptx
Frontend	Next.js 14, React 18, TypeScript, Tailwind CSS
AI	OpenAI, Anthropic (Claude), Groq, Ollama (local)
Images	DALL-E 3 (optional, OpenAI only)
CLI	Click + Rich
Export	Markdown, HTML, PDF (via LibreOffice)
Deploy	Docker, docker-compose

🏗️ Architecture

Prompt2Deck/
├── backend/
│   ├── main.py              # FastAPI server (10+ endpoints)
│   ├── cli.py               # CLI tool (7 commands)
│   ├── models.py            # Pydantic schemas
│   └── pipeline/
│       ├── outline_parser.py      # Input parsing
│       ├── content_generator.py   # LLM content expansion
│       ├── image_generator.py     # DALL-E / placeholder
│       ├── slide_builder.py       # PPTX assembly (6 themes)
│       └── exporter.py           # Markdown / HTML export
├── frontend/
│   ├── pages/index.tsx      # Main app (3 tabs)
│   └── components/          # 6 React components
├── examples/                # Sample inputs & API examples
├── docs/                    # Architecture, contributing, dev guide
├── Dockerfile
└── docker-compose.yml

📖 See docs/ARCHITECTURE.md for detailed design

⚙️ Configuration

Backend (`backend/.env`)

# Optional — you can configure everything from the Settings tab in the UI instead
OPENAI_API_KEY=your_key_here    # Optional (mock mode without it)
OPENAI_MODEL=gpt-4o-mini        # Or any supported model
USE_DALLE=false                  # Enable DALL-E images
HOST=0.0.0.0
PORT=8000

💡 Tip: Skip the .env file entirely — just go to the Settings tab in the web UI to configure your provider, API key, and model. Supports OpenAI, Anthropic, Groq, and Ollama.

Frontend (`frontend/.env.local`)

NEXT_PUBLIC_API_URL=http://localhost:8000

🧪 Development

# Run tests
cd backend && pytest

# Format code
black .

# CLI help
python cli.py --help

📖 See docs/DEVELOPMENT.md for adding themes, templates, and export formats.

🗺️ Roadmap

Google Slides API integration
Batch processing for multiple decks
Custom template marketplace
Real-time collaboration
Notion/Docs integration
Ollama / local LLM support
Drag-and-drop slide reordering
Custom branding (logo, colors)

🐛 Troubleshooting

Issue	Solution
No API key	Works in mock mode — no key needed. Or use Ollama for free local inference
Quota exceeded	Add credits at platform.openai.com
Module not found	Run `pip install -r requirements.txt`
PDF export fails	Install LibreOffice: `brew install libreoffice`
Port in use	Change `PORT` in `.env` or use `--port` flag

📚 See docs/OPENAI_QUOTA_FIX.md for quota help.

🤝 Contributing

Contributions welcome! See docs/CONTRIBUTING.md.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

MIT License — see LICENSE.

🌟 Show Your Support

If this project helped you, please:

⭐ Star this repository — it really helps!
🍴 Fork it and build something cool
🐛 Report bugs or suggest features
🔀 Contribute code or docs
📢 Share with friends and colleagues

📬 Contact

Questions? Open an issue.

Built with ❤️ using AI and modern web technologies
Made by @Abelo9996

Name		Name	Last commit message	Last commit date
backend		backend
docs		docs
examples		examples
frontend		frontend
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
setup.bat		setup.bat
setup.sh		setup.sh

Latest commit

History

Folders and files

Repository files navigation