PPT Master — AI generates natively editable PPTX from any document

English | 中文

Live Demo · About Hugo He · Examples · FAQ · Contact

Official channels — this project is published only on GitHub (primary) and AtomGit (auto-synced mirror). Redistributions on any other platform are unofficial and not maintained by the author. Licensed under MIT — attribution required.

_{↑ A 12-page natively editable deck, generated end-to-end from a single WeChat article URL using Claude Opus 4.7. No manual design. No image export. Every shape, text box, and chart is clickable and editable in PowerPoint.}

_{🛡️ New: 10-page dark-tech deck generated from Anthropic's Claude Code Auto Mode engineering blog — see it in the examples.}

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.

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 .pptx on your computer. No coding on your side; the IDE is just where the conversation happens.

What you'll do: install Python, install an AI IDE, drop in your material. First-time setup is about 15 minutes. Each deck takes ~10–20 minutes of back-and-forth with the AI.

Why PPT Master?

There's no shortage of AI presentation tools — what's missing is one where the output is actually usable as a real PowerPoint file. I build presentations every day, but most tools export images or web screenshots: they look nice but you can't edit anything. Others produce bare-bones text boxes and bullet lists. And they all want a monthly subscription, upload your files to their servers, and lock you into their platform.

PPT Master is different:

• Real PowerPoint — if a file can't be opened and edited in PowerPoint, it shouldn't be called a PPT. Every element PPT Master outputs is directly clickable and editable
• Transparent, predictable cost — the tool is free and open source; the only cost is your own AI editor, and you know exactly what you're paying. As low as $0.08/deck with VS Code Copilot
• Data stays local — your files shouldn't have to be uploaded to someone else's server just to make a presentation. Apart from AI model communication, the entire pipeline runs on your machine
• No platform lock-in — your workflow shouldn't be held hostage by any single company. Works with Claude Code, Cursor, VS Code Copilot, and more; supports Claude, GPT, Gemini, Kimi, and other models

What category this tool belongs to

AI presentation tools roughly fall into four categories. PPT Master only does the last one:

If all you need is a deck that "looks usable," the first three are faster and cheaper. PPT Master is for people who need to keep editing the deck in PowerPoint afterward — incorporating it into formal materials, pitch decks, reports, etc. That positioning means each deck costs more to generate than template fill-in tools — not because the pipeline is unoptimized, but because the output itself is a more expensive artifact.

See live examples → · examples/ — 22 projects, 309 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 (Investment)) 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

PPT Master is built and maintained by one person, fully self-funded. Every new template, bug fix, and documentation update runs through AI models that cost real money — and right now those token bills come out of my own pocket.

If PPT Master has been helpful to you, consider chipping in. Sponsorship directly funds more templates, faster fixes, and keeps this project free and open-source.

Individual sponsorship

Any amount is appreciated.

Custom templates

Want a template that matches your brand or industry? Two paths:

• Do it yourself — PPT Master ships with a built-in /create-template workflow. Walkthrough in FAQ — How do I create a custom template?; spec in workflows/create-template.md.
• Hire me — for complex brand systems, private deployment, or integration consulting, I take on a limited number of paid engagements each quarter. 📧 heyug3@gmail.com

You only need Python. Everything else is installed via pip install -r requirements.txt.

TL;DR — Install Python, run pip install -r requirements.txt, and you're ready to generate presentations.

# macOS
brew install python
pip install -r requirements.txt

# Ubuntu / Debian
sudo apt install python3 python3-pip
pip install -r requirements.txt

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

Model recommendation: Claude Opus / Sonnet works best and is most tested. Other mainstream models (GPT, Gemini, Kimi, MiniMax, etc.) also work, but SVG absolute-coordinate layout precision varies.

Option A — Download ZIP (no Git required): click Code → Download ZIP on the GitHub page, then unzip.

Option B — Git clone (requires Git installed):

git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master

Then install dependencies:

pip install -r requirements.txt

To update later (Option B only): python3 skills/ppt-master/scripts/update_repo.py

Provide source materials (recommended): Place your PDF, DOCX, images, or other files in the projects/ directory, then tell the AI chat panel which files to use. The quickest way to get the path: right-click the file in your file manager or IDE sidebar → Copy Path (or Copy Relative Path) and paste it directly into the chat.

You: Please create a PPT from projects/q3-report/sources/report.pdf

Paste content directly: You can also paste text content straight into the chat window and the AI will generate a PPT from it.

You: Please turn the following into a PPT: [paste your content here...]

Either way, the AI will first confirm the design spec:

AI:  Sure. Let's confirm the design spec:
     [Template] B) Free design
     [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.

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

Multiple backends are supported across Core / Extended / Experimental tiers. Run python3 skills/ppt-master/scripts/image_gen.py --list-backends to see the full list. 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.

See CONTRIBUTING.md for how to get involved.

MIT

SVG Repo · Tabler Icons · Simple Icons · Phosphor Icons · Robin Williams (CRAP principles)

Looking to collaborate, integrate PPT Master into your workflow, or just have questions?

• 💬 Questions & sharing — GitHub Discussions
• 🐛 Bug reports & feature requests — GitHub Issues
• 🌐 Learn more about the author — www.hehugo.com

Want to build your own template? See FAQ — custom templates. For paid brand / consulting work, see Support This Project.

This project is supported by:

Made with ❤️ by Hugo He — if this project helps you, please give it a ⭐ and consider sponsoring.

⬆ Back to Top