Slidecraft

Slidecraft는 사용자가 이미 사용 중인 에이전트 앱 내부에서 원본 자료를 세련되고 편집 가능한 PowerPoint 프레젠테이션으로 변환합니다. 에이전트가 작업을 계획하고 안내하는 동안 Slidecraft는 프로젝트 파일, 시각 리소스, 이미지 생성, 슬라이드 이해, PowerPoint 구성을 정리합니다.

현재 알파 버전은 Codex, Claude Code, GitHub Copilot 및 기타 MCP 호환 에이전트 앱을 통한 로컬 프로젝트에 사용할 수 있습니다. 릴리스 진행 상황은 Release readiness에서 추적됩니다.

설치

Python 3.10 이상과 현재 Node.js LTS 릴리스를 설치한 다음 안내형 설치 프로그램을 실행하세요.

macOS 및 Linux

curl -fsSL https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | python3 -

Windows PowerShell

irm https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | py -3 -

설치 프로그램은 격리된 런타임을 만들고, 일상적인 프레젠테이션 기능을 설치하며, 편집 가능한 PowerPoint 생성기를 준비하고, 설치를 검증하고, 감지된 에이전트 앱을 연결합니다. Slidecraft가 업데이트되면 다시 실행해도 안전합니다.

실행 전 검사 옵션, 선택한 에이전트 설정, GitHub Copilot 작업 영역 설정, 설치 위치 및 문제 해결은 Installation을 참조하세요.

기여자는 동일한 안내형 흐름으로 클론한 체크아웃에서 설치할 수 있습니다.

git clone https://github.com/henryhyw/slidecraft.git
cd slidecraft
python3 install.py --source .

설치 프로그램은 완료 시 정확한 대시보드 명령을 출력합니다. 형식은 다음과 같습니다.

/path/to/Slidecraft/app/bin/slidecraft console

대시보드에는 프로젝트, 스타일 설정, 공유 리소스 컬렉션, 공급자 구성 및 런타임 상태가 표시됩니다. 프로젝트 및 라이브러리 폴더는 운영 체제 파일 브라우저에서 직접 열 수 있습니다.

Related MCP server: PPTX MCP Server

에이전트 통합

Slidecraft는 프로세스 내부, CLI, MCP를 통해 동일한 기능을 제공합니다.

slidecraft agent-capabilities
slidecraft-mcp

에이전트 앱이 대화를 관리합니다. Slidecraft는 프로젝트 결정, 출처, 진행 상황 및 산출물을 기록하므로 새 세션도 동일한 프로젝트에서 계속할 수 있습니다. 대시보드는 이러한 파일과 설정을 한곳에 표시합니다.

번들로 제공되는 Agent 스킬은 integrations/skills/slidecraft/SKILL.md에서 확인할 수 있습니다. 전체 호스트 계약은 Agent integration에 문서화되어 있습니다.

MCP 서버는 자체 설명 방식으로 동작하며 Codex, Claude Code, GitHub Copilot Chat 및 기타 MCP 지원 호스트에서 로컬 STDIO 도구 서버로 작동합니다. 호스트별 설정 예시는 Agent quickstart에서 확인할 수 있습니다.

새 세션에서 프로젝트 이름을 지정하고 원하는 내용을 설명하세요. 에이전트는 저장된 진행 상황을 찾아 작업을 계속하거나 요청된 프레젠테이션 산출물을 반환합니다. Agent quickstart를 참조하세요.

셸 기반 Agent 호스트는 동일한 이름 우선 진입점을 직접 사용할 수 있습니다.

slidecraft project resolve "Market Growth"
slidecraft project show "Market Growth"

프로젝트 및 리소스

프로젝트는 사용자가 선택한 디렉터리 또는 Slidecraft의 관리형 데이터 디렉터리에 저장할 수 있습니다.

project/
  slidecraft.project.json
  sources/           user material and direct-use visual assets
  deliverables/      editable presentations, previews, and reports
  .slidecraft/       durable Agent evidence and resource assignments

시각적 영감, 표준 아이콘 및 재사용 가능한 편집 가능 구성 요소는 공유 로컬 컬렉션에 저장됩니다. 채팅 또는 대시보드에서 선택한 항목은 프로젝트에 계속 연결되어 프로젝트를 다시 열 때 사용할 수 있습니다.

구성은 패키지 기본값, 사용자 구성, 선택적 프로젝트 오버레이, 환경 변수 및 명시적 런타임 인수를 따릅니다. 다음 명령을 사용하여 확인된 모든 값과 해당 출처를 검사하세요.

slidecraft config path
slidecraft config show
slidecraft config validate
slidecraft config explain

Configuration, Guidance profiles 및 문서 맵을 참조하세요.

파이프라인

에이전트는 프레젠테이션 워크플로를 추론하고 다음과 같은 재사용 가능한 기능을 구성합니다.

1. 멀티모달 원본 자료와 하드 제약 조건을 정규화합니다.

2. 덱 스토리라인과 슬라이드별 의미적 의도를 계획합니다.

3. 시각적 영감, 표준 아이콘 및 재사용 가능한 구성 요소를 검색한 다음 컨텍스트에서 유용한 리소스를 선택합니다.

4. 정보 전달 슬라이드를 위한 이미지 생성 브리프를 구성하고 실행합니다.

5. Agent의 시각적 추론을 사용하여 의미 있는 렌더링 엔티티와 관계를 권위 있는 소스 콘텐츠에 매핑합니다.

6. OpenCV로 텍스트, 도형 및 레이아웃을 측정하고, 불규칙한 채워진 영역에 유용한 경계 세부 정보를 추가할 때 SAM 2를 사용합니다.

7. 재구성 경로와 정제 의도를 작성한 다음 편집 가능한 PowerPoint 장면을 컴파일합니다.

8. Agent가 식별한 타이포그래피 그룹, 정렬, 아이콘 슬롯 및 커넥터 토폴로지에 결정적 경계 정규화를 적용합니다.

9. 편집 가능한 덱을 렌더링하고 재구성 보고서를 유지합니다.

시스템 계약은 Framework pipeline에 문서화되어 있습니다. 커넥터 추론은 Connector contract에 문서화되어 있습니다. 정제 제약 조건은 Normalization contract에 문서화되어 있습니다.

저장소 구조

src/slidecraft/       installable Python package and dashboard
js/                   portable PowerPoint constructor
scripts/              installed worker and platform integration scripts
config/               versioned framework and design-policy examples
src/slidecraft/guidance_profiles/ reusable communication profiles
schemas/              interchange contracts
integrations/         Agent integration packages
tests/                automated tests
tools/historical_regression/  architecture-slide regression utilities excluded from the runtime
vendor/               upstream development sources for bundled resources
workspace/            ignored local projects, caches, and generated evidence

최상위 AGENTS.md는 저장소를 인식하는 Agent에게 간결한 진입 계약을 제공합니다. 공유 프레임워크 코드는 workspace/ 아래의 프로젝트나 테스트 픽스처에 의존하지 않습니다.

라이브 프레젠테이션 프로젝트와 생성된 출력물은 저장소 개발 중에 workspace/ 아래에 유지되며 Git에서 제외됩니다. 패키징된 스타터 리소스는 src/slidecraft/starter_resources/ 아래에 있습니다.

모든 새 프로젝트는 숨겨진 .slidecraft/ 디렉터리 아래에 패키징된 덱 디자인 기준선을 받습니다. 표지, 목차, 섹션 구분, 진술, 마무리 및 부록 구분은 공유 결정적 레이아웃을 사용합니다. 정보 전달 슬라이드는 이미지 생성 경로를 사용합니다. 최종 조립은 모든 계획된 슬라이드를 덱 순서대로 요구하며 내보내기 전에 고정된 디자인, 반복 타이포그래피 역할, 커넥터 정책, 표준 자산, 캔버스 및 덱 크롬을 검사합니다.

개발

.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check src tests tools
.venv/bin/python -m build

OpenCV는 일반 텍스트, 커넥터 및 선 아트 측정을 처리합니다. segmentation 엑스트라를 설치하면 불규칙한 채워진 객체에 대한 SAM 2 경계 감지가 추가됩니다.

라이선스

Slidecraft는 MIT License에 따라 배포됩니다. 번들로 포함된 타사 리소스는 자체 고지 사항을 유지합니다.