nateherkai/hyperframes-student-kit

Edit videos, reels, and YouTube Shorts with Codex or Claude Code. 14 skills, transcript-driven cuts, storytelling, 406 motion-graphics cards, and HyperFrames templates.

HyperFrames Student Kit – AI 지원 동영상 편집 실험 환경

무엇인가요 – 대규모 언어 모델 에이전트(Codex 또는 Claude)의 도움을 받아 자신의 영상을 자연어 프롬프트로 편집할 수 있는 재사용 가능한 오픈소스 툴킷입니다. 리포지토리는 edit-video, cut-silences, cut-mistakes, short-form-edit 등 각각의 도구 스크립트와 참고 자료를 포함한 14개의 "스킬"(에이전트 기반 명령어), 모션 그래픽 자산, 장면 템플릿, 그리고 무음 제거, 오류 탐지, 트랜스크립션 기반 재시간 조정, 비트 동기화 검증, 단편형 리얼 제작과 같은 일반적인 후반 작업을 자동화하는 헬퍼 스크립트를 포함합니다.

왜 중요한가요 – LLM이 동영상 편집 보조자로 작동하는 구체적인 워크플로우를 보여주며, 자연어 프롬프트를 FFmpeg/GSAP 명령어로 변환합니다. 이 툴킷은 인프라를 처음부터 구축하지 않고도 AI 기반 편집을 실험하고 싶은 학생과 크리에이터를 위해 설계되었습니다.

핵심 구성 요소

구성 요소	제공 내용
14개의 "스킬"	`edit-video`, `cut-silences`, `cut-mistakes`, `short-form-edit` 등 각각의 작업에 대한 사전 작성된 에이전트 프롬프트와 보조 스크립트, 참고 자료 포함.
406개의 드래프트 모션 그래픽 카드	GSAP 기반 그래픽(2가지 시각 스타일)으로 CSS 토큰과 편집 가능한 슬롯을 제공하며, 메타데이터는 `style-library/registry.json`에 저장됩니다.
장면 템플릿	어두운 그래프 페이퍼 배경과 왼쪽 유리 팝아웃 두 가지 완전한 장면 레이아웃으로, 카드와 조합하여 사용 가능합니다.
트랜스크립션 및 컷 파이프라인	ElevenLabs Scribe, OpenAI Whisper, 또는 로컬 Whisper와의 옵션 통합을 통해 단어 수준의 트랜스크립션을 제공하며, 무음 부분 제거, 오류 표시, 에디트 결정 목록(EDL) 생성을 위한 스크립트 포함.
단편형 워크플로우	긴 녹화물을 9:16 리얼 또는 유튜브 숏으로 전환하는 엔드투엔드 명령어로, 훅/페이오프 기획, 자막 타이밍 검증, B롤 삽입, 사운드 디자인 힌트 포함.
데모 및 교육용 프로젝트	외부 API 키 없이도 작동하는 12개의 예제 학생 프로젝트와 합성된 스타터 구성.

대상 사용자

학생 및 교사 – LLM 에이전트와 미디어 파이프라인을 결합하는 방법을 배우고 싶은 분들.
콘텐츠 크리에이터 – 스크립트 가능하고 AI 가이드된 방식으로 영상을 트리밍하고 다듬고 싶은 분들.
개발자 – AI 에이전트 기반 동영상 도구를 개발하거나 확장하고 싶은 분들 (리포지토리는 즉시 사용 가능한 참조 구현체입니다).

시작하기 (README에서)

사전 요구 사항 – Node 22+, Git, FFmpeg (ffprobe 포함), PATH에 Chrome/Chromium이 설정되어 있어야 함.

클론 및 설치

git clone https://github.com/nateherkai/hyperframes-student-kit.git
cd hyperframes-student-kit
npm ci               # 종속성 설치
npm run setup        # 도구 확인 및 .env 템플릿 생성
npm test             # 사전 검증

데모 실행

npm run demo
cd video-projects/demo
npx hyperframes lint
npx hyperframes preview   # 8초 애니메이션 확인
npx hyperframes render --quality draft --output renders/demo.mp4

자신의 영상 편집 – Codex 또는 Claude Code에서 폴더를 열고 자연어 명령어를 입력합니다. 예시:
```
$edit-video  /path/to/my-recording.mp4
```
어시스턴트는 적절한 스킬(cut-silences, cut-mistakes 등)을 호출하고 드래프트 편집을 생성합니다.
단편형 리얼 제작 – short-form-edit 스킬을 사용하고 다음과 같은 프롬프트를 입력합니다:
```
/short-form-edit  /path/to/lecture.mp4  make a 9:16 Reel with hook, captions and beat-sync
```
워크플로우는 렌더링 전에 자막 타이밍, 장면 커버리지, 영상 재사용 여부를 검증합니다.

선택적 AI 서비스

ElevenLabs Scribe – 클라우드 트랜스크립션 (기본 헬퍼).
Kie.ai – 보조 동영상/이미지 자산 생성.
OpenAI Whisper 또는 로컬 Whisper – 대체 트랜스크립션 백엔드. 사용하는 서비스에만 API 키를 제공하면 되며, 합성 스타터는 완전히 오프라인에서 작동합니다.

제한 사항 및 고려 사항

고품질 트랜스크립션 또는 자산 생성은 외부 API에 의존합니다. 이를 사용하지 않으면 순수하게 로컬 워크플로우로, 해당 단계는 건너뜁니다.
모션 그래픽 카드와 템플릿은 드래프트 자산입니다. 최종 제작 전에 CSS 토큰, 텍스트 슬롯 등을 사용자 정의해야 합니다.
어시스턴트 명령어($edit-video, /short-form-edit 등)는 Codex 및 Claude Code IDE 확장 기능에 연결되어 있습니다. 이 환경 외에서 사용하려면 하위 스크립트를 수동으로 호출해야 합니다.
렌더링 품질은 --quality 플래그로 제어됩니다. 고품질 렌더링은 더 오래 걸리며, 더 많은 시스템 리소스가 필요할 수 있습니다.

빠른 참조 링크 (리포지토리 내부)

에이전트 지침 참조 – AGENTS.md
모션 그래픽 어휘 – MOTION_PHILOSOPHY.md
스타일 라이브러리 가이드 – style-library/GUIDE.md
워크플로우 안내 – docs/WORKFLOW.md
프롬프트 레시피 – docs/PROMPTS.md
단편형 편집 가이드 – docs/SHORT-FORM.md
도구 및 API 키 설정 – docs/TOOLS-AND-API-KEYS.md

결론 – HyperFrames Student Kit는 LLM 에이전트가 동영상 편집 파이프라인을 어떻게 이끄는지 실제로 체험할 수 있는 오픈소스 실험 환경입니다. 자산, 스크립트, 예제 프로젝트를 포함하여 자연어 명령어 몇 번만으로 원시 영상에서 완성된 단편형 콘텐츠까지 제작할 수 있습니다.