ppt-master Agent工作流
AI Skill Hub 强烈推荐：ppt-master Agent工作流 是一款优质的Agent工作流。在 GitHub 上收获超过 15.4k 颗 Star，AI 综合评分 8.5 分，在同类工具中表现稳健。如果你正在寻找可靠的Agent工作流解决方案，这是一个值得深入了解的选择。
📚 深度解析
ppt-master Agent工作流 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 8.5 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
ppt-master Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
ppt-master Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：pip 安装（推荐）
pip install ppt-master
# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install ppt-master
# 方式三：从源码安装（获取最新功能）
git clone https://github.com/hugohe3/ppt-master
cd ppt-master
pip install -e .
# 验证安装
python -c "import ppt_master; print('安装成功')"
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
ppt-master --help
# 基本用法
ppt-master input_file -o output_file
# Python 代码中调用
import ppt_master
# 示例
result = ppt_master.process("input")
print(result)
# ppt-master 配置文件示例（config.yml） app: name: "ppt-master" debug: false log_level: "INFO" # 运行时指定配置文件 ppt-master --config config.yml # 或通过环境变量配置 export PPT_MASTER_API_KEY="your-key" export PPT_MASTER_OUTPUT_DIR="./output"
PPT Master — AI generates natively editable PPTX from any document
English | 中文
<p align="center"> <sub>This project is kept free and open source with the support of <a href="https://www.packyapi.com/register?aff=ppt-master">PackyCode</a> and other sponsors.</sub> </p>
 |
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. |
<p align="center"> <a href="https://hugohe3.github.io/ppt-master/"><strong>Live Demo</strong></a> · <a href="https://www.hehugo.com/"><strong>About Hugo He</strong></a> · <a href="./examples/"><strong>Examples</strong></a> · <a href="./docs/faq.md"><strong>FAQ</strong></a> · <a href="./docs/roadmap.md"><strong>Roadmap</strong></a> · <a href="mailto:heyug3@gmail.com"><strong>Contact</strong></a> </p>
The six decks below are only the tip of what PPT Master can do
Download the raw .pptx files and open them in PowerPoint — that's the fastest way to see where this project's capability ceiling actually is.
 Editorial Magazine — architecture photography, calm typographic grid Flip online · Download .pptx |
 Data Journalism — Bloomberg-style dark dashboard, chart-driven Flip online · Download .pptx |
 Swiss Grid — strict modular grid, restrained type, red-accent Flip online · Download .pptx |
 Glassmorphism SaaS — translucent layers, gradient depth, product UI Flip online · Download .pptx |
 Memphis Pop — bold primaries, geometric patterns, playful energy Flip online · Download .pptx |
 Risograph Zine — duotone print, hand-made bookstore-culture feel Flip online · Download .pptx |
<p align="center"> <sub>Generated with Claude Opus 4.7 + <code>gpt-image-2</code>. <a href="https://hugohe3.github.io/ppt-master/">Flip through all examples online →</a> · <a href="./examples/"><code>examples/</code> directory</a> · <a href="./docs/why-ppt-master.md">Why PPT Master?</a></sub> </p>
---
Drop in a PDF, DOCX, URL, or Markdown — get back a natively editable PowerPoint with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.
⚠️ 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.
Live Preview & Visual Edits — during generation, a browser preview at http://localhost:5050 opens automatically. Click any element, write what to change, hit Submit annotations, then return to the chat and say "apply my annotations" — the AI rewrites the SVG and re-exports the PPTX. Originally PPT Master was chat-only by design, but enough users asked for visual editing that we folded it in. Built on top of @WodenJay's PR #85 — thank you. See Live Preview Workflow →.
Template Replication — hand the AI any.pptxyou like and say "replicate it as a template via/create-template" — you get a layout set PPT Master can invoke directly. Theme colors, fonts, master/layout structure, reusable images, even sprite-sheet crop relationships are extracted straight from OOXML, so covers, chapter dividers and decoration-heavy pages all reproduce reliably. You're no longer limited to the built-in templates: a company brand deck, a client's winning template, or any high-quality reference can become a private template in your own library. See Templates Guide →.
Animations — exported decks support page transitions and per-element entrance animations as real OOXML, not embedded video. By default, elements cascade in automatically on slide entry — no clicking needed. Plays natively in PowerPoint and Keynote, no extra tooling. See Animations & Transitions →.
Narration & Video — generate per-slide voice narration from the speaker notes (edge-ttsby default, optional cloud TTS providers for high-quality narration), embed the audio back into the PPTX, and let PowerPoint export the deck as an MP4 video — synced narration + transitions, no third-party tools. See Audio Narration & Video Export →. Voice Cloning — bring your own cloned voice from ElevenLabs / MiniMax / Qwen / CosyVoice and have the entire deck narrated in your voice (or a presenter's, with permission). Clone once in the provider's console, then pass thevoice_id— PPT Master reads every slide's notes in that voice and embeds the result back into the PPTX. See Use a cloned voice →.
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.
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 |
---
1. Prerequisites
You only need Python. Everything else is installed via pip install -r requirements.txt.
| Dependency | Required? | What it does |
|---|---|---|
| [Python](https://www.python.org/downloads/) 3.10+ | ✅ **Yes** | Core runtime — the only thing you actually need to install |
TL;DR — Install Python, run pip install -r requirements.txt, and you're ready to generate presentations.
<details open> <summary><strong>Windows</strong> — see the dedicated step-by-step guide ⚠️</summary>
Windows requires a few extra steps (PATH setup, execution policy, etc.). We wrote a step-by-step guide specifically for Windows users:
📖 Windows Installation Guide — from zero to a working presentation in 10 minutes.
Quick version: download Python from python.org → check "Add to PATH" during install → pip install -r requirements.txt → done. </details>
<details> <summary><strong>macOS / Linux</strong> — install and go</summary>
```bash
Quick Start
5. Image Acquisition (Optional)
Two paths for non-user images, mixable per row in the same deck:
For API-backed features, put credentials in .env. Clone installs can use cp .env.example .env; skill marketplace installs should use a persistent user config:
mkdir -p ~/.ppt-master
cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.envPPT Master reads the current process environment first, then the first .env found in this order: current working directory, clone repo root, ~/.ppt-master/.env.
A) AI generation — image_gen.py. Set IMAGE_BACKEND plus the provider's *_API_KEY (OPENAI_API_KEY, GEMINI_API_KEY, etc.), and the pipeline calls it automatically. Run python3 skills/ppt-master/scripts/image_gen.py --list-backends for the full backend list. gpt-image-2 is currently the best default.
B) Web image search — image_search.py. Zero-config works, but configure PEXELS_API_KEY / PIXABAY_API_KEY (both free) for higher-quality results. Without keys, search uses Openverse / Wikimedia Commons only; this is useful as a fallback, but image quality can be uneven because many results are ordinary user uploads. With keys, the default provider chain also appends Pexels / Pixabay, which materially improves modern stock photography, people, workplace, lifestyle, and illustration coverage. The default is quality-first: CC0, Public Domain, Pexels / Pixabay no-attribution licenses, CC BY, and CC BY-SA are considered together, and Executor adds a small inline credit whenever the selected image requires attribution. Use --strict-no-attribution only when a slide cannot tolerate any credit line. For high-impact covers, product shots, portraits, and branded scenes, prefer this order: user-provided high-resolution assets / AI generation > web search with Pexels / Pixabay keys > zero-config web search.
Full reference:image-generator.md(AI) ·image-searcher.md(web).
---
高星开源项目，功能实用且创新，填补了AI文档转PPT的空白，维护活跃，生态完善。
- 需要 ppt-master 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- Python 依赖冲突：建议用 venv / uv 隔离环境
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 需要 ppt-master 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- Python 依赖冲突：建议用 venv / uv 隔离环境
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +GitHub 15.4k Star，社区高度认可
- +MIT 协议，可免费商用
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
总体来看，ppt-master Agent工作流 是一款质量优秀的Agent工作流，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。
| 原始名称 | ppt-master |
| 原始描述 | 开源AI工作流：AI generates natively editable PPTX from any document — real PowerPoint shapes w。⭐15.4k · Python |
| Topics | AI生成PPT自动化文档转换PowerPoint工作流 |
| GitHub | https://github.com/hugohe3/ppt-master |
| License | MIT |
| 语言 | Python |
收录时间：2026-05-13 · 更新时间：2026-05-16 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。