HyperFrames HTML vers vidéo : le dépôt heygen-com/hyperframes propose d’écrire une vidéo comme une page web, puis d’en tirer un MP4 identique à chaque rendu. Le projet se décrit comme un framework open source qui transforme HTML, CSS, médias et animations « seekables » en vidéos déterministes, utilisable en ligne de commande, depuis un agent de code via des skills, ou comme moteur de rendu d’outils hébergés. Il compte environ 69 500 étoiles en octobre 2026.
Pour une équipe qui produit des vidéos de lancement, des explications de pull request ou des rapports animés, l’intérêt est d’obtenir un rendu reproductible dans une chaîne CI, donc supervisable comme n’importe quel job. Cet article suit le README et la documentation du projet : ce que c’est, ce que montre le rendu, l’installation, les limites, et comment observer une chaîne de rendu. Pour le cadre général des agents qui produisent des fichiers, voir les garde-fous des agents IA en production.
Précision d’honnêteté : span.observer n’a pas installé ni lancé HyperFrames. Les commandes viennent du README et de la documentation du dépôt. La première image est un aperçu publié dans le README ; les deux autres sont des extraits de ces fichiers rendus par nos soins.
HyperFrames HTML vers vidéo : ce que dit le dépôt
- Éditeur : le dépôt est hébergé par l’organisation GitHub
heygen-com. Le README indique que l’outil est utilisé en production chez HeyGen, avec des exemples de la communauté (tldraw, TanStack, d’autres dans ADOPTERS.md). span.observer n’a aucun lien avec ces entreprises. - Licence : Apache-2.0 (fichier LICENSE). Le README met en avant « aucun frais par rendu ni seuil d’usage commercial ».
- Chiffres relus le 22 octobre 2026 sur la page du dépôt : environ 69 500 étoiles, environ 6 300 forks, 5 817 commits sur la branche principale. La dernière release affichée est la v0.8.185, du 21 octobre 2026 ; le paquet CLI
hyperframesporte cette même version. - Langage : TypeScript, d’après les thèmes du dépôt ; le CLI demande Node.js 22 ou plus et FFmpeg.
- Composants : un CLI, un moteur (capture de pages avec Puppeteer et FFmpeg), un « producer » qui orchestre capture, encodage et mixage audio, un Studio navigateur pour prévisualiser, un catalogue d’environ 450 blocs et composants, et un rendu distribué sur AWS Lambda.
Le README compare lui-même HyperFrames à Remotion : même principe (Chrome headless et FFmpeg), mais HTML simple plutôt que composants React, et licence Apache-2.0 contre une licence « source-available » côté Remotion. C’est la présentation du projet, pas une mesure indépendante.
Ce que montre le rendu
Le README publie des modèles de design (« frame.md ») qui servent de point de départ à un agent. Voici l’un d’eux, Cobalt Grid : un fond papier avec une grille de dessinateur, un titre en serif et des barres bleues. C’est une image de ce qu’une composition peut produire, pas une capture de l’outil en fonctionnement.

Une composition est un fichier HTML. Des attributs data- décrivent le temps et les pistes, et une animation « seekable » (GSAP, CSS, Lottie, Three.js, Anime.js, WAAPI) se laisse positionner sur n’importe quelle image. Voici l’exemple du README :

Lecture du fichier : data-start et data-duration placent chaque élément dans le temps, data-track-index l’affecte à une piste, et la timeline GSAP est créée en pause puis enregistrée dans window.__timelines, ce qui permet au moteur de la positionner sans dépendre de l’horloge murale. D’après le README, le moteur se place sur chaque image dans Chrome headless et encode le résultat avec FFmpeg : c’est ce qui rend la sortie identique pour une même entrée.
Installation pas à pas
Étape 1 — Avec un agent de code
Pour Claude Code, le README indique d’installer le plugin versionné :
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes
Pour des skills autonomes (OpenCode compris) :
npx skills add heygen-com/hyperframes
Le projet fournit 7 skills ; le groupe de base contient /hyperframes, /hyperframes-cli, /hyperframes-registry et /media-use. Un skill donne à l’agent les instructions d’un fournisseur : relisez-les avant installation, comme tout code qui s’exécute avec vos droits.
Étape 2 — À la main, avec le CLI
Prérequis annoncés : Node.js 22+ et FFmpeg.
npx hyperframes init my-video
cd my-video
npx hyperframes preview # aperçu navigateur avec rechargement
npx hyperframes render # rendu MP4

Étape 3 — Régler le rendu
Le guide rendering documente les options utiles à une chaîne automatisée : --output (sans lui, le résultat va dans renders/), --quality draft ou high, --fps 60, --format webm|mov|gif|png-sequence|hls, --composition pour viser un autre fichier, et --docker quand il faut un Chrome, un FFmpeg et des polices contrôlés, par exemple en CI. La documentation précise que Docker ajoute un temps de démarrage et n’est pas obligatoire.
Limites et points ouverts
- Le rythme des versions (v0.8.185 à ce jour) signale un projet très actif, donc instable : épinglez la version du CLI dans vos pipelines.
- Le Studio est décrit comme « disponible, évolutif » dans le tableau du README ; le CLI est la partie la plus stable.
- Le dépôt utilise Git LFS pour environ 240 Mo de vidéos de référence : à savoir avant de cloner le dépôt complet.
- Sous WSL2, la documentation signale que Chrome peut retomber en rendu logiciel, plusieurs fois plus lent ; elle conseille de rendre depuis Windows si le GPU n’est pas utilisé.
- Les exemples chargent GSAP depuis un CDN : pour un rendu hors ligne, hébergez la bibliothèque vous-même.
- Les médias générés par des services tiers (voix, avatars) relèvent des conditions de ces services, pas de la licence du projet.
Observer une chaîne de rendu HyperFrames
HyperFrames n’est pas un serveur : c’est un outil de ligne de commande, donc on le supervise comme un job. Ce qui suit vaut pour Dynatrace SaaS comme pour Dynatrace Managed, via les données de votre CI ou d’un Collector OpenTelemetry. Le projet lui-même ne documente pas d’export OpenTelemetry.
- Durée et statut : mesurez la durée et le code de sortie de
npx hyperframes renderdans votre CI. Le guide de performance recommande de mesurer avant de changer quoi que ce soit, avec Chrome DevTools en prévisualisation, puis de comparer. - Réglages de la machine :
npx hyperframes benchmarkcompare plusieurs combinaisons de fps, de qualité et de nombre de workers (de 1 à 20 passages, 3 par défaut) ;npx hyperframes doctorvérifie qu’une machine peut rendre. - Qualité du rendu :
lint,checketsnapshotrepèrent des problèmes avant le rendu complet. Pour piloter un navigateur depuis un agent, voir Chrome DevTools MCP pour agents de code. - Provenance : chaque vidéo porte deux balises de conteneur,
hyperframes_rendererethyperframes_version, lisibles avecffprobe -v error -show_entries format_tags -of json out.mp4. Utile pour retrouver quelle version a produit un fichier. - Télémétrie du CLI : le CLI collecte des données d’usage, dont les noms de commandes, les performances de rendu et une empreinte grossière de l’environnement (système, CPU, mémoire, nom de l’agent de code détecté). Le contenu des vidéos et les noms de projet ne sont pas collectés, d’après la documentation. Elle se désactive avec
npx hyperframes telemetry disableet se vérifie avectelemetry status. - Coûts : l’agent qui écrit la composition consomme des jetons ; suivez-les comme dans le coût d’un agent IA en jetons avec OpenTelemetry.
Comment vérifier que ça fonctionne
npx hyperframes doctorne signale aucun manque.npx hyperframes previewlit la composition dans le navigateur.npx hyperframes render --output final.mp4produit un fichier ;ffprobeen lit la durée et les balises de provenance.- Deux rendus successifs de la même composition donnent la même vidéo, comme le promet le projet ; comparez leurs empreintes avant de bâtir un test de régression dessus.
Bonnes pratiques
- Épinglez la version de
hyperframeset celle des skills installés. - Rendez en CI avec
--dockersi la reproductibilité compte plus que la vitesse. - Gardez les médias sources dans le dépôt de la vidéo et dimensionnez-les à la résolution de sortie.
- Décidez de la télémétrie avant le déploiement, pas après.
- Relisez le contenu généré par un agent avant diffusion : texte, marques, droits des musiques et des images.
Questions fréquentes
HyperFrames est-il gratuit pour un usage commercial ?
Le projet est sous licence Apache-2.0 et le README annonce l’absence de frais par rendu. Les services tiers que vos compositions appellent ont leurs propres conditions.
Faut-il savoir programmer en React ?
Non : une composition est un fichier HTML avec des attributs de temps et une animation. C’est le choix de conception mis en avant par le README face à Remotion.
Le rendu est-il vraiment identique à chaque fois ?
C’est l’objectif annoncé (« même entrée, mêmes images, même sortie »). Les écarts viennent en général de l’environnement : version de Chrome, polices, FFmpeg. D’où l’intérêt du mode --docker et d’un test de comparaison.
Conclusion
HyperFrames répond à un besoin concret : faire produire des vidéos par un agent sans passer par un éditeur graphique, avec un rendu qu’une chaîne CI peut rejouer et mesurer. Gardez trois réflexes : épingler la version, décider de la télémétrie, et mesurer chaque rendu. Sources : dépôt heygen-com/hyperframes.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle.