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 unifieduvx ppt-master <command>CLI (70+ subcommands), and adapts every command call in the skill workflow docs to theuvxform — once the fork's skill is installed, AI agents invoke theuvxtool automatically, with no clone and nopip 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
End users don't need to run any command: install the skill once, then chat with
your AI agent in natural language — it invokes uvx ppt-master <command> for
you. The commands below are what the agent runs, and are also available for
direct CLI use:
# 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.
1 maintainer
Metadata
1 maintainer
Release files for ppt-master 0.1.137
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ppt_master-0.1.137.tar.gz | 14.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ppt_master-0.1.137-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 34.8 MB
Release files / ppt_master-0.1.137.tar.gz
| Download URL | ppt_master-0.1.137.tar.gz |
|---|---|
| Size | 14.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cebf6ba9177d1dd6d2ed5d95e14a4915d88029b2eeeca7092637f8a3c3027462
|
|
BLAKE2b-256 checksum How to use checksums |
75c593ad5db7fb8e81baf9bf1984ed306a6776fa524752d50d3aaff772b9ff1d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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.137-py3-none-any.whl
| Download URL | ppt_master-0.1.137-py3-none-any.whl |
|---|---|
| Size | 20.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
57d2b74797527887e83b9e57587ce8aa92adc98880a2ed96e4d8b8195dc85bd9
|
|
BLAKE2b-256 checksum How to use checksums |
7ecf3a6813b97a0ead6147a4ab8aaa1888ad7da840298ce7ddde9502acf91447
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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}
|
