hugohe3 / ppt-master
PPT Master — AI generates natively editable PPTX from any document
PPT Master — AI 可将任何文档生成原生可编辑的 PPTX 文件。
English | 中文
This project is kept free and open source with the support of PackyCode, APIKEY.FUN, RunAPI, YouYun ZhiSuan and other sponsors. 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.
本项目在 PackyCode、APIKEY.FUN、RunAPI、优云智算及其他赞助商的支持下保持免费开源。感谢 PackyCode 对本项目的赞助!PackyCode 是一家可靠且高效的 API 中转服务商,提供 Claude Code、Codex、Gemini 等模型的中转服务。PackyCode 为本项目用户提供特别折扣:使用此链接注册,并在充值时输入优惠码 ppt-master 即可享受 9 折优惠。
Thanks to APIKEY.FUN for sponsoring this project! APIKEY.FUN is a professional enterprise-grade AI relay service committed to stable, efficient, and low-cost AI access for businesses and developers. The platform supports mainstream models including Claude, OpenAI, and Gemini, with prices as low as 7% of official rates. Register through our dedicated link for an exclusive perk: up to 5% off on top-ups, permanently.
感谢 APIKEY.FUN 对本项目的赞助!APIKEY.FUN 是一家专业的企业级 AI 中转服务商,致力于为企业和开发者提供稳定、高效、低成本的 AI 接入服务。该平台支持包括 Claude、OpenAI 和 Gemini 在内的主流模型,价格低至官方费率的 7%。通过我们的专属链接注册可获得独家福利:充值永久享受最高 5% 的折扣。
Thanks to RunAPI for sponsoring this project! RunAPI is an efficient and stable API platform — a single API Key gives you access to 150+ leading models, including OpenAI, Claude, Gemini, DeepSeek, and Grok, at prices as low as 10% of official rates, with exceptional stability and seamless compatibility with tools like Claude Code. RunAPI offers an exclusive perk for PPT Master users: register and contact an administrator via our dedicated link to claim ¥7 in free credit.
感谢 RunAPI 对本项目的赞助!RunAPI 是一个高效稳定的 API 平台,只需一个 API Key 即可访问包括 OpenAI、Claude、Gemini、DeepSeek 和 Grok 在内的 150 多种领先模型,价格低至官方费率的 10%,且具备卓越的稳定性和与 Claude Code 等工具的无缝兼容性。RunAPI 为 PPT Master 用户提供专属福利:通过我们的专属链接注册并联系管理员,即可领取 7 元免费额度。
Thanks to YouYun ZhiSuan for sponsoring this project! YouYun ZhiSuan is UCloud’s AI cloud platform, providing one-stop API services for mainstream domestic and international models, all accessible with a single key. The platform features cost-effective CodingPlan packages for domestic models (including GLM5.2, Deepseek-v4, and more), along with official channels for stable access to overseas models, meeting diverse development needs. It’s compatible with mainstream AI coding tools like Claude Code and Codex, as well as general API calls. The platform supports enterprise-level high concurrency, 24/7 technical support, and self-service invoicing. Register through this link to receive up to ¥10 in free credits and get started right away.
感谢优云智算对本项目的赞助!优云智算是 UCloud 旗下的 AI 云平台,提供主流国内外模型的一站式 API 服务,所有模型均可通过一个 Key 访问。该平台为国内模型(包括 GLM5.2、Deepseek-v4 等)提供高性价比的 CodingPlan 套餐,并提供稳定访问海外模型的官方渠道,满足多样化的开发需求。它兼容 Claude Code 和 Codex 等主流 AI 编程工具以及通用 API 调用。平台支持企业级高并发、7x24 小时技术支持及自助开票。通过此链接注册即可获得最高 10 元免费额度,立即开始使用。
Important
重要提示
This is a tool, not a wishing well. Don’t expect it to hand you a finished, perfect deck in one shot. Its real value is taking most of the tedious work off your plate; the polishing that’s left is yours — a natively editable deck exists precisely so you can keep working on it, not a flat image you can’t touch. The cheaper the model, the more there is to do. How good the result turns out comes down to your skill with this project and with PowerPoint.
这是一个工具,而不是许愿池。不要指望它能一次性给你一份完美无缺的演示文稿。它的真正价值在于帮你分担大部分繁琐的工作;剩下的润色工作需要你自己完成——原生可编辑的演示文稿存在的意义就是让你能够继续修改,而不是一张无法触碰的平面图片。模型越便宜,你需要做的后续工作就越多。最终效果的好坏取决于你对本项目和 PowerPoint 的熟练程度。
Why PPT Master?
为什么选择 PPT Master?
Drop in your source material and get back a real PowerPoint: directly editable, with native slide transitions and entrance animations, speaker notes you can turn into audio narration, and the option to follow your own PPT template — a complete deck you can present as-is and keep editing.
放入你的素材,即可获得一份真正的 PowerPoint 文件:可直接编辑,带有原生幻灯片切换和进入动画,可以将演讲者备注转换为语音旁白,并支持使用你自己的 PPT 模板——这是一份你可以直接演示并持续修改的完整演示文稿。
⚠️ PPT Master is a harness, not a complete agent.
⚠️ PPT Master 是一个“框架”,而非一个完整的智能体。
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.
框架 + 模型 = 智能体——工具负责工作流,模型决定上限。要构建一个真正高质量的智能体,请使用具有大上下文窗口(约 1M tokens)的 Claude + AI 图像生成(gpt-image-2)。其他模型可以运行该流程,但无法达到同样的质量上限。如果结果不尽如人意,请升级模型,不要责怪框架。
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 是一个在 AI IDE(如 Claude Code、Cursor、VS Code + Copilot 或 Codebuddy)中运行的工作流(即“技能”)。你只需与 AI 对话——“用这个 PDF 做一份演示文稿”——它就会按照工作流在你的电脑上生成一份真正的、可编辑的 .pptx 文件。你无需编写代码;IDE 只是对话发生的场所。你需要做的就是:安装 Python,安装一个 AI IDE,然后放入你的素材。
PPT Master is different:
PPT Master 的独特之处:
- 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.
- 真正的 PowerPoint —— 如果一个文件不能在 PowerPoint 中打开和编辑,它就不应该被称为 PPT。PPT Master 输出的每一个元素都是可以直接点击和编辑的。
- 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.
- 透明且可预测的成本 —— 该工具免费开源;唯一的成本是你使用的 AI 模型费用。随着 AI 工具转向按使用量计费,你只需为你消耗的部分付费——无需额外支付 PPT 订阅费用。
- 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.
- 数据本地化 —— 制作演示文稿不应强制将文件上传到他人的服务器。除了与 AI 模型的通信外,整个流程都在你的机器上运行。
- 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.
- 无平台锁定 —— 你的工作流不应被任何单一公司所绑架。它适用于 Claude Code、Cursor、VS Code Copilot 等工具;支持 Claude、GPT 和 Gemini。