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

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.116
File Size Uploaded
ppt_master-0.1.116.tar.gz 13.5 MB Details

Built distribution (wheel)

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

Total release size: 32.2 MB

Release files / ppt_master-0.1.116.tar.gz

Download URL ppt_master-0.1.116.tar.gz
Size 13.5 MB
Tags Source
SHA-256 checksum
How to use checksums
f586884b4d78044db57c16fe33f6d263d23cf6242e6f24840791b0494e59ca75
BLAKE2b-256 checksum
How to use checksums
6c288cb6843af4e40a32b890ed4f1693cde475de3b0c0d2570f404beb0216539
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.116-py3-none-any.whl

Download URL ppt_master-0.1.116-py3-none-any.whl
Size 18.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
313df166255c8ce7f3ecbbdacded6090e88ae79c3cafb0158c4cf9730d92e22b
BLAKE2b-256 checksum
How to use checksums
3ffc4087beaf996de3bd65fc2053084c48de640e87cf4c304fb021682b5427d1
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.116 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