MCPcopy
hub / github.com/hugohe3/ppt-master

github.com/hugohe3/ppt-master @v2.13.0 sqlite

repository ↗ · DeepWiki ↗ · release v2.13.0 ↗
1,834 symbols 6,692 edges 143 files 1,019 documented · 56%
README

PPT Master — AI generates natively editable PPTX from any document

Version License: MIT GitHub stars AtomGit stars The Agentic Leaderboard

hugohe3%2Fppt-master | Trendshift

English | 中文

This project is kept free and open source with the support of PackyCode, APIKEY.FUN, RunAPI, YouYun ZhiSuan and other sponsors.

PackyCode Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our project users: register using this link and enter the promo code ppt-master during recharge to get 10% off.
APIKEY.FUN Thanks to APIKEY.FUN for sponsoring this project! APIKEY.FUN is a professional enterprise-grade AI relay service committed to stable, efficient, and low-cost AI access for businesses and developers. The platform supports mainstream models including Claude, OpenAI, and Gemini, with prices as low as 7% of official rates. Register through our dedicated link for an exclusive perk: up to 5% off on top-ups, permanently.
RunAPI Thanks to RunAPI for sponsoring this project! RunAPI is an efficient and stable API platform — a single API Key gives you access to 150+ leading models, including OpenAI, Claude, Gemini, DeepSeek, and Grok, at prices as low as 10% of official rates, with exceptional stability and seamless compatibility with tools like Claude Code. RunAPI offers an exclusive perk for PPT Master users: register and contact an administrator via our dedicated link to claim ¥7 in free credit.
YouYun ZhiSuan Thanks to YouYun ZhiSuan for sponsoring this project! YouYun ZhiSuan is UCloud's AI cloud platform, providing one-stop API services for mainstream domestic and international models, all accessible with a single key. The platform features cost-effective CodingPlan packages for domestic models (including GLM5.2, Deepseek-v4, and more), along with official channels for stable access to overseas models, meeting diverse development needs. It's compatible with mainstream AI coding tools like Claude Code and Codex, as well as general API calls. The platform supports enterprise-level high concurrency, 24/7 technical support, and self-service invoicing. Register through this link to receive up to ¥10 in free credits. This project has been built into an Agent — PPT Master — ready to use without local deployment.

[!IMPORTANT]

This is a tool, not a wishing well

Don't expect it to hand you a finished, perfect deck in one shot. Its real value is taking most of the tedious work off your plate; the polishing that's left is yours — a natively editable deck exists precisely so you can keep working on it, not a flat image you can't touch. The cheaper the model, the more there is to do. How good the result turns out comes down to your skill with this project and with PowerPoint.

Live Demo · Examples · FAQ · Roadmap

Download the new narrated Attention Is All You Need deck — play it in PowerPoint and every slide reads itself out loud. That's just the tip of what PPT Master can do.

Of course, you can also download any of the six example decks below — opening the raw .pptx in PowerPoint is the fastest way to see this project's real capability ceiling.

Editorial magazine — Pritzker 2026 architecture review Editorial Magazine — architecture photography, calm typographic grid Flip online · Download .pptx Data journalism — Global AI Capital 2026 Data Journalism — Bloomberg-style dark dashboard, chart-driven Flip online · Download .pptx Swiss typographic grid — Grid Systems primer Swiss Grid — strict modular grid, restrained type, red-accent Flip online · Download .pptx
Glassmorphism SaaS — AI Agent engineering demo Glassmorphism SaaS — translucent layers, gradient depth, product UI Flip online · Download .pptx Memphis pop — Sugar Rush festival Memphis Pop — bold primaries, geometric patterns, playful energy Flip online · Download .pptx Risograph zine — Indie bookstore guide Risograph Zine — duotone print, hand-made bookstore-culture feel Flip online · Download .pptx

Generated with Claude Opus 4.7 + gpt-image-2. Flip through all examples online → · examples/ directory · Why PPT Master?


Drop in your source material and get back a real PowerPoint: directly editable, with native slide transitions and entrance animations, speaker notes you can turn into audio narration, and the option to follow your own PPT template — a complete deck you can present as-is and keep editing. How to use each capability → Getting Started.

⚠️ PPT Master is a harness, not a complete agent. harness + model = agent — the tool owns the workflow; the model sets the ceiling. To form a genuinely high-quality agent, use Claude with a large context window (~1M tokens) + AI image generation (gpt-image-2). Other models can run the pipeline but cannot reach the same quality ceiling. If results disappoint, upgrade the model — don't blame the harness.

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.

Why it's shaped this way — knowing how to use Python and AI agents will matter more and more. This project is meant to show how far you can go with just those two things. There's a learning curve if you're starting cold, but it's the curve worth climbing. Making a deck is just the excuse — what I'm really pushing is Python and agents.

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:

Category Output Editable element-by-element in PowerPoint?
Template fill-in PPTX built from a fixed template Partially — limited by the template
Image-based One large image per slide, packed into PPTX ❌ each slide is a picture
HTML presentation Web-based deck ❌ not a PPTX
Native editable (PPT Master) Real DrawingML shapes, text boxes, charts ✅ click any element to edit

The person using it matters more

The examples above were all made in a single pass — I didn't even refine them; spend some time polishing and it's a different story entirely. With the same PowerPoint, a designer can produce something stunning while most people only ever touch a few basic features — the difference isn't the tool, it's the person using it. If you can't get there yet, it's most likely that you haven't learned the workflow — start with Getting Started and the example projects.

The best results do need Claude. Before you call it expensive, think about what it would cost to hire someone to produce a deck at the same level. The project also supports GPT, Gemini, Kimi, and other models — the results simply differ. Expecting top-tier output while paying the lowest possible cost was never reasonable to begin with.


Built by

Core symbols most depended-on inside this repo

el
called by 105
skills/ppt-master/scripts/confirm_ui/static/app.js
t
called by 84
skills/ppt-master/scripts/svg_editor/static/app.js
configure_utf8_stdio
called by 72
skills/ppt-master/scripts/console_encoding.py
t
called by 69
skills/ppt-master/scripts/confirm_ui/static/app.js
px_to_emu
called by 67
skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py
escapeHtml
called by 59
skills/ppt-master/scripts/svg_editor/static/app.js
_qn
called by 57
skills/ppt-master/scripts/template_fill_pptx/ooxml.py
_f
called by 54
skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py

Shape

Function 1,569
Method 190
Class 57
Route 18

Languages

Python88%
TypeScript12%

Modules by API surface

skills/ppt-master/scripts/svg_editor/static/app.js126 symbols
skills/ppt-master/scripts/confirm_ui/static/app.js93 symbols
skills/ppt-master/scripts/svg_quality_checker.py64 symbols
skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.py58 symbols
skills/ppt-master/scripts/svg_editor/server.py55 symbols
skills/ppt-master/scripts/svg_position_calculator.py54 symbols
skills/ppt-master/scripts/source_to_md/doc_to_md.py52 symbols
skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py46 symbols
skills/ppt-master/scripts/pptx_to_svg/prstgeom_to_svg.py39 symbols
skills/ppt-master/scripts/project_manager.py37 symbols
skills/ppt-master/scripts/native_narration_pptx.py35 symbols
skills/ppt-master/scripts/source_to_md/ppt_to_md.py34 symbols

Dependencies from manifests, versioned

Pillow9.0.0 · 1×
PyMuPDF1.23.0 · 1×
beautifulsoup44.12.0 · 1×
curl_cffi0.7.0 · 1×
ebooklib0.18 · 1×
edge-tts7.2.8 · 1×
flask3.0.0 · 1×
google-genai1.0.0 · 1×
mammoth1.6.0 · 1×
markdownify0.11.6 · 1×
nbconvert7.0.0 · 1×
numpy1.20.0 · 1×

For agents

$ claude mcp add ppt-master \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact