---

⚡ Transform any idea into a professional presentation

🤖 Multi-LLM OpenAI • Gemini • Claude Ollama • Custom APIs

🎨 Smart Templates Auto-layout • Themes Professional designs

💬 Chat Editor Iterate with AI Real-time editing

📦 Export PPTX • PDF One-click download

---

📋 Table of Contents

Click to expand/collapse

• ✨ Features
• 🏗️ Architecture
• 🚀 Quick Start
• ⚙️ Configuration
• 🔌 API Reference
• 🐳 Docker
• 🧪 Testing
• 📖 Usage Examples
• 🗺️ Roadmap
• 📝 Changelog
• 🤝 Contributing

---

✨ Features

🤖 AI-Powered Generation

Feature	Description
🧠 Smart Outlines	AI generates structured outlines from any topic
📝 Content Generation	Full slide content with speaker notes
🎯 Tone Control	Professional, casual, academic, creative
🌍 Multi-language	Generate in 50+ languages
📊 Verbosity Levels	Concise, standard, or detailed

🎨 Design & Templates

Feature	Description
🖼️ Auto-Layout	AI picks the best slide layout per content
🎭 Theme Engine	Generate custom color themes with AI
📐 Template Studio	Create and save custom templates
🖌️ Smart Styling	Automatic font sizing and spacing

🔗 Integrations

Provider	Models	Status
OpenAI	GPT-4.1, GPT-4o, o3, o4-mini	✅
Google	Gemini 2.5 Pro/Flash	✅
Anthropic	Claude Sonnet/Opus	✅
Ollama	Llama, Mistral, Phi, etc.	✅
GitHub Models	All OpenAI models	✅
Custom	Any OpenAI-compatible API	✅

📄 Document Processing

Feature	Description
📑 PDF Upload	Extract content from PDF documents
📊 PPTX Import	Import and edit existing presentations
📝 Text/Markdown	Generate from plain text or markdown
🔍 Smart Chunking	Semantic document splitting

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                       DeckCraft                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─────────────┐    ┌──────────────┐    ┌───────────────┐  │
│  │  packages/  │    │   desktop/   │    │ export-engine/ │  │
│  │             │    │              │    │               │  │
│  │  ┌───────┐ │    │  Electron    │    │  PPTX/PDF     │  │
│  │  │  api/ │ │◄───│  Desktop     │    │  Generation   │  │
│  │  │       │ │    │  App         │    │  Runtime      │  │
│  │  │FastAPI│ │    └──────────────┘    └───────────────┘  │
│  │  └───┬───┘ │                                           │
│  │      │     │         ┌──────────┐                      │
│  │  ┌───▼───┐ │         │  tools/  │                      │
│  │  │  web/ │ │         │          │                      │
│  │  │       │ │         │  Build & │                      │
│  │  │Next.js│ │         │  Deploy  │                      │
│  │  └───────┘ │         └──────────┘                      │
│  └─────────────┘                                           │
└─────────────────────────────────────────────────────────────┘

📂 Detailed Structure

DeckCraft/
├── 📦 packages/
│   ├── 🐍 api/                 # FastAPI Backend
│   │   ├── app/                # Routes, middleware, lifespan
│   │   ├── core/               # LLM integration, utilities
│   │   ├── providers/          # Services (DB, image gen, docs)
│   │   ├── schemas/            # Pydantic & SQL models
│   │   ├── config/             # Constants & configuration
│   │   ├── templates/          # Slide template schemas
│   │   └── tests/              # Pytest test suite
│   │
│   └── 🌐 web/                 # Next.js Frontend
│       ├── app/                # App Router pages
│       ├── shared/             # Reusable UI components
│       ├── state/              # Redux store & slices
│       ├── lib/                # Utility functions
│       └── types/              # TypeScript definitions
│
├── 🖥️ desktop/                 # Electron App
│   ├── app/                    # Main process & IPC
│   ├── resources/              # Bundled runtime assets
│   └── build/                  # Installer configs & icons
│
├── 📤 export-engine/           # PPTX export runtime
├── 🔧 tools/                   # Build & deploy scripts
├── 🐳 Dockerfile              # Production container
├── 🐳 docker-compose.yml      # Full stack orchestration
└── 📖 README.md               # You are here!

---

🚀 Quick Start

💻 Local Development

Prerequisites

Tool	Version	Purpose
Python	3.11+	Backend runtime
Node.js	18+	Frontend runtime
uv	Latest	Python package manager
npm	9+	Node package manager

1️⃣ Clone & Setup Backend

# Clone the repository
git clone https://github.com/rioryugen/DeckCraft.git
cd DeckCraft

# Install backend dependencies
cd packages/api
uv sync

# Create environment config
cp ../../.env.example .env
# Edit .env with your API keys

2️⃣ Start Backend

cd packages/api
uv run uvicorn server:app --host 0.0.0.0 --port 8000

3️⃣ Start Frontend

cd packages/web
npm install
npm run dev

4️⃣ Open in Browser

🌐 Frontend:  http://localhost:3000
📡 API Docs:  http://localhost:8000/docs

🐳 Docker (One-Command Setup)

# Clone and run
git clone https://github.com/rioryugen/DeckCraft.git
cd DeckCraft

# Set your API key
echo "OPENAI_API_KEY=your-key-here" > .env

# Launch everything
docker compose up -d

Access at http://localhost:3000 🎉

---

⚙️ Configuration

🔑 Environment Variables

Variable	Description	Default	Required
LLM	Provider: openai | google | anthropic | ollama | custom	openai	✅
OPENAI_API_KEY	OpenAI API key	-	If using OpenAI
GOOGLE_API_KEY	Google Gemini API key	-	If using Google
ANTHROPIC_API_KEY	Anthropic API key	-	If using Anthropic
CUSTOM_LLM_URL	Custom OpenAI-compatible endpoint	-	If using custom
CUSTOM_MODEL	Model name for custom provider	-	If using custom
CUSTOM_LLM_API_KEY	API key for custom provider	-	If using custom
DISABLE_THINKING	Disable thinking param (for GitHub Models)	false	No
DISABLE_IMAGE_GENERATION	Skip AI image generation	false	No
DISABLE_AUTH	Disable authentication	false	No
APP_DATA_DIRECTORY	Storage path for presentations	./app_data	No
MEM0_ENABLED	Enable AI memory features	false	No

🤖 Provider Quick Setup

OpenAI (Default)

LLM=openai
OPENAI_API_KEY=sk-...

GitHub Models (Free)

LLM=custom
CUSTOM_LLM_URL=https://models.github.ai/inference
CUSTOM_MODEL=openai/gpt-4.1
CUSTOM_LLM_API_KEY=ghp_...
DISABLE_THINKING=false

Ollama (Local)

LLM=ollama
OLLAMA_URL=http://localhost:11434

Google Gemini

LLM=google
GOOGLE_API_KEY=AI...

---

🔌 API Reference

📡 Endpoints

Generate Presentation

POST /api/v1/ppt/presentation/generate
Content-Type: application/json

{
  "content": "Benefits of Remote Work",
  "n_slides": 5,
  "language": "English",
  "template": "general",
  "tone": "professional",
  "verbosity": "standard",
  "export_as": "pptx"
}

Response:

{
  "id": "uuid-here",
  "status": "completed",
  "download_url": "/api/v1/ppt/presentation/{id}/download"
}

List Presentations

GET /api/v1/ppt/presentations

Get Presentation Status

GET /api/v1/ppt/presentation/{id}/status

Chat with Presentation

POST /api/v1/ppt/chat
Content-Type: application/json

{
  "presentation_id": "uuid-here",
  "message": "Make slide 3 more concise"
}

🐍 Python SDK Example

import requests

# Generate a presentation
response = requests.post("http://localhost:8000/api/v1/ppt/presentation/generate", json={
    "content": "Introduction to Machine Learning",
    "n_slides": 6,
    "language": "English",
    "template": "general",
    "tone": "academic",
    "verbosity": "detailed",
    "export_as": "pptx"
})

result = response.json()
print(f"Presentation ID: {result['id']}")

📜 cURL Examples

# Generate presentation
curl -X POST http://localhost:8000/api/v1/ppt/presentation/generate \
  -H "Content-Type: application/json" \
  -d '{"content":"AI in Healthcare","n_slides":5,"language":"English","template":"general","tone":"professional","verbosity":"standard","export_as":"pptx"}'

# List all presentations
curl http://localhost:8000/api/v1/ppt/presentations

# Download PPTX
curl -O http://localhost:8000/api/v1/ppt/presentation/{id}/download

---

🧪 Testing

# Backend tests
cd packages/api
uv run pytest

# With coverage
uv run pytest --cov=. --cov-report=html

# Frontend tests
cd packages/web
npx cypress run

---

📖 Usage Examples

📊 Business Pitch Deck

{
  "content": "SaaS startup pitch for an AI writing assistant. Target: Series A investors. Key metrics: 50k MAU, 200% MoM growth, $2M ARR.",
  "n_slides": 10,
  "tone": "professional",
  "verbosity": "standard"
}

🎓 Educational Lecture

{
  "content": "Introduction to Quantum Computing for undergraduate students. Cover qubits, superposition, entanglement, and current applications.",
  "n_slides": 12,
  "tone": "academic",
  "verbosity": "detailed"
}

🚀 Product Launch

{
  "content": "New smartwatch launch. Features: health monitoring, 7-day battery, water resistance, AI assistant integration.",
  "n_slides": 8,
  "tone": "creative",
  "verbosity": "concise"
}

---

🗺️ Roadmap

Phase	Feature	Status
✅	Multi-LLM support	Done
✅	Template engine	Done
✅	Chat-based editing	Done
✅	PPTX export	Done
✅	Docker deployment	Done
🔄	PDF export	In Progress
📋	Real-time collaboration	Planned
📋	Plugin system	Planned
📋	Presentation analytics	Planned

---

📝 Changelog

v1.0.0 (2026-05-22)

• 🎉 Initial release
• 🤖 Multi-LLM support (OpenAI, Google, Anthropic, Ollama, Custom)
• 🎨 Template-based slide generation
• 💬 Chat-based iterative editing
• 📦 PPTX export
• 🐳 Docker support
• 🖥️ Electron desktop app

---

🤝 Contributing

Contributions welcome! Please:

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

---

📄 License

MIT License © 2026 RioRyuGen

---

👤 Author

RioRyuGen

---

_{Built with ❤️ using FastAPI, Next.js, and AI}