{"id":47560076,"url":"https://github.com/hugohe3/ppt-master","last_synced_at":"2026-04-13T10:00:35.782Z","repository":{"id":331182600,"uuid":"1113573066","full_name":"hugohe3/ppt-master","owner":"hugohe3","description":"AI generates editable, beautifully designed PPTX from any document — no design skills needed    | 15 examples, 229 pages ","archived":false,"fork":false,"pushed_at":"2026-04-11T09:44:48.000Z","size":172018,"stargazers_count":4449,"open_issues_count":4,"forks_count":510,"subscribers_count":15,"default_branch":"main","last_synced_at":"2026-04-11T10:23:57.957Z","etag":null,"topics":["ai","ai-agent","document-to-slides","pdf-to-ppt","powerpoint","pptx","presentation","s-v-g","slide-generation","slides","svg"],"latest_commit_sha":null,"homepage":"https://hugohe3.github.io/ppt-master/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hugohe3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-10T06:54:33.000Z","updated_at":"2026-04-11T10:23:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hugohe3/ppt-master","commit_stats":null,"previous_names":["hugohe3/ppt-master"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/hugohe3/ppt-master","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugohe3%2Fppt-master","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugohe3%2Fppt-master/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugohe3%2Fppt-master/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugohe3%2Fppt-master/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hugohe3","download_url":"https://codeload.github.com/hugohe3/ppt-master/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugohe3%2Fppt-master/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31747156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","document-to-slides","pdf-to-ppt","powerpoint","pptx","presentation","s-v-g","slide-generation","slides","svg"],"created_at":"2026-03-29T16:00:33.181Z","updated_at":"2026-04-13T10:00:35.770Z","avatar_url":"https://github.com/hugohe3.png","language":"Python","funding_links":[],"categories":["AI Agent Frameworks \u0026 SDKs","Presentation","开源工具","Python","🤖 AI \u0026 Machine Learning"],"sub_categories":["Multi-Agent Collaboration Systems","好用工具"],"readme":"# PPT Master — AI generates natively editable PPTX from any document\n\n[![Version](https://img.shields.io/badge/version-v2.3.0-blue.svg)](https://github.com/hugohe3/ppt-master/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub stars](https://img.shields.io/github/stars/hugohe3/ppt-master.svg)](https://github.com/hugohe3/ppt-master/stargazers)\n[![AtomGit stars](https://atomgit.com/hugohe3/ppt-master/star/badge.svg)](https://atomgit.com/hugohe3/ppt-master)\n\nEnglish | [中文](./README_CN.md)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hugohe3.github.io/ppt-master/\"\u003e\u003cstrong\u003eLive Demo\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"https://www.hehugo.com/\"\u003e\u003cstrong\u003eAbout Hugo He\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"./examples/\"\u003e\u003cstrong\u003eExamples\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"./docs/faq.md\"\u003e\u003cstrong\u003eFAQ\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"mailto:heyug3@gmail.com\"\u003e\u003cstrong\u003eContact\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e **Official channels —** this project is published **only** on [GitHub](https://github.com/hugohe3/ppt-master) (primary) and [AtomGit](https://atomgit.com/hugohe3/ppt-master) (auto-synced mirror). Redistributions on any other platform are unofficial and not maintained by the author. Licensed under MIT — attribution required.\n\n---\n\nDrop 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.\n\n**What makes it different:**\n\n- Every element is a real PowerPoint object (DrawingML) — no \"Convert to Shape\" needed\n- Works with Claude Code, Cursor, VS Code Copilot, and other AI editors\n- 10+ output formats: PPT 16:9, social media cards, marketing posters, and more\n- Low cost — as little as **$0.08 per presentation** with VS Code Copilot; even non-Opus models produce decent results\n\n**[See live examples →](https://hugohe3.github.io/ppt-master/)** · [`examples/`](./examples/) — 15 projects, 229 pages\n\n## Gallery\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshots/preview_magazine_garden.png\" alt=\"Magazine style — Garden building guide\" /\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eMagazine\u003c/b\u003e — warm earthy tones, photo-rich layout\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshots/preview_academic_medical.png\" alt=\"Academic style — Medical image segmentation research\" /\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eAcademic\u003c/b\u003e — structured research format, data-driven\u003c/sub\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshots/preview_dark_art_mv.png\" alt=\"Dark art style — Music video analysis\" /\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eDark Art\u003c/b\u003e — cinematic dark background, gallery aesthetic\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshots/preview_nature_wildlife.png\" alt=\"Nature style — Wildlife wetland documentary\" /\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eNature Documentary\u003c/b\u003e — immersive photography, minimal UI\u003c/sub\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshots/preview_tech_claude_plans.png\" alt=\"Tech style — Claude AI subscription plans\" /\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eTech / SaaS\u003c/b\u003e — clean white cards, pricing table layout\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"docs/assets/screenshots/preview_launch_xiaomi.png\" alt=\"Product launch style — Xiaomi spring release\" /\u003e\u003cbr/\u003e\u003csub\u003e\u003cb\u003eProduct Launch\u003c/b\u003e — high contrast, bold specs highlight\u003c/sub\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Built by Hugo He\n\nI'm a finance professional (CPA · CPV · Consulting Engineer) who got tired of spending hours on presentations that could be automated. So I built this.\n\nPPT Master started from a simple frustration: existing AI slide tools export images, not editable shapes. As someone who reviews and edits hundreds of slides in investment and consulting work, that was unacceptable. I wanted real DrawingML — click on any element and change it, just like you built it by hand.\n\nThis project is my attempt to bridge the gap between **domain expertise** and **product engineering** — turning a complex professional pain point into an open-source tool that anyone can use.\n\n🌐 [Personal website](https://www.hehugo.com/) · 📧 [heyug3@gmail.com](mailto:heyug3@gmail.com) · 🐙 [@hugohe3](https://github.com/hugohe3)\n\n---\n\n## Quick Start\n\n### 1. Prerequisites\n\n**Required:** [Python](https://www.python.org/downloads/) 3.10+ · **Optional:** [Node.js](https://nodejs.org/) 18+ (for WeChat page conversion) · [Pandoc](https://pandoc.org/) (for DOCX/EPUB conversion)\n\n```bash\n# macOS\nbrew install python\nbrew install node                # optional — for WeChat page conversion\nbrew install pandoc              # optional — for DOCX/EPUB conversion\n\n# Ubuntu/Debian\nsudo apt install python3 python3-pip\nsudo apt install nodejs npm      # optional\nsudo apt install pandoc          # optional\n\n# Windows — download from python.org, nodejs.org, pandoc.org\n```\n\n### 2. Pick an AI Editor\n\n| Tool | Rating | Notes |\n|------|:------:|-------|\n| **[Claude Code](https://claude.ai/)** | ⭐⭐⭐ | Best results — native Opus, largest context |\n| [Cursor](https://cursor.sh/) / [VS Code + Copilot](https://code.visualstudio.com/) | ⭐⭐ | Good alternatives |\n| Codebuddy IDE | ⭐⭐ | Best for Chinese models (Kimi 2.5, MiniMax 2.7) |\n\n### 3. Set Up\n\n```bash\ngit clone https://github.com/hugohe3/ppt-master.git\ncd ppt-master\npip install -r requirements.txt\n```\n\nTo update later: `python3 skills/ppt-master/scripts/update_repo.py`\n\n### 4. Create\n\nOpen the AI chat panel and describe what you want:\n\n```\nYou: I have a Q3 quarterly report that needs to be made into a PPT\n\nAI:  Sure. Let's confirm the design spec:\n     [Template] B) No template\n     [Format]   PPT 16:9\n     [Pages]    8-10 pages\n     ...\n```\n\nThe AI handles everything — content analysis, visual design, SVG generation, and PPTX export.\n\n\u003e **Output:** Two timestamped files are saved to `exports/` — a native-shapes `.pptx` (directly editable) and an `_svg.pptx` snapshot for visual reference. Requires Office 2016+.\n\n\u003e **AI lost context?** Ask it to read `skills/ppt-master/SKILL.md`.\n\n\u003e **Something went wrong?** Check the **[FAQ](./docs/faq.md)** — it covers model selection, layout issues, export problems, and more. Continuously updated from real user reports.\n\n### 5. AI Image Generation (Optional)\n\n```bash\ncp .env.example .env    # then edit with your API key\n```\n\n```env\nIMAGE_BACKEND=gemini                        # required — must be set explicitly\nGEMINI_API_KEY=your-api-key\nGEMINI_MODEL=gemini-3.1-flash-image-preview\n```\n\nSupported backends: `gemini` · `openai` · `qwen` · `zhipu` · `volcengine` · `stability` · `bfl` · `ideogram` · `siliconflow` · `fal` · `replicate`\n\nRun `python3 skills/ppt-master/scripts/image_gen.py --list-backends` to see tiers. Environment variables override `.env`. Use provider-specific keys (`GEMINI_API_KEY`, `OPENAI_API_KEY`, etc.) — global `IMAGE_API_KEY` is not supported.\n\n\u003e **Tip:** For best quality, generate images in [Gemini](https://gemini.google.com/) and select **Download full size**. Remove the watermark with `scripts/gemini_watermark_remover.py`.\n\n---\n\n## Documentation\n\n| | Document | Description |\n|---|----------|-------------|\n| 📖 | [SKILL.md](./skills/ppt-master/SKILL.md) | Core workflow and rules |\n| 📐 | [Canvas Formats](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9, Xiaohongshu, WeChat, and 10+ formats |\n| 🛠️ | [Scripts \u0026 Tools](./skills/ppt-master/scripts/README.md) | All scripts and commands |\n| 💼 | [Examples](./examples/README.md) | 15 projects, 229 pages |\n| 🏗️ | [Technical Design](./docs/technical-design.md) | Architecture, design philosophy, why SVG |\n| ❓ | [FAQ](./docs/faq.md) | Model selection, cost, layout troubleshooting, custom templates |\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for how to get involved.\n\n## License\n\n[MIT](LICENSE)\n\n## Acknowledgments\n\n[SVG Repo](https://www.svgrepo.com/) · [Tabler Icons](https://github.com/tabler/tabler-icons) · [Robin Williams](https://en.wikipedia.org/wiki/Robin_Williams_(author)) (CRAP principles) · McKinsey, BCG, Bain\n\n## Contact \u0026 Collaboration\n\nLooking to collaborate, integrate PPT Master into your workflow, or just have questions?\n\n- 💬 **Questions \u0026 sharing** — [GitHub Discussions](https://github.com/hugohe3/ppt-master/discussions)\n- 🐛 **Bug reports \u0026 feature requests** — [GitHub Issues](https://github.com/hugohe3/ppt-master/issues)\n- 📧 **Business \u0026 consulting inquiries** — [heyug3@gmail.com](mailto:heyug3@gmail.com)\n- 🌐 **Learn more about the author** — [www.hehugo.com](https://www.hehugo.com/)\n\n---\n\n## Star History\n\nIf this project helps you, please give it a ⭐!\n\n\u003ca href=\"https://star-history.com/#hugohe3/ppt-master\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=hugohe3/ppt-master\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=hugohe3/ppt-master\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=hugohe3/ppt-master\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n---\n\n## Supported by DigitalOcean\n\n\u003cp\u003eThis project is supported by:\u003c/p\u003e\n\u003cp\u003e\n  \u003ca href=\"https://m.do.co/c/547f129aabe1\"\u003e\n    \u003cimg src=\"https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg\" alt=\"Powered by DigitalOcean\" width=\"201\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Sponsor\n\nIf this project saves you time, consider buying me a coffee!\n\n**Alipay / 支付宝**\n\n\u003cimg src=\"docs/assets/alipay-qr.jpg\" alt=\"Alipay QR Code\" width=\"250\" /\u003e\n\n---\n\nMade with ❤️ by [Hugo He](https://www.hehugo.com/)\n\n[⬆ Back to Top](#ppt-master--ai-generates-natively-editable-pptx-from-any-document)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugohe3%2Fppt-master","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhugohe3%2Fppt-master","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugohe3%2Fppt-master/lists"}