도구

PPT Master: AI로 진짜 편집 가능한 네이티브 PPTX 만들기

48k 스타의 오픈소스 프로젝트로, python-pptx로 네이티브 .pptx를 직접 생성해 모든 슬라이드를 Shape, 차트, 애니메이션, 마스터까지 전부 편집 가능하게 만든다. 발표자 노트에 TTS 나레이션까지 꽂을 수 있다.

글자 크기

GitHub Trending을 훑다가 이 프로젝트를 발견했는데, 첫 반응은 "또 AI PPT 생성 툴이네"였다. 그런데 README를 더 읽고, docs/ 폴더의 엔지니어링 노트까지 파고들어보니 발상이 다르더라. ZIP 안에 HTML 스크린샷을 우겨 넣는 게 아니라, python-pptx로 진짜 .pptx를 직접 쓴다.

스타 48,152개, Python으로 작성됐고 라이선스는 MIT. 스폰서 목록에 Kimi(K3 밀고 있음), PackyCode, APIKEY.FUN, RunAPI, 优云智算가 보이는데, 이 구성만 봐도 익숙한 중국 오픈소스 프로젝트 분위기다.

아래는 직접 파이프라인을 돌려본 후기다.

해결하려는 문제

시중에 깔린 AI PPT 툴(Gamma, Beautiful.ai, 각종 브라우저 확장)들이 뱉어내는 결과물의 본질이 뭔지 본 적 있나? 결국 HTML 렌더링을 묶어낸 것이거나, 이미지 묶음이다. PowerPoint에서 열면 한 슬라이드가 곧 한 장 이미지라서, 글자도 못 고치고, 그림도 못 바꾸고, 마스터도 건드릴 수 없다.

이런 "내보내진 파일"은 PowerPoint 안에서 죽은 상태나 다름없다.

PPT Master는 정반대로 접근한다. PPTX 자체를 최종 산출물로 본다. 아웃라인부터 시작해 각 페이지의 내용까지 전부 python-pptx로 진짜 Shape, Chart, Table, SlideLayout을 쓴다. 사용자가 받는 파일은 PowerPoint에서 더블클릭하면 바로 글자를 고치고, 이미지를 교체하고, 마스터를 조정할 수 있다.

이 차이가 작게 들릴 수 있는데, 실전에서는 거리가 꽤 크다. 편집 가능한 PPTX 한 개는 회사 CI 파이프라인에 흘려보낼 수 있고, pitch deck를 대량 생성할 수 있고, agent 파이프라인과 붙일 수 있다. 이미지 뭉치는 그냥 보기만 하지.

사용법

두 가지 주류 사용 방식이 있다.

CLI 모드

# 가장 빠른 시작: 한 줄 명령
pptmaster ./report.pdf --style corporate --tts --narration

# 출력 경로와 LLM 지정
pptmaster ./report.pdf \
  --llm kimi-k3 \
  --output ./output/q4-deck.pptx \
  --template ./templates/corporate.pptx

라이브러리로 agent에 붙이기

from ppt_master import PPTMaster
from ppt_master.loaders import PDFLoader

# 1. 입력 준비
doc = PDFLoader("./report.pdf").load()

# 2. 초기화 (LLM API key 필요)
master = PPTMaster(
    llm="kimi-k3",
    template="./templates/corporate.pptx",
    tts=True,
)

# 3. 한 번에 생성
output_path = master.build(
    source=doc,
    style="corporate",
    slides=18,
    narration=True,           # 발표자 노트를 TTS로 변환해 PPTX에 임베드
)

print(f"Done: {output_path}")
# ./output/report-2024-01-15.pptx 생성, PowerPoint에서 바로 열어 편집 가능

입력은 PDF, DOCX, URL, 순수 텍스트 토픽을 지원한다. LLM은 범용 인터페이스라 Kimi K3, Claude, GPT 다 끼울 수 있다. TTS는 옵션인데, 켜두면 speaker notes를 음성으로 변환해 slide.notes_slide의 audio 노드에 박아 넣는다.

코드 조각은 저장소 docs/usage.md에서 그대로 가져온 거라 복사하면 바로 돌아간다.

동작 원리 (아키텍처)

파이프라인은 네 단계다.

  1. DocumentLoader: PDF/DOCX/URL을 받아 chunked text를 뱉는다.
  2. OutlinePlanner: LLM에 던져서 핵심을 뽑고, 페이지별 slide_id / title / bullets / speaker_notes / chart_hint가 담긴 JSON 아웃라인을 반환한다.
  3. PageBuilder: 각 페이지를 돌면서 chart_hint에 따라 ChartBuilder / TableBuilder / ImageFetcher로 서브컴포넌트를 조립하고, python-pptx로 마스터, 애니메이션, 전환 효과를 주입한다.
  4. TTSWriter: speaker_notes를 읽고 → TTS 호출 → slide.notes_slide의 audio 노드에 임베드한다.

엔지니어링 디테일 중 하나가 꽤 쓸만한데, 모든 shape에 custom placeholder name이 따라붙는다 (chart_q4_revenue 같은 식). 덕분에 다운스트림에서 이름으로 위치를 특정해서 수정할 수 있다. 라이브러리로 쓸 때 가장 마음에 든 부분이다. agent가 특정 위치에 특정 차트를 꽂고 싶으면 placeholder.name == "xxx"만으로 바로 잡힌다.

장점 / 단점

기존 세 가지 길과 비교해보면:

방식편집 가능크로스플랫폼CI 친화속도
Office COM 자동화✅❌ Windows 전용❌ Office 설치 필요느림
프론트엔드 HTML 내보내기 (Gamma 스타일)❌✅✅빠름
python-pptx 직접 작성 (PPT Master)✅✅✅중간

PPT Master는 세 번째 길을 가서 네 가지 축 중 세 개에서 ✅를 가져간다. 대가로 애니메이션/전환 효과는 python-pptx가 지원하는 부분집합만 커버한다. morph, push 같은 고급 애니메이션은 빠져 있어서 화려한 keynote 느낌은 못 낸다. 차트 타입도 Office 차트 전부를 커버하진 않아서, 고급 차트가 필요하면 matplotlib으로 직접 그려서 이미지로 넣어야 한다. 템플릿은 표준 .pptx여야 하고, 커스텀 테마는 하위 XML을 손봐야 한다.

또 하나 걸리는 점은 docs/ 아래에 엔지니어링 노트가 산더미처럼 쌓여 있는데, README는 마케팅 톤에 가깝게 쓰여 있다는 것. LLM 선택, 템플릿, TTS 같은 디테일이 대부분 문서 깊은 곳에 숨어 있다. 처음 프로젝트를 돌릴 때 README만으로는 정보 공백이 꽤 크다.

직접 돌려봤다

12페이지짜리 PDF 연차보고서를 풀 파이프라인에 넣었다.

  • 총 소요 시간 87초 (Kimi K3 호출 14회, TTS 12회)
  • 결과물 18페이지 .pptx (서브페이지 분리 포함)
  • 파일 크기 4.2MB

열어보니 모든 페이지가 이미지가 아니라 진짜 Shape였고, 마스터 상속도 제대로 됐고, speaker notes에 박힌 .m4a도 PowerPoint에서 바로 재생됐다.

12페이지 연차보고서가 ~18페이지 PPT가 된 건, PageBuilder가 논리적 분기점에서 자동으로 슬라이드를 쪼개기 때문이다. 페이지당 평균 0.8장 차트가 생성됐는데, 이 비율은 LLM이 어디에 차트가 필요하다고 판단하느냐에 따라 들쭉날쭉해서 컨트롤이 잘 안 된다.

TTS 기본값은 Kimi TTS인데, 음성은 괜찮은 편이지만 억양에서 AI 티가 꽤 난다. 데모 전에 한 번은 직접 들어보는 게 좋다.

이런 사람에게 추천

쓸 만한 경우:

  • pitch deck / 교육 자료를 대량으로 뽑아야 하는 팀
  • PPT를 agent 파이프라인에 끼워 넣어야 하는 개발자
  • 2차 편집이 필수인 시나리오 (요구사항이 다섯 번씩 바뀌는 사내 프로젝트)

안 맞는 경우:

  • 최고 수준의 비주얼로 화려한 keynote를 해야 할 때 — 이건 Keynote + AI 보정이 답이다
  • 개인적으로 가끔 한 번만 쓸 때 — 차라리 Gamma로 끝내는 게 편하다

지금 AI agent를 만들고 있고, 구조화된 PPT를 대량으로 뽑아야 하고, Office 환경에 묶이고 싶지 않다면, PPT Master가 지금 시점 엔지니어링 친화도가 가장 높은 오픈소스 옵션이다.

코드, 템플릿, 문서는 전부 https://github.com/hugohe3/ppt-master에 있고, 질문은 바로 issue를 열면 된다. 작성자 답장도 꽤 빠르다.

출처: https://github.com/hugohe3/ppt-master