by hugohe3
AI generates natively editable PPTX from any document — real PowerPoint shapes with native animations, not images · by Hugo He
# Add to your Claude Code skills
git clone https://github.com/hugohe3/ppt-masterLast scanned: 4/19/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-19T05:59:04.928Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": false
}English | 中文
Drop in a PDF, DOCX, URL, or Markdown — get back a natively editable PowerPoint with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.
Animations — exported decks support page transitions and per-element entrance animations as real OOXML, not embedded video. By default, elements cascade in automatically on slide entry — no clicking needed. Plays natively in PowerPoint and Keynote, no extra tooling. See Animations & Transitions →.
Narration & Video — generate per-slide voice narration from the speaker notes (90+ locales via
edge-tts), embed the audio back into the PPTX, and let PowerPoint export the deck as an MP4 video — synced narration + transitions, no third-party tools. See Audio Narration & Video Export →.
How it works — PPT Master is a workflow (a "skill") that works inside AI IDEs like Claude Code, Cursor, VS Code + Copilot, or Codebuddy. You chat with the AI — "make a deck from this PDF" — and it follows the workflow to produce a real editable on your computer. No coding on your side; the IDE is just where the conversation happens.
No comments yet. Be the first to share your thoughts!
.pptxWhat you'll do: install Python, install an AI IDE, drop in your material.
PPT Master is different:
AI presentation tools roughly fall into four categories. PPT Master only does the last one:
| Category | Output | Editable element-by-element in PowerPoint? | |---|---|:---:| | Template fill-in | PPTX built from a fixed template | Partially — limited by the template | | Image-based | One large image per slide, packed into PPTX | ❌ each slide is a picture | | HTML presentation | Web-based deck | ❌ not a PPTX | | Native editable (PPT Master) | Real DrawingML shapes, text boxes, charts | ✅ click any element to edit |
See live examples → · examples/ — 22 projects, 309 pages · Why PPT Master?
I'm a finance professional (CPA · CPV · Consulting Engineer (Investment)) who regularly reviews and edits presentation decks. I wanted AI-generated slides to remain editable in PowerPoint, not flattened into images — so I built this.
🌐 Personal website · 📧 heyug3@gmail.com · 🐙 @hugohe3
You only need Python. Everything else is installed via pip install -r requirements.txt.
| Dependency | Required? | What it does | |------------|:---------:|--------------| | Python 3.10+ | ✅ Yes | Core runtime — the only thing you actually need to install |
TL;DR — Install Python, run
pip install -r requirements.txt, and you're ready to generate presentations.
Windows requires a few extra steps (PATH setup, execution policy, etc.). We wrote a step-by-step guide specifically for Windows users:
📖 Windows Installation Guide — from zero to a working presentation in 10 minutes.
Quick version: download Python from python.org → check "Add to PATH" during install → pip install -r requirements.txt → done.
# macOS
brew install python
pip install -r requirements.txt
# Ubuntu / Debian
sudo apt install python3 python3-pip
pip install -r requirements.txt
Two external tools exist as fallbacks for edge cases. Most users will never need them — install only if you hit one of the specific scenarios below.
| Fallback | Install only if… |
|----------|-----------------|
| Node.js 18+ | You need to import WeChat Official Account articles and curl_cffi (part of requirements.txt) has no prebuilt wheel for your Python + OS + CPU combination. In normal setups web_to_md.py handles WeChat directly through curl_cffi. |
| Pandoc | You need to convert legacy formats: .doc, .odt, .rtf, .tex, .rst, .org, or .typ. .docx, .html, .epub, .ipynb are handled natively by Python — no pandoc required. |
# macOS (only if the above conditions apply)
brew install node
brew install pandoc
# Ubuntu / Debian
sudo apt install nodejs npm
sudo apt install pandoc
PPT Master runs in any tool with agent capability — read/write files, execute commands, and sustain multi-turn conversation.
| Type | Examples | Notes | |---|---|---| | IDE-native agent | • VS Code architecture (VS Code itself, plus forks & derivatives): Cursor, Trae, Codebuddy IDE, Windsurf, Void, etc.• Other architectures: Zed, etc. | Editor with a built-in agent | | IDE plugin / extension | GitHub Copilot, Claude Code (VS Code / JetBrains extension), Cline, Continue, Roo Code, etc. | Installed inside hosts like VS Code or JetBrains