Communitygithub.com

christiansalazar-wk/ai-lore

Loop de desenvolvimento CLI do HyperFrames — comandos init, lint, preview, render e doctor para desenvolvimento local.

O que é ai-lore?

O HyperFrames CLI é uma ferramenta de linha de comando para criação e renderização de vídeos animados a partir de HTML, voltada para desenvolvedores que desejam automatizar a produção de conteúdo visual. Ele oferece um ciclo de desenvolvimento completo: inicialização de projetos com templates pré-definidos (blank, product, explainer, slideshow), linting para validar atributos `data-hf-*`, formatos de tempo, clipes sobrepostos e assets inacessíveis, preview com servidor local e recarregamento automático, renderização para MP4, WebM ou GIF, além de um comando `doctor` que verifica pré-requisitos como Node ≥ 18, chave de API, rede e sintaxe de configuração. O HyperFrames é executado via `npx` e suporta configuração via `hyperframes.config.json` e variáveis de ambiente como `HEYGEN_API_KEY`. A ferramenta é ideal para desenvolvedores que trabalham com animações programáticas, prototipagem rápida de vídeos e integração com pipelines de CI/CD.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

CLI do HyperFrames

npm install -g hyperframes   # ou use npx

Comandos

init

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

lint

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

Verifica: atributos data-hf-* válidos, formatos de tempo, clipes sobrepostos, durações ausentes, assets inacessíveis e limites de comprimento de TTS.

preview

npx hyperframes preview [arquivo] [--port 3000] [--open] [--scene <nome>] [--time <t>]

Servidor de desenvolvimento ao vivo com scrubber, seletor de cenas e recarregamento automático.

render

export HEYGEN_API_KEY=sua_chave
npx hyperframes render [arquivo] [--out output.mp4] [--format mp4|webm|gif] [--quality 85] [--scene <nome>]

doctor

npx hyperframes doctor

Verifica Node ≥ 18, chave de API, rede, caminhos de assets e sintaxe de configuração.

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

Variáveis de Ambiente

VariávelDescrição
HEYGEN_API_KEYobrigatória para render
HEYGEN_REGIONus (padrão) ou eu
HF_LOG_LEVELdebug, info, warn, error

Loop de Desenvolvimento

npx hyperframes init meu-video --template product
cd meu-video
# edite 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.

Habilidades Relacionadas