AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
Windows Installation Guide
This guide walks you through installing PPT Master on Windows step by step. Follow along and you'll have a working setup in under 10 minutes.
Step 1 — Install Python (Required)
Python is the only hard requirement.
Go to python.org/downloads and download the latest Python 3.10+ installer.
⚠️ CRITICAL: Check "Add python.exe to PATH" during installation — this is the single most common mistake on Windows. Skipping this will break every step that follows.
After installation, open PowerShell (search "PowerShell" in Start menu) and verify:
python --versionYou should see
Python 3.12.xor similar. If you see "Python was not found" or it opens the Microsoft Store, see Troubleshooting below.
💡 Tip: Python installed via Anaconda or Miniconda works too — just make sure
python --versionshows 3.10+.
Step 2 — Download the Project
Option A — Download ZIP (easiest):
- Go to github.com/hugohe3/ppt-master, or use the AtomGit mirror in mainland China
- Click the green Code button → Download ZIP
- Unzip to
C:\Users\YourName\ppt-master
Option B — Git Clone (requires Git). Run one of these clone commands:
# GitHub
git clone https://github.com/hugohe3/ppt-master.git
# AtomGit mirror
git clone https://atomgit.com/hugohe3/ppt-master.git
Then enter the cloned folder:
cd ppt-master
Step 3 — Install Dependencies
cd C:\Users\YourName\ppt-master # ← adjust to your actual path
pip install -r requirements.txt
If
pipis not recognized, trypython -m pip install -r requirements.txt.
Wait for it to finish. You should see Successfully installed ... at the end.
Step 4 — Verify Your Setup
python -c "import pptx; import fitz; print('All core dependencies OK')"
✅ Output: All core dependencies OK → you're good.
❌ Error → see Troubleshooting below.
Step 5 — Run a Minimal Example
Open the ppt-master folder in an agent-capable AI tool (Claude Code, Codex, Cursor, a VS Code agent, etc.) and type in the chat:
Quickly generate a simple 3-page test PPT with a cover, one content page, and a closing page. Topic: "Hello World". No need to confirm with me.
Asking for quick generation is what keeps this smoke test short: the AI skips the Strategist analysis and the design-confirmation round trips and goes straight to authoring and export. The default flow confirms the design spec with you first, which is what you want for a real deck but slow when all you are checking is that the environment works. Full guide → Quick mode.
When it finishes, you should see:
- A native DrawingML
.pptxunderexports/, generated fromsvg_output/, that opens in PowerPoint and remains editable element by element.
That's the check that matters — if the file is there and opens, you're done. Note that quick generation skips finalize_svg.py, so there is no svg_final/ preview directory; the default flow produces one, containing self-contained visual-preview SVGs. They may be inserted manually as SVG pictures, but manual "Convert to Shape" is outside the supported contract.
Step 6 — Optional Enhancements (most users can skip this)
With Python and requirements.txt installed, you already have everything needed to generate presentations. PPTX export writes native DrawingML shapes, so it does not require CairoSVG, GTK, or a separate SVG rasterization stack. The item below is an edge-case fallback — install it only if you hit the specific scenario.
| Enhancement | Install only if… | How to install | Verify |
|---|---|---|---|
| Pandoc — legacy document formats | You need to convert .doc, .odt, .rtf, .tex, .rst, .org, or .typ. .docx/.html/.epub/.ipynb work natively in Python. |
Download .msi from pandoc.org |
pandoc --version |
Troubleshooting
python was not found or opens Microsoft Store
Cause: Python isn't in your system PATH.
Fix 1 — Re-run the Python installer → Modify → check "Add Python to environment variables".
Fix 2 — Manually add to PATH:
- Run
where pythonin PowerShell first to find the actual path (e.g.C:\Users\YourName\AppData\Local\Programs\Python\Python312\python.exe) - Search "Environment Variables" in Start menu
- Find
Path→ Edit → add the directory from step 1 and itsScriptssubfolder:C:\Users\YourName\AppData\Local\Programs\Python\Python312 C:\Users\YourName\AppData\Local\Programs\Python\Python312\Scripts - Click OK, then restart PowerShell
Fix 3 — Try python3 or py instead.
A python3 command fails (exit 49 / opens Microsoft Store)
The python.org installer ships python.exe but not python3.exe. Just replace python3 with python in the command (the AI agent usually switches to python and continues on its own too).
pip install fails with permission errors
pip install --user -r requirements.txt
Or run PowerShell as Administrator.
pip install fails due to network issues
# Tsinghua PyPI mirror
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# Proxy
pip install -r requirements.txt --proxy http://your-proxy:port
ModuleNotFoundError
pip installed to a different Python. Use python -m pip install -r requirements.txt to match.
import fitz fails
- Upgrade pip:
python -m pip install --upgrade pip - Pre-built wheel:
pip install PyMuPDF --only-binary :all: - Still failing → install Visual C++ Build Tools
PowerShell says "running scripts is disabled"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Still stuck?
- 📖 FAQ
- 🐛 GitHub Issues — include your Python version, Windows version, and full error message
- 💬 GitHub Discussions