TL;DR

PPT Master는 PDF·DOCX·텍스트 같은 소스 자료를 받아 AI 에이전트 워크플로로 처리해 네이티브 편집 가능한 .pptx 파일을 생성하는 Python 기반 오픈소스 툴이다. 에이전트(예: Claude Code, VS Code 내 에이전트)에게 문서 경로를 전달하면 디자인 사양을 확정하고 SVG 자산과 이미지, 차트 데이터를 만들어 DrawingML 요소로 변환해 exports/에 네이티브 PPTX를 저장한다. 워크플로는 문서 분석→디자인 스펙 확정→SVG 생성→SVG→DrawingML 변환→pptx 내보내기 순으로 진행되며, 이미지 획득은 gpt-image-2 같은 이미지 모델 또는 웹 검색(PEXELS/Pixabay 등) 체인을 사용한다. 사용자 제공 .pptx 템플릿으로 '템플릿 채우기'를 수행하거나, 슬라이드별 SVG 스냅샷을 보관하는 옵션을 통해 결과를 재검토·재생성할 수 있다. 출력물은 슬라이드 하나를 이미지로 넣는 방식이 아니라 PowerPoint에서 직접 클릭·편집 가능한 요소로 만들어져 후작업이 가능하다. 단점은 출력 품질이 선택한 AI 모델과 비용에 크게 의존하며 최상 품질을 위해서는 큰 컨텍스트 모델(README 권장: Claude Opus + gpt-image-2 등)과 에이전트 환경 구성이 필요하다는 점이다. 로컬에서 파이프라인이 동작해 데이터가 외부로 업로드되는 것을 최소화하지만, 이미지·모델 API 키는 외부 서비스와 통신한다.

주요 기능

• 문서 입력을 분석해 네이티브 요소(텍스트 박스·도형·차트)로 변환
• 에이전트(IDE 내) 대화 한 번으로 전체 워크플로 실행
• gpt-image-2 등 모델 기반 이미지 생성과 웹 검색을 섞어 이미지 획득
• 사용자 제공 .pptx 템플릿을 유지한 채 내용만 채워넣기
• 슬라이드별 SVG 스냅샷과 네이티브 pptx를 exports/에 저장

어떻게 동작하는가

사용자가 AI IDE나 CLI 에이전트에 '이 파일로 PPT 만들어줘'라고 요청하면, 에이전트가 문서 분석→디자인 스펙 확정→SVG 자산 생성→SVG를 DrawingML(네이티브 도형)로 변환→pptx로 내보내는 일련의 스크립트를 실행한다. 이미지 생성은 지정된 이미지 백엔드(gpt-image-2 등) 또는 웹 검색 체인을 통해 획득하고, 결과 파일은 exports/에 네이티브 .pptx로 저장된다.

해결 문제

PDF·DOCX·텍스트 같은 소스에서 손으로 레이아웃을 재구성하지 않고도 PowerPoint에서 직접 편집 가능한 네이티브 PPTX 파일을 자동 생성한다. 기존 이미지 기반 출력이나 HTML 슬라이드로 인한 편집 불가능 문제를 제거한다.

지금 주목받는 이유

에이전트 기반 워크플로와 대형 컨텍스트 모델(gpt-image-2, Claude Opus 등) 결합으로 'AI가 만들어준 결과를 그대로 편집' 가능한 산출물을 생산하는 접근이 현업에서 관심을 끌고 있어 레포 지지도와 예제 데모로 주목받았다.

차별점

• 출력물이 이미지가 아니라 DrawingML 기반 네이티브 요소여서 PowerPoint에서 직접 편집 가능함 (대부분의 경쟁 툴은 한 슬라이드를 이미지로 삽입)
• 에이전트 스킬 형태로 설계되어 Claude Code·VS Code Copilot·CLI 에이전트 등 다양한 호스트와 연동해 대화형 워크플로를 실행함
• 템플릿 채우기(workflow)로 기존 .pptx 디자인을 유지하면서 내용만 교체하는 흐름을 제공함

사용 사례

• 보고서·데이터저널리즘 PDF를 받아 차트와 텍스트를 편집 가능한 PPT로 빠르게 변환해 재배포할 때
• 디자이너가 기존 회사 템플릿에 맞춰 대량 리포트 페이지를 채워야 할 때 템플릿-필 기능으로 초기 초안을 생성할 때
• 프로토타입/제품 데모에서 AI가 제안한 레이아웃을 받아 수작업으로 세밀하게 다듬어 최종 프레젠테이션을 만들 때

시작하기

Python 3.10+를 설치한 뒤 레포를 클론하고 의존성을 설치한다: git clone https://github.com/hugohe3/ppt-master.git && cd ppt-master; pip install -r requirements.txt. 에이전트 호스트(예: Claude Code, Cursor 등)에 스킬을 추가하거나 로컬에서 스크립트를 실행해 projects/에 소스 파일을 넣고 에이전트에게 경로를 지시하면 exports/에 .pptx가 생성된다.

요구사항

• Python 3.10 이상
• Office 2016 이상(출력된 .pptx의 모든 네이티브 요소·애니메이션 재생을 위해)
• AI 모델 API 키(Claude/GPT/Gemini 등) 및 이미지 백엔드 API 키(선택적, gpt-image-2 권장)
• 에이전트 호스트(권장): Claude Code, Cursor, VS Code + Copilot 등의 에이전트 환경
• Pandoc: legacy 포맷(.doc/.odt/.tex 등) 처리 시 선택적

이미지 분석