Communitygithub.com

christiansalazar-wk/ai-lore

Bucle de desarrollo CLI de HyperFrames: comandos init, lint, preview, render y doctor para desarrollo local.

¿Qué es ai-lore?

HyperFrames CLI es una herramienta de línea de comandos diseñada para desarrolladores que crean videos generativos basados en web (como presentaciones, explicaciones o videos de productos) utilizando marcos HTML y atributos `data-hf-*`. Permite un flujo de trabajo iterativo completo: inicialización de proyectos con plantillas, linting de sintaxis y reglas de video, previsualización en vivo con recargador en caliente, renderizado final a formatos como MP4 o GIF, y un comando 'doctor' para diagnosticar el entorno. Es compatible con cualquier sistema que tenga Node.js ≥18 y se integra con la API de HeyGen para renderizado con avatares y TTS. La herramienta es útil para equipos que quieran prototipar y producir videos programáticamente, manteniendo todo el control de versión en código fuente.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

CLI de HyperFrames

npm install -g hyperframes   # o usa npx

Comandos

init

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

lint

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

Verifica: atributos data-hf-* válidos, formatos de tiempo, clips superpuestos, duraciones faltantes, activos inalcanzables, límites de longitud de TTS.

preview

npx hyperframes preview [archivo] [--port 3000] [--open] [--scene <nombre>] [--time <t>]

Servidor de desarrollo en vivo con scrubber, selector de escenas y recarga en caliente.

render

export HEYGEN_API_KEY=tu_clave
npx hyperframes render [archivo] [--out salida.mp4] [--format mp4|webm|gif] [--quality 85] [--scene <nombre>]

doctor

npx hyperframes doctor

Verifica Node ≥ 18, clave API, red, rutas de activos, sintaxis de configuración.

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" }
}

Variables de Entorno

VariableDescripción
HEYGEN_API_KEYrequerida para render
HEYGEN_REGIONus (por defecto) o eu
HF_LOG_LEVELdebug, info, warn, error

Bucle de Desarrollo

npx hyperframes init my-video --template product
cd my-video
# editar index.html
npx hyperframes lint
npx hyperframes preview --open
npx hyperframes render --out salida.mp4

Individual skills in this repo

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

Skills relacionados