개요
将 PDF、DOCX、URL、Markdown 等转换为原生可编辑的 PPTX，包含真实形状、图表、动画及配音。本地运行，数据不上传，支持多种 AI 模型与 IDE 集成。
README 미리보기
# PPT Master — AI generates natively editable PPTX from any document\n\n[](https://github.com/hugohe3/ppt-master/releases)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/hugohe3/ppt-master/stargazers)\n[](https://atomgit.com/hugohe3/ppt-master)\n\nEnglish | [中文](./README_CN.md)\n\n\n This project is kept free and open source with the support of PackyCode and other sponsors.\n\n\n\n \n \n 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.\n \n\n\n\n Live Demo ·\n About Hugo He ·\n Examples ·\n FAQ ·\n Contact\n\n\n\n \n\n\n\n ↑ A 12-page natively editable deck, generated end-to-end from a single WeChat article URL using Claude Opus 4.7. No manual design. No image export. Every shape, text box, and chart is clickable and editable in PowerPoint.\n\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> **Template Replication** — hand the AI any `.pptx` you 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 →](./docs/templates-guide.md).\n\n> **Animations** — exported decks support **page transitions** and **per-element entrance animations** as real
FAQ (4)
문제 해결ppt-master에서 Python 가상 환경을 사용할 때 업데이트 스크립트가 'Tracked local changes detected' 오류로 실패하는 이유는 무엇인가요?
수동으로 가상 환경을 생성하면 CLAUDE.md 파일이 수정되어 커밋되지 않은 변경 사항이 발생하고, 이로 인해 업데이트 스크립트가 차단됩니다. 이를 해결하려면 uv를 사용한 권장 설정을 따르세요: cd ./ppt-master를 실행한 후, uv venv .venv, source .venv/bin/activate, uv pip install -r requirements.txt를 차례로 실행하세요. 프로젝트의 CLAUDE.md에는 이미 LLM이 .venv/bin/python을 사용하도록 지시되어 있으므로 수동 편집이 필요하지 않습니다. 이 작업을 완료하면 업데이트 스크립트가 충돌 없이 작동할 것입니다.
문제 해결PowerPoint를 SVG로 변환할 때 텍스트 그라데이션 채우기가 사라지는 이유는 무엇인가요?
SVG 변환 파이프라인은 이전에 텍스트 그라디언트 정의를 누락했습니다. 수정사항: txbody_to_svg.py를 수정하여 텍스트 실행에서 <linearGradient> / <radialGradient>를 수집하고(_build_run()을 통해) 이를 TextResult.defs에 반환합니다. 그런 다음 slide_to_svg.py를 업데이트하여 슬라이드별로 누산기를 재설정하고 텍스트 그라디언트 정의를 SVG <defs> 섹션에 병합합니다. 수정 후 텍스트 요소는 url(#gradient-id)와 같은 채움을 올바르게 참조합니다. 이 변경 사항이 포함된 최신 커밋을 확인하십시오.
문제 해결npx skills를 통해 설치된 ppt-master를 사용할 때 projects 디렉토리가 잘못된 위치에 생성되는 문제를 해결하는 방법
project_manager.py init을 사용할 때, --dir flag로 출력 디렉토리를 명시적으로 설정하세요. 예시: python .agents/skills/ppt-master/scripts/project_manager.py init myproject --dir $(git rev-parse --show-toplevel)/projects. 이렇게 하면 프로젝트가 .agents/skills/ppt-master/ 내부가 아닌 저장소 루트에 생성됩니다.
문제 해결현재 20분 이상 소요되는 AI 기반 PPT 생성을 어떻게 가속화할 수 있나요?
속도, 품질, 비용 사이에는 트레이드오프가 존재합니다. 생성 시간을 단축하려면 낮은 품질(예: 단순한 페이지)을 수용하거나 투자를 늘려야 합니다(더 빠르고 비싼 AI 모델인 Claude나 GPT-4를 사용하거나 전용 리소스를 배포). 품질을 낮추면 기본적인 덱을 빠르게 만들 수 있지만, 모델을 업그레이드하면 품질은 유지되나 API 비용이 증가합니다. 추가 비용 없이 고품질을 2~3분 내에 생성할 수 있는 해결책은 없습니다.