PPT Master — AI generates natively editable PPTX from any document

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

Gallery

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

---

Built by Hugo He

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 · 📧 [email protected] · 🐙 @hugohe3

---

Quick Start

1. Prerequisites

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

2. Pick an AI Editor

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)

3. Set Up

git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt

To update later: python3 skills/ppt-master/scripts/update_repo.py

4. Create

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.pptx snapshot 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.

5. AI Image Generation (Optional)

cp .env.example .env    # then edit with your API key

IMAGE_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.

---

Documentation

	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

---

Contributing

See CONTRIBUTING.md for how to get involved.

License

MIT

Acknowledgments

SVG Repo · Tabler Icons · Robin Williams (CRAP principles) · McKinsey, BCG, Bain

Contact & Collaboration

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 — [email protected]
• 🌐 Learn more about the author — www.hehugo.com

---

Star History

If this project helps you, please give it a ⭐!

---

Supported by DigitalOcean

This project is supported by:

---

Sponsor

If this project saves you time, consider buying me a coffee!

Alipay / 支付宝

---

Made with ❤️ by Hugo He

⬆ Back to Top