PPT Master — AI generates natively editable PPTX from any document

English | 中文

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

_{↑ 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.}

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.

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 AI model usage. As AI tools move to usage-based billing, you pay exactly what you consume — no separate PPT subscription added on top
• 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

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

See live examples → · examples/ — 22 projects, 309 pages · Why PPT Master?

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 reviews and edits hundreds of slides every week. I got tired of AI tools that output images instead of editable shapes — so I built this.

🌐 Personal website · 📧 heyug3@gmail.com · 🐙 @hugohe3

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

PPT Master is currently built and maintained primarily by me. Every new template, bug fix, and documentation update takes ongoing resources — currently shared by the sponsors and individual supporters below.

Corporate sponsors

Cloud infrastructure support via the DigitalOcean Open Source Credits Program.

Individual support

If PPT Master has been helpful to you, individual support of any amount helps keep the project moving and free.

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

_{Official distribution: GitHub (primary) · AtomGit (mirror). Redistributions on other platforms are unofficial. MIT licensed — attribution required.}

⬆ Back to Top