English | 中文
Live Demo · About Hugo He · Examples · FAQ · Contact
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.
What makes it different:
- Every element is a real PowerPoint object (DrawingML) — no "Convert to Shape" needed
- Works with Claude Code, Cursor, VS Code Copilot, and other AI editors
- 10+ output formats: PPT 16:9, social media cards, marketing posters, and more
- Low cost — as little as $0.08 per presentation with VS Code Copilot; even non-Opus models produce decent results
See live examples → · examples/ — 15 projects, 229 pages
 Magazine — warm earthy tones, photo-rich layout |
 Academic — structured research format, data-driven |
 Dark Art — cinematic dark background, gallery aesthetic |
 Nature Documentary — immersive photography, minimal UI |
 Tech / SaaS — clean white cards, pricing table layout |
 Product Launch — high contrast, bold specs highlight |
I'm a finance professional (CPA · CPV · Consulting Engineer) who got tired of spending hours on presentations that could be automated. So I built this.
PPT Master started from a simple frustration: existing AI slide tools export images, not editable shapes. As someone who reviews and edits hundreds of slides in investment and consulting work, that was unacceptable. I wanted real DrawingML — click on any element and change it, just like you built it by hand.
This project is my attempt to bridge the gap between domain expertise and product engineering — turning a complex professional pain point into an open-source tool that anyone can use.
🌐 Personal website · 📧 heyug3@gmail.com · 🐙 @hugohe3
Required: Python 3.10+ · Optional: Node.js 18+ (for WeChat page conversion) · Pandoc (for DOCX/EPUB conversion)
# macOS
brew install python
brew install node # optional — for WeChat page conversion
brew install pandoc # optional — for DOCX/EPUB conversion
# Ubuntu/Debian
sudo apt install python3 python3-pip
sudo apt install nodejs npm # optional
sudo apt install pandoc # optional
# Windows — download from python.org, nodejs.org, pandoc.org| Tool | Rating | Notes |
|---|---|---|
| Claude Code | ⭐⭐⭐ | Best results — native Opus, largest context |
| Cursor / VS Code + Copilot | ⭐⭐ | Good alternatives |
| Codebuddy IDE | ⭐⭐ | Best for Chinese models (Kimi 2.5, MiniMax 2.7) |
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txtTo update later: python3 skills/ppt-master/scripts/update_repo.py
Open the AI chat panel and describe what you want:
You: I have a Q3 quarterly report that needs to be made into a PPT
AI: Sure. Let's confirm the design spec:
[Template] B) No template
[Format] PPT 16:9
[Pages] 8-10 pages
...
The AI handles everything — content analysis, visual design, SVG generation, and PPTX export.
Output: Two timestamped files are saved to
exports/— a native-shapes.pptx(directly editable) and an_svg.pptxsnapshot for visual reference. Requires Office 2016+.
AI lost context? Ask it to read
skills/ppt-master/SKILL.md.
Something went wrong? Check the FAQ — it covers model selection, layout issues, export problems, and more. Continuously updated from real user reports.
cp .env.example .env # then edit with your API keyIMAGE_BACKEND=gemini # required — must be set explicitly
GEMINI_API_KEY=your-api-key
GEMINI_MODEL=gemini-3.1-flash-image-previewSupported backends: gemini · openai · qwen · zhipu · volcengine · stability · bfl · ideogram · siliconflow · fal · replicate
Run python3 skills/ppt-master/scripts/image_gen.py --list-backends to see tiers. Environment variables override .env. Use provider-specific keys (GEMINI_API_KEY, OPENAI_API_KEY, etc.) — global IMAGE_API_KEY is not supported.
Tip: For best quality, generate images in Gemini and select Download full size. Remove the watermark with
scripts/gemini_watermark_remover.py.
| Document | Description | |
|---|---|---|
| 📖 | SKILL.md | Core workflow and rules |
| 📐 | Canvas Formats | PPT 16:9, Xiaohongshu, WeChat, and 10+ formats |
| 🛠️ | Scripts & Tools | All scripts and commands |
| 💼 | Examples | 15 projects, 229 pages |
| 🏗️ | Technical Design | Architecture, design philosophy, why SVG |
| ❓ | FAQ | Model selection, cost, layout troubleshooting, custom templates |
See CONTRIBUTING.md for how to get involved.
SVG Repo · Tabler Icons · Robin Williams (CRAP principles) · McKinsey, BCG, Bain
Looking to collaborate, integrate PPT Master into your workflow, or just have questions?
- 💬 Questions & sharing — GitHub Discussions
- 🐛 Bug reports & feature requests — GitHub Issues
- 📧 Business & consulting inquiries — heyug3@gmail.com
- 🌐 Learn more about the author — www.hehugo.com
If this project helps you, please give it a ⭐!
This project is supported by:
If this project saves you time, consider buying me a coffee!
Alipay / 支付宝
Made with ❤️ by Hugo He