hugohe3/ppt-master

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

PPT Master – AI 生成的原生 PowerPoint 演示文稿

功能说明

PPT Master 是一个基于 Python 的工具,可让大型语言模型(LLM)读取源文档(PDF、DOCX、网页等)并输出真正的 .pptx 文件。生成的演示文稿不是平面图像,而是包含 PowerPoint 的原生对象:

  • 幻灯片母版和版式
  • 可编辑的形状、连接符和文本框
  • 数据驱动的图表和表格
  • 原生图片、填充和效果
  • 可选的转场、动画和旁白

由于输出使用 PowerPoint 自身的对象模型,您可以在 PowerPoint 中打开文件并继续编辑,就像自己构建幻灯片一样。

工作原理(高层级)

  1. 具备代理能力的 AI 工具 – 您在任何可作为代理(读写文件、执行命令)的聊天/IDE 中运行工作流。README 推荐 Claude Code、Kimi K3 或任何类似模型。
  2. 提示与模型 – 您告诉代理“从这个 PDF 制作演示文稿”。模型解析源文档、提取要点、决定幻灯片结构,并可能请求生成图像(例如 gpt‑image‑2 或 Gemini‑nano‑banana‑2.1)。
  3. Python 管道 – 模型的指令由 PPT Master Python 脚本执行,这些脚本会:
    • 将源文档转换为纯文本(使用内置解析器或可选的 Pandoc 处理旧格式)
    • 使用 python‑pptx 库创建 PowerPoint 文件,填充原生形状、图表、表格等
    • 将最终的 .pptx 写入磁盘
  4. 本地执行 – 所有处理都在您的机器上进行;只有 LLM 调用会发送到所选的 API 提供商。不需要 PowerPoint 订阅。

主要功能

功能 您获得的好处
原生 PowerPoint 对象 幻灯片包含真实的形状、图表、表格和幻灯片母版继承 – 可在 PowerPoint 中完全编辑。
多种输入格式 PDF、DOCX、HTML、EPUB、IPYNB,以及通过可选的 Pandoc 支持旧格式,如 .doc、.odt、.tex。
模板提取与重用 从现有幻灯片衍生品牌/模板演示文稿,并用于新内容。
保留样式的填充 更新现有 .pptx 时,工具会保留原始设计,同时替换新文本/图片。
可选的转场/动画/旁白 作为后处理步骤,添加原生 PowerPoint 转场、简单动画和音频旁白。
代理无关 只要模型能读写文件,即可与 Claude、Kimi、GPT、Gemini 等搭配使用。
透明成本 唯一的费用是 LLM API 使用量;软件本身是 MIT 许可且免费。
本地数据 您的源文档不会离开您的计算机(除了 LLM 调用)。

快速开始(摘要)

  1. 安装 Python 3.10+。
  2. 克隆仓库(或下载 ZIP)并运行 pip install -r requirements.txt。
  3. 选择代理 – 例如 Claude Code、Kimi K3,或任何支持文件读写代理的 CLI/IDE。
  4. 运行技能 – 在代理的聊天窗口中输入类似 make a deck from <path‑to‑file.pdf> 的命令;代理会调用 PPT Master 管道并生成 output.pptx。
  5. 在 PowerPoint 中打开结果文件并按需编辑。

README 还提供:

  • Windows 专用安装指南,
  • 技能市场清单,用于在 Claude Code 中一键安装,
  • 实时演示网站,包含数个示例演示文稿,以及
  • 路线图/常见问题,概述未来的原生 PowerPoint 功能。

适用对象

  • 需要从报告、研究论文或品牌资产快速创建可编辑演示文稿的专业人士。
  • 熟悉 Python 环境和 AI 代理聊天工具的开发者或高级用户。
  • 希望保持数据本地化并避免供应商锁定的 PowerPoint 生成服务的任何人。

以上所有细节均直接取自仓库的 README;未推断任何额外功能。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目