hugohe3/ppt-master

PPT Master – AI 생성, 완전히 편집 가능한 PowerPoint 데크

기능

• 소스 문서(PDF, DOCX, 웹 페이지 등)를 입력으로 받아, 대용량 컨텍스트를 가진 LLM을 사용해 핵심 내용을 추출하고 슬라이드 개요를 구성한 후, 네이티브 .pptx 파일을 생성합니다.
• 출력물은 평면 이미지가 아니라 실제 PowerPoint 객체(슬라이드 마스터, 레이아웃, 도형, 연결선, 데이터 기반 차트 및 표)를 포함하므로, PowerPoint에서 열어 편집을 계속할 수 있습니다.
• 세 가지 주요 워크플로우를 지원합니다:
  1. 새로운 데크 생성 – 원시 자료에서.
  2. 브랜드/템플릿 데크 생성 – 참조 파일에서.
  3. 기존 데크에 새로운 콘텐츠 추가 – 디자인을 유지한 채로, 필요 시 전환 효과, 애니메이션, 내레이션도 추가 가능.

작동 방식

1. 에이전트 기능을 가진 AI 도구 – Claude Code, Cursor, VS Code 확장, CLI 도구 등과 같은 채팅/IDE에서 "에이전트"를 실행할 수 있으며, 프롬프트를 읽고 파일을 읽고 쓸 수 있습니다.
2. Python 기반 스킬 – 리포지토리는 에이전트가 호출하는 Python 스킬을 포함합니다. 이 스킬은 소스를 파싱하고, 선택한 LLM(Kimi K3, Claude, GPT, Gemini 등)과 통신하며 PowerPoint XML 구조를 생성합니다.
3. 로컬 실행 – 모든 파일 처리 및 PowerPoint 생성은 귀하의 기기에서 이루어지며, 네트워크를 통해 전송되는 것은 LLM API 호출뿐이므로 소스 데이터는 비공개 상태를 유지합니다.

주요 장점

• 네이티브 깊이 – 슬라이드에는 평면 이미지나 사전 채워진 템플릿이 아니라 실제 PowerPoint 객체(도형, 차트, 표)가 포함되어 있습니다.
• 모델 독립성 – 프롬프트를 읽고 텍스트를 반환할 수 있는 어떤 LLM과도 작동합니다. 저자는 최상의 결과를 위해 Kimi K3(약 1M 토큰 컨텍스트) 또는 Claude를 추천합니다.
• 비용 투명성 – 소프트웨어는 MIT 라이선스로 공개되며, LLM 및 이미지 생성 API 사용료만 지불하면 됩니다.
• 잠김 없음 – Claude, GPT, Gemini 등 프로바이더를 자유롭게 전환할 수 있으며, 워크플로우를 변경할 필요가 없습니다.

시작하기

1. Python 3.10+를 설치하고 pip install -r requirements.txt를 실행합니다.
2. 에이전트(예: Claude Code)를 선택하고 채팅 창을 엽니다.
3. 빠른 시작 단계를 따릅니다: 리포지토리를 클론(또는 ZIP 다운로드), .env에 API 키를 설정하고, "my‑paper.pdf에서 데크를 만들어"와 같은 지시를 에이전트에게 전달합니다.
4. 에이전트가 스킬을 실행하고 output.pptx를 생성하며, PowerPoint에서 최종 조정을 할 수 있습니다.

개발자

• Hugo He – 편집 가능한 AI 생성 데크가 필요했던 금융 전문가로, Python + AI 에이전트의 가능성을 보여주기 위해 이 도구를 만들었습니다.

자세한 정보

• 라이브 데모 갤러리: https://hugohe3.github.io/ppt-master-examples/
• 예제 소스 리포지토리: https://github.com/hugohe3/ppt-master-examples
• 자세한 문서(제품 포지셔닝, FAQ, 로드맵)는 리포지토리의 docs/ 폴더에 있습니다.

---

TL;DR: PPT Master는 어떤 AI 에이전트(Claude, GPT, Kimi 등)가 문서를 완전히 편집 가능한 PowerPoint 파일로 변환할 수 있게 해주는 오픈소스 Python 스킬입니다. 네이티브 도형, 차트, 레이아웃을 유지하면서도 데이터는 로컬에 보관됩니다.