AI가 만든 PPT는 왜 손댈 수 없을까요? 사내 템플릿 살리는 길, ppt-master (2026 기준)

AI가 만든 PPT는 왜 고칠 수가 없나요?

일부 AI PPT 도구가 슬라이드를 이미지로 납작하게 저장하기 때문입니다. ppt-master는 클릭해서 고칠 수 있는 PowerPoint 객체로 내보내는 오픈소스예요. "우리 회사 템플릿 그대로 쓸 수 있나요?" 한국 기업이라면 이 질문부터 떠오르죠. 이 글은 직접 돌려 본 후기가 아니라 공식 문서와 코드를 읽고 정리한 결과입니다.

네이티브 PPTX란?: 슬라이드를 그림으로 굳히지 않고 도형과 텍스트, 커넥터 같은 PowerPoint 객체로 저장한 .pptx 파일이에요.

저장소 안내문인 README에 따르면 제작자는 재무 전문가이고 "AI가 만든 슬라이드가 이미지로 납작해지지 않고 PowerPoint에서 계속 편집되길 원해서 만들었다"는 취지로 적었습니다. 다만 차트와 표는 기본값이 도형이라 --native-charts-and-tables 옵션을 줘야 차트와 표 데이터를 직접 고칠 수 있어요.

신작은 아니에요. 저장소 생성일은 2025-12-10이고 2026-10-12 기준 누적 60337 stars, 4759 forks입니다. 호평은 중국어권과 일본어권 X(옛 트위터)에 몰려 있어요. Hacker News 스레드는 0건이고 한국어 후기는 검색으로 한 건도 찾지 못했습니다. Reddit은 확인하지 못했어요.

ppt-master는 파이썬 패키지인가요?

아니요, 에이전트 스킬(AI 에이전트가 불러 쓰는 작업 매뉴얼)이에요. Claude Code, Cursor, Codex 같은 에이전트 안에서 돌아서 사람은 코드를 쓰지 않습니다. 채팅창에 "projects/q3-report/sources/report.pdf로 PPT 만들어줘"처럼 말하면 에이전트가 템플릿, 비율, 페이지 수를 먼저 확인해요.

ppt-master로 만든 예시 덱. 중국어 픽셀아트 표지 슬라이드

이미지 출처: github.com

입력은 PDF, DOCX, 웹 URL, Markdown 같은 문서이고 출력은 PPTX 파일이에요. 에이전트가 페이지마다 SVG(좌표로 그리는 벡터 그림)를 직접 쓰면 svg_to_pptx.py가 DrawingML(PowerPoint의 도형 저장 형식)로 번역합니다. 공식 기술문서에 따르면 페이지를 찍어내는 생성기 스크립트는 금지예요. 덱의 시각적 연속성이 사라지기 때문입니다.

README는 스스로를 "harness + model = agent"라고 규정하고 품질 상한을 모델이 정한다고 적었어요. Claude, GPT, Gemini, Kimi 등 어떤 모델이든 되지만 한 번에 약 1M 토큰(AI가 글을 세는 단위)을 읽는 모델을 권장합니다. 페이지를 하나씩 직접 쓰는 구조라서 공식 한계 목록 기준 10페이지 덱 하나에 10분에서 20분이 걸려요.

애니메이션은 어떻게 넣었나요?

python-pptx에는 애니메이션 API가 없어요. 기능 요청은 2018년부터 열려 있지만 로드맵에는 없고 전환 API도 없습니다. 그래서 PPTX를 만든 뒤 내부를 후처리하고 효과 정보는 animations.json 사이드카(본 파일 옆의 부속 파일)에 담아요.

걸림돌은 도형 ID라는 번호표예요. PowerPoint 타임라인은 ID로 효과를 찾아서 ID가 어긋나면 효과가 조용히 재생되지 않아요. 공식 기술문서에 따르면 애니메이션 기준점을 SVG 최상위 그룹에 고정해 이 문제를 다룹니다. 홍보 문구에 그치지 않고 구현이 확인되는 부분이에요.

한글은 제대로 나오나요?

코드 경로는 갖춰져 있지만 제작자의 실주행 검증에서는 빠져 있어요.

구분	확인한 내용	근거
되는 쪽	ko-KR 태그에 별칭 "한국어" 등록, 한글(Hang) 스크립트를 동아시아 폰트 칸으로 처리	language_tags.py, theme_fonts.py
되는 쪽	한국어 폰트 6종 허용: Malgun Gothic, Gulim, Dotum, Batang, Noto Sans KR, Noto Serif KR	utils.py
되는 쪽	ko 기본값은 고딕 Malgun Gothic, 명조 Batang(Windows 한국어판 기본 포함)	utils.py
조심할 쪽	v6.6.0(2026-09-19) 실주행 테스트 덱 언어 6종에 한국어 없음(중국어·영어·독일어·스페인어·포르투갈어·베트남어)	릴리스 노트
조심할 쪽	Pretendard는 허용목록 0건, Apple SD Gothic Neo도 없음	코드 검색

한국어 폰트 분류는 외부 기여자가 낸 수정 제안(PR #93, 2026-05-08)으로 들어왔어요. 그 설명에 따르면 그전에는 한국어 텍스트에 잘못된 typeface(글꼴 이름)가 할당되는 결함이 있었습니다.

사내 서체가 Pretendard라면 분류에서 빠져 있어 할당이 어긋날 수 있지만 실제 증상은 확인하지 못했습니다. 조사 단위 줄바꿈 같은 한국어 특이 결함은 사용자가 먼저 만날 수 있어요.

사내 템플릿은 살아남나요?

핵심 경로는 기존 덱을 고치는 Edit Native PPTX예요. 바꾸지 않은 페이지는 바이트 단위로 그대로 보존하고 고른 페이지만 편집한 뒤 내보냅니다. 공식 기술문서에 따르면 마스터와 레이아웃(모든 슬라이드의 공통 틀)의 소유권을 추론하거나 수리하거나 이전하지 않아요.

임베드 서체도 고려돼 있습니다. pptx_embedded_fonts.py가 원본의 임베드 폰트를 사이드카로 옮겨 글자가 외곽선 그림으로 굳지 않게 해요. v6.7.0(2026-10-08) 릴리스는 폰트를 지정하지 않은 텍스트가 테마에 정해 둔 영문·동아시아 글꼴 쌍을 물려받게 고쳤어요. 그전에는 편집된 텍스트가 모두 Segoe UI로 나갔고 한글이 거기로 떨어지면 글꼴이 깨집니다.

템플릿 경로는 모두 3개이고 나머지 둘은 브랜드와 레이아웃을 뽑는 템플릿 증류, 실제 마스터를 상속하는 템플릿 미러예요.

도입 전에 뭘 먼저 확인해야 하나요?

확인 항목은 4개이고 1페이지 파일럿이면 충분해요.

사내 템플릿 왕복: 회사 .pptx를 Edit Native PPTX 경로에 넣어 바꾸지 않은 페이지가 보존되는지와 로고·마스터·임베드 서체가 살아남는지 봐요. 여기서 깨지면 적용이 사실상 어려워 가장 먼저 합니다.
폰트 분류: 사내 서체가 허용목록 6종 중 하나면 안전해요. Pretendard처럼 밖에 있으면 1페이지로 실측하세요.
한글 줄바꿈과 넘침: 긴 한글 문장이 든 페이지로 봅니다. svg_output/의 SVG가 이미 넘쳤다면 저작과 레이아웃 문제이고 SVG는 멀쩡한데 PPTX만 다르면 변환과 렌더러 문제예요.
한글 내레이션: --provider edge --voice ko-KR-SunHiNeural처럼 음성을 명시해야 해요. 기본값도 언어 자동 감지도 없어서 생략하면 실행이 거부됩니다. Microsoft 음성 목록을 2026-10-12에 조회하니 322종 중 한국어는 ko-KR-HyunsuMultilingualNeural, ko-KR-InJoonNeural, ko-KR-SunHiNeural 3종이었어요.

비용과 리스크는 어느 정도인가요?

구독료는 없고 AI 사용료만 들어요. 다만 저장소 FAQ는 측정된 토큰 비용을 제공하지 않는다고 밝혔습니다. 정액 에이전트 구독이면 한 건의 한계비용이 0에 가깝고 종량제 API는 출력 토큰이 많이 들어요. 단가는 같은 소스로 3건을 만들어 직접 재야 합니다.

라이선스는 본체가 MIT이고 귀속 표기가 필요합니다. 걸리는 부분은 PDF 변환에 쓰는 PyMuPDF가 AGPL-3.0(소스 공개 의무가 강한 라이선스)이라는 점이에요. 저장소도 번들을 재배포하기 전에 AGPL 조항을 확인하라고 경고합니다. 사내 사용은 부담이 작고 제품에 넣어 외부에 배포한다면 PDF 경로를 빼거나 라이선스를 검토해야 해요.

사내 문서를 소스로 넣으면 그 내용이 선택한 모델 벤더로 전송됩니다. 민감한 문서는 벤더를 사내 정책에 맞추세요.

운영은 README에 따르면 주로 저자 본인이 맡아요. 스폰서에 Kimi와 API 중계 서비스가 여럿 있어서 Kimi K3를 먼저 권하는 모델 추천은 감안해 읽는 편이 좋습니다. 이슈는 총 148건 중 열린 건 4건이라 유지보수는 활발한 편이에요.

대안과 비교하면 언제 이 도구가 맞나요?

대안	강점	ppt-master를 택할 때
python-pptx 직접 작성	결과가 늘 같고 LLM 비용 0	디자인 판단이 필요할 때. 같은 양식에 숫자만 바꾼다면 python-pptx가 더 싸고 빨라요
Marp·Slidev	버전 관리에 좋고 빠름	받는 사람이 PowerPoint로 고쳐야 할 때. 산출물이 웹·PDF 중심이에요
Microsoft 365 Copilot	설치 없음, 사내 데이터 연계	좌석당 구독이 부담일 때. 데이터 거버넌스가 엄격하면 Copilot이 유리해요
Gamma 같은 호스팅 SaaS	몇 초면 결과	생성 후 PowerPoint에서 계속 다듬을 때. 즉시 결과가 필요하면 SaaS가 맞아요

이 도구가 합리적인 조건은 네 가지가 동시에 맞을 때입니다. 최종 산출물이 .pptx여서 받는 사람이 직접 고치고 사내 템플릿과 마스터를 유지해야 해요. 이미 에이전트 정액 구독을 쓰고 있어야 하고 10분에서 20분의 대기와 Python 설치도 감당할 수 있어야 합니다.

마무리

ppt-master는 AI 초안을 PowerPoint 안에서 계속 고치게 해 주는 도구입니다. 한국어 실주행 검증과 건당 비용은 비어 있어서 우리 팀의 답은 직접 돌려 봐야 나와요. 서두르지 않으셔도 됩니다. 사내 템플릿으로 1페이지만 만들어 보세요.

관련 글: Anthropic 플러그인 공식 저장소 실측

자주 묻는 질문

개발자가 아니어도 ppt-master를 쓸 수 있나요?

코드는 쓰지 않지만 준비물은 있습니다. README에 따르면 Python 3.10 이상과 Claude Code 같은 에이전트 실행 환경이 필요해요.

사내 문서를 소스로 넣어도 되나요?

README에 따르면 AI 모델 통신을 뺀 나머지는 내 컴퓨터에서 돌지만 문서 내용은 모델 벤더로 전송됩니다. 민감한 문서는 벤더를 사내 정책에 맞추세요.

한 번 만드는 데 비용이 얼마나 드나요?

구독료 없이 AI 사용료만 들지만 저장소 FAQ가 측정된 토큰 비용을 제공하지 않아 건당 단가는 직접 재 봐야 해요.

만든 덱을 그대로 발표해도 되나요?

한 번에 완성품을 기대하지 마세요. README는 남은 다듬기를 사용자 몫으로 못 박았으니 한글 줄바꿈과 넘침은 발표 전에 페이지마다 눈으로 확인하세요.

AI가 만든 PPT는 왜 손댈 수 없을까요? 사내 템플릿 살리는 길, ppt-master (2026 기준)

클릭해서 고치는 AI PPT, 한국어도 될까요: 비개발자를 위한 쉬운 가이드