Version License: MIT GitHub stars AtomGit stars
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.
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 style — Medical image segmentation research
Academic — structured research format, data-driven
Dark Art — cinematic dark background, gallery aesthetic Nature style — Wildlife wetland documentary
Nature Documentary — immersive photography, minimal UI
Tech / SaaS — clean white cards, pricing table layout Product launch style — Xiaomi spring release
Product Launch — high contrast, bold specs highlight
Required: Python 3.8+ · 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
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
| 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) |
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: The
.pptxfile contains native shapes — directly editable. A second_svg.pptxreference file is also generated (use "Convert to Shape" in PowerPoint to edit). Requires Office 2016+.
AI lost context? Ask it to read
skills/ppt-master/SKILL.md.
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-preview
Supported 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 | Cost, editing, custom templates |
See CONTRIBUTING.md for how to get involved.
SVG Repo · Robin Williams (CRAP principles) · McKinsey, BCG, Bain
If this project helps you, please give it a ⭐!
If this project saves you time, consider buying me a coffee!
Alipay / 支付宝
Made with ❤️ by Hugo He