Skip to main content

ppt-master

Originated by hugohe3/ppt-master

This PyPI package is a fork maintained by elvisw. It fully ports the upstream direct-script invocation style (python3 + script path) to a unified uvx ppt-master <command> CLI (70+ subcommands), and adapts every command call in the skill workflow docs to the uvx form — once the fork's skill is installed, AI agents invoke the uvx tool automatically, with no clone and no pip install. The wheel bundles the skill, scripts, and templates (including the icon library). Sponsor and donation information shipped with the package belongs to the original author (Hugo He) and benefits the original project, not this fork.

AI-driven PPT generation CLI — convert documents to editable PowerPoint via SVG pipeline.

Install

# Install the skill (AI agents use it to invoke the uvx tool automatically)
npx skills add https://github.com/elvisw/ppt-master

# No install needed for the tool itself — run directly
uvx ppt-master <command>

Quick Start

# Create a project
uvx ppt-master project init my-presentation --format ppt169

# Convert source materials to Markdown
uvx ppt-master pdf-to-md paper.pdf -o my-presentation/sources/
uvx ppt-master web-to-md https://example.com -o my-presentation/sources/

# Post-process SVGs and export to PPTX
uvx ppt-master finalize-svg my-presentation
uvx ppt-master svg-to-pptx my-presentation

Commands

Command Description
project Create / validate / manage PPT projects
pdf-to-md Convert PDF to Markdown
doc-to-md Convert DOCX / HTML / EPUB to Markdown
excel-to-md Convert Excel to Markdown
ppt-to-md Convert PPTX to Markdown
web-to-md Convert URL to Markdown
image-gen AI image generation (multi-backend)
image-search Search and download web images
latex-render Render LaTeX formulas to PNG
analyze-images Analyze images and compute layout sizes
svg-quality-check Validate SVG against PPT constraints
total-md-split Split total.md into per-page files
finalize-svg Post-process SVGs (icons, images, text)
svg-to-pptx Export SVGs to PPTX
svg-editor Launch web-based SVG editor (live preview)
notes-to-audio Generate per-slide narration audio (TTS)
animation-config Create / validate animation configuration
pptx-template-import Extract SVG references from PPTX template
pptx-to-svg Convert PPTX to SVG
svg-position-calc Chart coordinate calculator
update-spec Propagate color / font changes to all SVGs
check-annotations Scan SVGs for edit annotations
visual-review Visual review via Playwright
update-repo Git pull + uv sync repository updater
register-template Register layout template
rotate-images Rotate images (EXIF + manual)
config List canvas formats and color presets
check-deps-sync Verify dependency manifest sync

Run uvx ppt-master without arguments to see the full list.

Configuration

AI backends use environment variables or a .env file:

OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...
IMAGE_BACKEND=openai

See .env.example in the source repository for all options.

Requirements

  • Python 3.12+
  • uv (recommended) or pip

License

MIT — see LICENSE in the original repository.

Metadata

Release files for ppt-master 0.1.114

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ppt-master 0.1.114
File Size Uploaded
ppt_master-0.1.114.tar.gz 13.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for ppt-master 0.1.114
File Interpreter ABI Platform
ppt_master-0.1.114-py3-none-any.whl Python 3 none any Details

Total release size: 32.2 MB

Release files / ppt_master-0.1.114.tar.gz

Download URL ppt_master-0.1.114.tar.gz
Size 13.5 MB
Tags Source
SHA-256 checksum
How to use checksums
703fa6b308f33a01a06dd45e96ab413fb3b89abb51b79c68f84a3b92e29ee792
BLAKE2b-256 checksum
How to use checksums
5db3de7f8a35105d0400e7d364646875b0a430dd526dfd371c940d907faa9b7a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / ppt_master-0.1.114-py3-none-any.whl

Download URL ppt_master-0.1.114-py3-none-any.whl
Size 18.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d54b42880249b0bde54dfea32589e9324cad1b102881e3def18c72915e60b3f8
BLAKE2b-256 checksum
How to use checksums
0e7b6562ae943ac009fca9e2eacfa22443a943e5ae7e990bc1b6bd4a01fc398b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.1.114 This release

2 release files

0.1.99

2 release files

0.1.98

2 release files

0.1.97

2 release files

0.1.96

2 release files

0.1.95

2 release files

0.1.94

2 release files

0.1.93

2 release files

0.1.92

2 release files

0.1.91

2 release files

0.1.90

2 release files

0.1.88

2 release files

0.1.87

2 release files

0.1.86

2 release files

0.1.85

2 release files

0.1.84

2 release files

0.1.83

2 release files

0.1.82

2 release files

0.1.81

2 release files

0.1.80

2 release files

0.1.79

2 release files

0.1.78

2 release files

0.1.77

2 release files

0.1.68

2 release files

0.1.67

2 release files

0.1.66

2 release files

0.1.65

2 release files

0.1.64

2 release files

0.1.63

2 release files

0.1.62

2 release files

0.1.61

2 release files

0.1.60

2 release files

0.1.59

2 release files

0.1.58

2 release files

0.1.57

2 release files

0.1.56

2 release files

0.1.55

2 release files

0.1.54

2 release files

0.1.53

2 release files

0.1.52

2 release files

0.1.51

2 release files

0.1.50

2 release files

0.1.49

2 release files

0.1.48

2 release files

0.1.47

2 release files

0.1.46

2 release files

0.1.45

2 release files

0.1.44

2 release files

0.1.43

2 release files

0.1.42

2 release files

0.1.41

2 release files

0.1.40

2 release files

0.1.39

2 release files

0.1.38

2 release files

0.1.36

2 release files

0.1.35

2 release files

0.1.23

2 release files

0.1.22

2 release files

0.1.21

2 release files

0.1.20

2 release files

0.1.19

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.11

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page