이 프로젝트는 PackyCode 와 기타 후원자의 지원으로 무료 및 오픈소스 유지됩니다.

PackyCode 는 이 프로젝트에 후원해 주셔서 감사합니다! PackyCode 는 Claude Code, Codex, Gemini 등 다양한 AI 도구와 연동 서비스를 제공하는 신뢰할 수 있고 효율적인 API relay service 입니다. 프로젝트 사용자에게 특별 할인 혜택을 제공합니다: 해당 링크를 통해 등록하고 충전 시 프로모션 코드 ppt-master 를 입력하면 10% 할인 혜택을 받으세요.

Live Demo ·
About Hugo He ·
Examples ·
FAQ ·
Contact

↑ 하나의 WeChat article URL 을 사용하여 Claude Opus 4.7 에서 생성된 12 페이지의 네이티브 편집 가능한 데크입니다. 수동 디자인 없음, 이미지 내보내기 없음. 모든 모양, 텍스트 박스, 차트는 PowerPoint 에서 클릭 가능하고 편집 가능합니다.

PDF, DOCX, URL, Markdown 을 드롭하면 네이티브 편집 가능한 PowerPoint 를 받아보세요. 실제 모양, 실제 텍스트 박스, 실제 차트를 포함합니다. 이미지가 아닙니다. 클릭하여 수정하세요.

Template Replication— 원하는 .pptx 파일을 AI 에게 전달하고 "replicate it as a template via /create-template" 라고 하면 — PPT Master 가 직접 호출할 레이아웃 세트를 얻습니다. 테마 색상, 폰트, 마스터/레이아웃 구조, 재사용 가능한 이미지, 스프라이트 시트 컷 관계는 OOXML 에서 바로 추출되므로 커버, 장 раздел자, 장식 페이지가 신뢰성 있게 복제됩니다. 내장 템플릿에 제한되지 않습니다: 회사 브랜드 데크, 클라이언트의 승리 템플릿, 또는 어떤 고품질 참조도 개인 라이브러리에 템플릿이 될 수 있습니다. Templates Guide → 를 확인하세요.

Animations— export 된 데크는 OOXML 이 아닌 실제 video 에게 page transitions 와 per-element entrance animations 을 지원합니다. 기본적으로 슬라이드 진입 시 요소들이 자동으로 캐스케이드됩니다. 클릭 없이 실행됩니다. PowerPoint 와 Keynote 에서 네이티브로 재생되며, 추가 툴링 필요 없습니다. Animations & Transitions → 를 확인하세요.

Narration & Video— speaker notes (edge-tts ) 에서 슬라이드별 음성 내레이션을 생성하고 (기본값은 고품질 내레이션을 위한 선택적 클라우드 TTS 제공자), 오디오를 PPTX 에 다시 삽입하고 PowerPoint 가 데크를 MP4 비디오로 내보내게 합니다. 동기화된 내레이션 + 전환, 제 3 자 툴 필요 없음. Audio Narration & Video Export → 를 확인하세요.

Voice Cloning— ElevenLabs / MiniMax / Qwen / CosyVoice 의 클론된 목소리를 가져와서 전체 데크를 당신의 목소리 (또는 허락이 있는 프레젠테이션자의) 로 내레이션합니다. 제공자 콘솔에서 한 번 클론하고, voice_id 를 전달하세요.

PPT Master 는 해당 슬라이드의 노트를 그 목소리로 읽어서 결과를 PPTX 에 다시 삽입합니다. Use a cloned voice → 를 참조하세요.

작동 방식 — PPT Master 는 Claude Code, Cursor, VS Code + Copilot, 또는 Codebuddy 와 같은 AI IDE 내부에서 작동하는 워크플로우 ("skill") 입니다. AI 와 대화하여 "이 PDF 에서 슬라이드 제작해 주세요" 라고 요청하면, 실제 편집 가능한 .pptx 파일을 컴퓨터에 생성합니다. 사용자는 코딩하지 않아도 되며, IDE 는 대화의 장소일 뿐입니다.

사용해야 할 것: Python 설치, AI IDE 설치, 자료 입력.

PPT Master 는 다음과 다릅니다:

실제 PowerPoint— PowerPoint 에서 열거나 편집할 수 없는 파일은 PPT 라고 부르지 않아야 합니다. PPT Master 가 출력하는 모든 요소는 직접 클릭하여 편집 가능합니다.

투명한 예측 가능한 비용— 이 도구는 무료 오픈 소스이며, 유일한 비용은 AI 모델 사용량입니다. AI 도구가 사용량 기반 청구로 전환함에 따라, 사용량은 정확히 지불하며 별도의 PPT 구독이 추가되지 않습니다.

데이터는 로컬에 유지됩니다— 프레젠테이션을 만들기 위해 파일을 다른 사람의 서버에 업로드할 필요가 없습니다. AI 모델 통신 외에는 전체 파이프라인은 사용자 컴퓨터에서 실행됩니다.

플랫폼 잠금 방지— 워크플로우가 단일 회사의 손아귀에 잡히지 않아야 합니다. Claude Code, Cursor, VS Code Copilot 등 다양한 도구와 함께 작동하며, Claude, GPT, Gemini, Kimi 및 기타 모델을 지원합니다.

AI 프레젠테이션 도구는 대략 네 가지 카테고리로 나뉩니다. PPT Master 는 마지막 하나만 수행합니다:

카테고리	출력	PowerPoint 에서 요소별로 편집 가능?
템플릿 채우기	고정된 템플릿에서 PPTX 생성	부분적 — 템플릿에 제한됨
...	원본 편집 가능 (PPT Master)
실제 DrawingML 모양, 텍스트 박스, 차트	✅ 요소 클릭하여 편집 가능

생동하는 예제 보기 → · examples/

— 22 프로젝트, 309 페이지 · 왜 PPT Master?

저는 재무 전문가 (CPA · CPV · 컨설팅 엔지니어 (투자)) 로, 프레젠테이션 슬라이드를 정기적으로 검토하고 편집합니다. AI 생성 슬라이드가 PowerPoint 에서 편집 가능하게 유지되도록, 이미지로 평탄화되지 않도록 하고 싶어서 이 도구를 만들었습니다.

🌐 개인 웹사이트 · 📧 heyug3@gmail.com · 🐙 @hugohe3

Python 만 필요합니다. 나머지는 pip install -r requirements.txt 를 통해 설치됩니다.

의존성	필요?	역할
Python 3.10+	✅ 네	핵심 런타임 — 실제로 설치해야 할 유일한 것

TL;DR— Python 설치하고 pip install -r requirements.txt 실행하면 프레젠테이션 생성 준비가 완료됩니다.

Windows — 전용 단계별 가이드 ⚠️ 확인하세요

Windows 는 몇 가지 추가 단계를 필요로 합니다 (PATH 설정, 실행 정책 등). 우리는 Windows 사용자를 위한 단계별 가이드를 작성했습니다:

📖 Windows 설치 가이드 — 0 에서 10 분 안에 작동하는 프레젠테이션까지.

빠른 버전: python.org 에서 Python 다운로드 → 설치 중 "PATH 에 추가" 확인 → pip install -r requirements.txt

→ 완료.

macOS / Linux — 설치하고 시작하세요

# macOS
brew install python
pip install -r requirements.txt
...

Edge-case fallbacks — 99% 의 사용자는 이들을 필요로 하지 않습니다

두 가지 외부 도구가 Edge case 에 대한 Fallback 으로 존재합니다. 대부분의 사용자는 결코 이를 필요로 하지 않을 것입니다 — 아래 특정 시나리오 중 하나를 겪을 경우에만 설치하세요.

Fallback	설치 조건
Node.js 18+	WeChat Official Account article 를 import 해야 하고 curl_cffi (part of requirements.txt) 가 당신의 Python + OS + CPU 조합에 대한 prebuilt wheel 을 제공하지 않는 경우. 정상적인 설정에서는 web_to_md.py 가 curl_cffi 를 통해 WeChat 을 직접 처리합니다.
Pandoc	Legacy format 을 변환해야 하는 경우: .doc, .odt, .rtf, .tex, .rst, .org, 또는 .typ. .docx, .html, .epub, .ipynb 는 Python 으로 내장 처리되므로 pandoc 이 필요하지 않습니다.

# macOS (위 조건이 적용될 경우에만)
brew install node
brew install pandoc
...

PPT Master 는 Agent capability 를 가진 어떤 도구에서도 실행됩니다. 파일 읽기/쓰기, 명령어 실행, 멀티 턴 대화 유지.

Type	예시	주석
IDE-native agent
• VS Code architecture (VS Code 자체, 포크 및 파생물): Cursor, Trae, Codebuddy IDE, Windsurf, Void 등 • 기타 아키텍처: Zed 등
Editor with a built-in agent
IDE plugin / extension
GitHub Copilot, Claude Code (VS Code / JetBrains 확장), Cline, Continue, Roo Code 등
VS Code 또는 JetBrains 같은 호스트 내부에 설치
CLI agent
Claude Code CLI, Codex CLI, Aider, Gemini CLI 등
터미널에서 실행; 스크립팅, 원격, 서버 사용에 적합

모델 추천: Claude Opus / Sonnet 이 가장 잘 작동하고 테스트가 가장 많이 이루어졌습니다. 기타 주요 모델 (GPT, Gemini, Kimi, MiniMax 등) 도 작동하지만 SVG 절대 좌표 레이아웃 정밀도는 다릅니다.

Option A — ZIP 다운로드 (Git 필요 없음): GitHub 페이지에서 Code → Download ZIP 클릭한 후 압축 해제.

Option B — Git clone (Git 설치 필요):

git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master

그런 다음 의존성 설치:

pip install -r requirements.txt

업데이트 후 (Option A / B): python3 skills/ppt-master/scripts/update_repo.py

Option C — Skill marketplace: repo 는 .claude-plugin/marketplace.json 을 포함하므로, Claude Code plugin marketplace ecosystem 을 통해 설치할 수 있습니다.

Cross-agent CLI (Claude Code, Cursor, Codex 등)

npx skills add hugohe3/ppt-master

또는 Claude Code /plugin marketplace 에 추가 후:

add hugohe3/ppt-master /plugin install ppt-master@ppt-master

위 두 설치 경로 모두 skill files 만 가져옵니다 (전체 repo 는 아님); post-processing scripts 를 실행하려면 여전히 설치 위치에서

pip install -r requirements.txt

를 실행해야 합니다.

Source materials 제공 (권장): PDF, DOCX, 이미지 또는 기타 파일을 projects/ 디렉토리에 배치한 후, AI chat panel 에 사용해야 할 파일을 지정하세요. 경로를 가장 빠르게 얻는 방법: 파일 관리자 또는 IDE 사이드바에서 파일을 마우스 오른쪽 버튼 클릭 → Copy Path (또는 Copy Relative Path) 를 선택하여 채팅에 직접 붙여넣기.

You: Please create a PPT from projects/q3-report/sources/report.pdf

직접 내용 붙여넣기: 채팅 창에 텍스트 내용을 직접 붙여넣으면 AI 가 이를 기반으로 PPT 를 생성합니다.

You: Please turn the following into a PPT: [paste your content here...]

어떤 방식으로든, AI 는 먼저 디자인 스펙을 확인합니다:

AI: Sure. Let's confirm the design spec:
[Template] B) Free design
[Format] PPT 16:9
...

AI 는 모든 작업을 처리합니다 — 내용 분석, 시각적 디자인, SVG 생성, PPTX 내보내기.

Output: Main native-shapes.pptx(직접 편집 가능) 을 exports/<name>_<timestamp>.pptx 에 저장합니다.
SVG 스냅샷 _svg.pptx 와 svg_output/ 의 복사본을 시각적 참조 및 PPTX 재빌드 (LLM 재실행 없이) 를 위해 backup/<timestamp>/ 에 보관합니다. Office 2016+ 가 필요합니다.

AI 컨텍스트를 잃었나요? skills/ppt-master/SKILL.md 를 읽도록 요청하세요.

문제가 발생했나요? FAQ 를 확인하세요 — 모델 선택, 레이아웃 문제, 내보내기 문제 등 다양한 내용을 다룹니다. 실제 사용자 리포트를 기반으로 지속적으로 업데이트됩니다.

사용자 이미지 (API 기반 기능) 에 대한 두 가지 경로: 동일한 데크에서 행별로 섞어 사용할 수 있습니다.

API 기반 기능을 위한 경우, 자격 증명을 .env 에 배치하세요. 클론 설치 시에는 cp .env.example .env 를 사용; skill marketplace 설치 시에는 영구 사용자 설정을 사용해야 합니다:

mkdir -p ~/.ppt-master
cp /path/to/installed/ppt-master/.env.example ~/.ppt-master/.env

PPT Master 는 현재 프로세스 환경 변수를 먼저 읽은 후, 첫 번째 .env 를 읽습니다.

순서대로 찾습니다: 현재 작업 디렉터리, 클론된 리포 저장소 루트, ~/.ppt-master/.env

A) AI 생성 — image_gen.py

IMAGE_BACKEND 설정

제공자의 *_API_KEY(예: OPENAI_API_KEY, GEMINI_API_KEY 등)을 함께 설정하고, 파이프라인이 이를 자동으로 호출합니다. 전체 백엔드 목록은 python3 skills/ppt-master/scripts/image_gen.py --list-backends를 실행하여 확인하세요. 현재 가장 좋은 기본값은 gpt-image-2입니다.

B) 웹 이미지 검색 — image_search.py

제로 설정으로 작동하지만, 더 높은 품질의 결과를 위해 PEXELS_API_KEY/PIXABAY_API_KEY(둘 다 무료)를 설정하세요. 키가 없으면 검색은 Openverse / Wikimedia Commons 만 사용하며, 이는 대안으로 유용하지만 많은 결과가 일반 사용자 업로드이므로 이미지 품질이 균일하지 않을 수 있습니다. 키가 있으면 기본 제공자 체인은 Pexels / Pixabay 를 추가하여 현대적인 스톡 사진, 인물, 업무 환경, 라이프스타일, 일러스트레이션 커버를 크게 개선합니다. 기본값은 품질 우선입니다: CC0, 공공 도메인, Pexels / Pixabay(무 저작권 표시), CC BY, CC BY-SA 는 함께 고려되며, Executor 가 선택된 이미지가 저작권 표시가 필요할 때마다 작은 내장 크레딧을 추가합니다. 슬라이드가 어떤 크레딧 라인을 허용하지 않을 때만 --strict-no-attribution 을 사용하세요. 고 영향력 커버, 제품 샷, 포trait, 브랜딩 시나리오를 선호하는 순서는: 사용자 제공 고품질 자산 / AI 생성 > Pexels / Pixabay 키가 있는 웹 검색 > 제로 설정 웹 검색입니다.

전체 참조:

image-generator.md(AI) · image-searcher.md(웹)

문서	설명
🆚	Why PPT Master
...
참가 방법을 CONTRIBUTING.md 에 확인하세요.

SVG Repo · Tabler Icons · Simple Icons · Phosphor Icons · Robin Williams (CRAP 원칙)

협업, PPT Master 워크플로우 통합, 또는 질문이 있으신가요?

• 💬 질문 및 공유 — GitHub Discussions - 🐛 버그 리포트 및 기능 요청 — GitHub Issues - 🌐 저자에 대해 더 알아보기 — www.hehugo.com

PPT Master 는 현재 저에 의해 주로 구축되고 유지됩니다. 새로운 템플릿, 버그 수정, 문서 업데이트는 지속적인 자원을 필요로 하며, 현재는 아래 스폰서와 개별 지원자들이 공유하고 있습니다.

기업 스폰서

개별 지원

PPT Master 가 도움이 되었다면, 프로젝트가 계속되고 무료로 유지되도록 돕기 위해 어느 금액의 개인 지원도 환영합니다.