Communitygithub.com

christiansalazar-wk/ai-lore

CLI de développement HyperFrames — commandes init, lint, preview, render et doctor pour le développement local.

Qu'est-ce que ai-lore ?

HyperFrames CLI est un outil en ligne de commande qui permet aux développeurs de créer, valider, prévisualiser et générer des vidéos animées (HyperFrames) directement depuis leur terminal. Il est conçu pour fonctionner avec Node.js et s'intègre parfaitement dans un flux de développement local. Les commandes principales incluent `init` pour initialiser un projet avec un template, `lint` pour valider la syntaxe et les attributs `data-hf-*`, `preview` pour lancer un serveur de développement local avec rechargement à chaud, `render` pour exporter la vidéo finale via l'API HeyGen (une clé API est requise), et `doctor` pour diagnostiquer la configuration et l'environnement. Le fichier `hyperframes.config.json` permet de personnaliser les paramètres de la vidéo, du rendu et de la synthèse vocale (TTS). Ce skill est particulièrement utile pour les développeurs qui souhaitent automatiser la production de vidéos explicatives, de produits ou de présentations dans leur pipeline CI/CD ou leur environnement de développement local.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

CLI HyperFrames

npm install -g hyperframes   # ou utiliser npx

Commandes

init

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

lint

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

Vérifie : attributs data-hf-* valides, formats de temps, clips qui se chevauchent, durées manquantes, ressources inaccessibles, limites de longueur TTS.

preview

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

Serveur de développement local avec curseur de défilement, sélecteur de scène et rechargement à chaud.

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

Vérifie Node ≥ 18, clé API, réseau, chemins des ressources, syntaxe de configuration.

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 d'environnement

VariableDescription
HEYGEN_API_KEYrequis pour le rendu
HEYGEN_REGIONus (par défaut) ou eu
HF_LOG_LEVELdebug, info, warn, error

Boucle de développement

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

Skills associés