HyperFrames: HTML로 쓰면 영상이 되는 에이전트용 프레임워크
웹앱 화면 녹화를 Claude Code에 맡겼더니 클릭마다 효과음까지 맞춘 홍보 영상이 나왔다는 후기가 올라왔어요
- 누가
- HeyGen이 만들고 자기 서비스에서도 쓰는 오픈소스예요. 코딩 에이전트에게 영상을 맡기고 싶은 사람을 위한 도구예요.
- 언제
- 2026년 3월에 공개됐어요. 최신은 v0.8.217(2026-10-29)이고, 최근 이틀 사이에만 릴리스가 세 번 나왔어요.
- 어디서
- Claude Code, Codex, Cursor, Gemini CLI처럼 스킬을 읽는 에이전트에서 써요. 렌더는 내 PC에서 돌고, Docker와 AWS Lambda도 돼요.
이게 불편했어요
짧은 출시 영상 하나를 만들려 해도 편집 프로그램을 열고, 클립을 자르고, 제목이 뜨는 순간을 손으로 맞춰야 했어요. 코딩 에이전트에게 맡기고 싶어도 에이전트가 잘 쓰는 건 웹페이지였지 영상 파일이 아니었어요.
그래서 이렇게 풀어요
영상을 HTML 한 장으로 적어요. 요소마다 언제 나와서 얼마나 머무는지를 data 속성으로 정하고, 애니메이션은 멈춰 둔 타임라인에 올려요. 렌더할 때는 브라우저가 그 타임라인을 한 프레임씩 옮겨 찍어서, README 기준으로 같은 HTML이면 언제 돌려도 같은 영상이 나와요. 에이전트에게는 /hyperframes 스킬이 이 규칙과 기획부터 렌더까지의 순서를 알려 줘요.


이걸로 만든 사람들

자기 웹앱의 화면 녹화를 넘겼더니 필요한 부분만 잘라 제목과 클릭마다 효과음을 붙인 홍보 영상이 나왔대요. 한 번 고쳐 달라고 한 뒤, 같은 설정으로 홍보 영상 6편을 더 만들었다고 해요.
I opened Claude Code with the HyperFrames plugin, which renders video from an HTML file, and dictated what I wanted in my own words, the way I'd brief a human editor.
런던의 비를 다룬 데이터 영상을 지도와 차트까지 전부 HyperFrames로 만들었어요. 수치는 영국 기상청, NOAA, 호주 기상청의 1991–2020년 평균이래요.
Made the whole thing in hyperframes (because. why not lol XD), map charts all of it.
안에서는 이렇게 돌아가요
- 1
/hyperframes 스킬 → Claude Code
렌더 규칙과 작업 순서요소마다 class=clip, data-start, data-duration을 달고 타임라인을 멈춘 채 등록하라는 규칙을 먼저 읽혀요.skills/hyperframes/SKILL.md - 2
Claude Code → index.html
장면을 HTML로 작성영상, 제목, 음악을 트랙별로 적고 GSAP 같은 라이브러리로 애니메이션을 타임라인에 올려요.skills/hyperframes/references/format.md - 3
index.html → hyperframes CLI
npx hyperframes check --json규칙 위반과 화면 배치 문제를 찾아 고칠 방법(Fix)과 함께 돌려줘요.packages/cli/src/commands/check.ts - 4
hyperframes CLI → 헤드리스 Chrome
npx hyperframes renderHTML을 컴파일하고 길이와 미디어를 확인한 뒤 헤드리스 Chrome에 띄워요.packages/producer/src/services/render/stages/compileStage.ts - 5
헤드리스 Chrome
프레임마다 seek → 스크린샷window.__timelines의 타임라인을 한 프레임씩 옮기고 그 순간을 찍어요.packages/engine/src/services/frameCapture.ts - 6
헤드리스 Chrome → MP4 파일
프레임을 FFmpeg로 (image2pipe)찍은 프레임을 바로 FFmpeg 입력으로 흘려 영상으로 인코딩해요.packages/engine/src/services/streamingEncoder.ts - 7
hyperframes CLI → MP4 파일
소리를 섞어 MP4로 마무리오디오 트랙을 프레임 수에 맞춰 붙이고 웹에서 바로 재생되게 정리해요.packages/producer/src/services/render/stages/assembleStage.ts
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 제품 출시나 기능 소개 영상을 에이전트에게 맡기고 싶을 때
- 화면 녹화를 다듬어 짧은 홍보 영상으로 만들 때
- 차트, 지도, 숫자가 움직이는 데이터 영상
- 자막과 음악이 들어간 SNS용 짧은 영상을 여러 편 찍어낼 때
- 문서나 웹사이트를 설명 영상으로 바꿀 때
이건 안 돼요
- Node.js 22 이상과 FFmpeg가 있어야 렌더돼요.
- README 기준 데스크톱 앱은 Mac과 Linux용이에요. CLI와 스킬로는 앱 없이도 만들 수 있어요.
- 아바타나 생성형 영상 같은 일부 미디어는 HeyGen을 거치고, 나머지는 무료 로컬 도구로 해요.
- 저장소를 통째로 클론해 개발하려면 Git LFS로 약 240MB의 테스트 영상이 함께 받아져요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요