Communitygithub.com

christiansalazar-wk/ai-lore

HyperFrames CLI 개발 루프 — 로컬 개발을 위한 init, lint, preview, render 및 doctor 명령어

ai-lore란 무엇인가요?

HyperFrames CLI는 로컬 개발 환경에서 비디오 프레임워크 프로젝트를 생성, 검사, 미리보기 및 렌더링하기 위한 명령줄 도구입니다. 개발자는 `init` 명령어로 여러 템플릿(blank, product, explainer, slideshow) 중 하나를 선택하여 새 프로젝트를 빠르게 시작할 수 있으며, `lint` 명령어를 통해 `data-hf-*` 속성, 시간 형식, 클립 중복, 누락된 지속 시간, 접근 불가능한 에셋 및 TTS 길이 제한을 자동으로 검사합니다. `preview` 명령어는 스크러버, 씬 선택기 및 핫 리로드를 지원하는 실시간 개발 서버를 제공하며, `render` 명령어는 HEYGEN API 키를 사용하여 최종 비디오를 MP4, WebM 또는 GIF 형식으로 출력합니다. 또한 `doctor` 명령어를 통해 Node.js 버전, API 키, 네트워크 연결, 에셋 경로 및 설정 파일 구문을 점검할 수 있어 안정적인 개발 환경을 유지할 수 있습니다. 이 도구는 HyperFrames CLI를 지원하는 모든 플랫폼에서 사용할 수 있으며, npm을 통해 전역 설치하거나 npx를 사용하여 즉시 실행할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/hyperframes-cli

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HyperFrames CLI

npm install -g hyperframes   # 또는 npx 사용

명령어

init

npx hyperframes init <name> [--template blank|product|explainer|slideshow] [--fps 30] [--width 1920] [--height 1080]

lint

npx hyperframes lint [file] [--fix] [--strict] [--json]

검사 항목: 유효한 data-hf-* 속성, 시간 형식, 중복 클립, 누락된 지속 시간, 접근 불가능한 에셋, TTS 길이 제한.

preview

npx hyperframes preview [file] [--port 3000] [--open] [--scene <name>] [--time <t>]

스크러버, 씬 선택기 및 핫 리로드를 지원하는 실시간 개발 서버.

render

export HEYGEN_API_KEY=your_key
npx hyperframes render [file] [--out output.mp4] [--format mp4|webm|gif] [--quality 85] [--scene <name>]

doctor

npx hyperframes doctor

Node ≥ 18, API 키, 네트워크, 에셋 경로, 설정 파일 구문을 점검합니다.

hyperframes.config.json

{
  "version": 1,
  "entry": "index.html",
  "output": "./output.mp4",
  "canvas": { "width": 1920, "height": 1080, "fps": 30 },
  "render": { "quality": 85, "format": "mp4" },
  "tts": { "defaultVoice": "en-US-neural-f1", "speed": 1.0 },
  "assets": { "baseUrl": "./assets" }
}

환경 변수

변수설명
HEYGEN_API_KEY렌더링에 필요
HEYGEN_REGIONus (기본값) 또는 eu
HF_LOG_LEVELdebug, info, warn, error

개발 루프

npx hyperframes init my-video --template product
cd my-video
# index.html 편집
npx hyperframes lint
npx hyperframes preview --open
npx hyperframes render --out output.mp4

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

관련 스킬