heygen-com/hyperframes

Пиши HTML. Рендери видео. Создано для агентов.

Видео⭐ 64 725TypeScriptпоследний релиз: v0.8.164
Открыть на GitHub ↗

Что это за инструмент

HyperFrames — это open-source фреймворк на Node.js, который превращает HTML, CSS и медиа в детерминированные MP4-видео.

Зачем нужен

Инструмент решает задачу автоматизированного рендеринга видео из кода, что особенно полезно для AI-агентов. Он позволяет описывать видео через HTML и получать готовые видеоролики, интегрируясь в рабочие процессы AI-кодинга через навыки (skills).

Что можно реализовать

  • Генерация промо-видео продуктов с помощью AI-агентов (например, через prompt-инструкции)
  • Создание анимированных диаграмм и графиков данных
  • Автоматизация создания презентаций и слайдов в виде видео
  • Использование в качестве ядра рендеринга для хостинговых платформ

Ключевые возможности

  • Поддержка AI-кодинговых агентов (Claude Code, Cursor, Gemini CLI, Codex) через систему навыков
  • Детерминированный рендеринг: одинаковый HTML всегда дает одинаковое видео
  • Работа с seekable анимациями и медиафайлами
  • Открытая лицензия Apache 2.0 и поддержка Node.js >=22

👤 Кому подойдёт: разработчики, AI-инженеры, создатели контента, использующие AI-агентов для генерации медиа

Релизы

v0.8.164patch
🕐 5 ч назад · релиз на GitHub ↗

Исправлено сохранение порядка аудиодорожек, улучшена обработка ошибок ffmpeg и ограничено захват сайтов публичными адресами.

  • Fixed: CLI: захват сайтов теперь подключается только к публичным адресам, включая редиректы.
  • Fixed: Producer: при сбое ffmpeg теперь указывается код завершения и сохраняется последняя строка вывода.
  • Fixed: Engine: исправлено сохранение исходного порядка аудиодорожек в миксе.
v0.8.163minor
🕐 12 ч назад · релиз на GitHub ↗

Релиз HyperFrames v0.8.163: улучшена работа с SVG, добавлена телеметрия CPU и проверка альфа-канала.

  • Added: CLI: добавлена возможность оценки текста за прозрачным видео по декодированному альфа-каналу.
  • Added: CLI: отчеты телеметрии теперь включают данные о загруженности процессора.
  • Fixed: Исправлено сохранение встроенных SVG-логотипов и корректное скрытие анимированных SVG за пределами окна.
  • Fixed: CLI: теперь запрашивает вход в аккаунт при публикации, если это необходимо.
  • Fixed: Исправлена обработка длинных аудиофайлов и пропуск временных файлов при создании отпечатка навыка.
v0.8.162patch
🕐 вчера · релиз на GitHub ↗

В HyperFrames v0.8.162 исправлена ошибка CLI: теперь анализ завершённых аудио-активов запускается корректно после прямой загрузки.

  • Fixed: Исправлена работа CLI: теперь анализ завершённых аудио-активов выполняется после их прямой загрузки.
  • Fixed: Загрузка звука теперь обрабатывается как собственный актив перед запросом результатов, что соответствует формату сервиса анализа.
v0.8.161minor
🕐 вчера · релиз на GitHub ↗

В HyperFrames v0.8.161 добавлен трекинг битов без Chrome и исправлено разрешение TypeScript-деклараций для NodeNext.

  • Added: Команда hyperframes beats теперь использует TypeScript-трекер через FFmpeg, работая без Chrome.
  • Added: Студия делится трекером; при низкой уверенности аудио сетка битов не возвращается.
  • Fixed: Исправлено разрешение опубликованных TypeScript-деклараций при использовании модульного разрешения NodeNext.
v0.8.160minor
🕐 вчера · релиз на GitHub ↗

Добавлена команда audio для анализа таймингов звука, улучшены превью, рендеринг на Windows и отчётность по использованию Claude.

  • Added: Появилась команда hyperframes audio для измерения onset, пиков, пауз и громкости звука с учётом времени монтажа.
  • Fixed: Устранены вспышки неправильных кадров при предварительном просмотре обрезанных видео.
  • Fixed: Исправлена работа сохранения истории при изменении файла во время копирования.
  • Fixed: Расходы по плану Claude теперь отображаются даже при отсутствии окон тарификации в ответе.
  • Fixed: Рендеринг на Windows теперь корректно ожидает доступности установленных браузеров и FFmpeg.
v0.8.159minor
🕐 вчера · релиз на GitHub ↗

HyperFrames v0.8.159: улучшена работа snapshot и check в изолированных средах, исправлено отображение сцен и ускорена проверка GPU.

  • Added: Флаг snapshot --keep позволяет пересоздать один кадр, сохраняя остальные.
  • Fixed: Команды check и snapshot теперь работают в песочницах без доступа к localhost.
  • Fixed: Исправлено скрытие содержимого дочерних сцен при скрытом родителе.
  • Fixed: Проверка GPU в песочнице больше не задерживается на 120 секунд.
  • Fixed: Устранена зависание конвертации видео в init из-за логов ffmpeg.
v0.8.158minor
🕐 вчера · релиз на GitHub ↗

HyperFrames v0.8.158: инициализация без перекодирования, новые сторборды из кадров и исправления CLI для Windows.

  • Added: Флаг init --keep-original позволяет добавлять клипы в проект без перекодирования.
  • Added: Сторборды теперь представляют собой одну страницу с кадрами, созданными агентами.
  • Fixed: Исправлена ошибка проверки (check) на загруженных системах Windows.
  • Fixed: Сохранение шрифтов в стиле блока при захвате (capture) теперь работает корректно.
v0.8.157patch
🕐 2 дн назад · релиз на GitHub ↗

Исправлено использование GPU в WSL для Chrome 150+ и сохранение цветокоррекции на первом кадре.

  • Fixed: В WSL с Chrome 150+ снова задействуется GPU для рендеринга, избегая медленного программного режима.
  • Fixed: На первом отрендеренном кадре видео сохраняется цветовая градация (color grade).
  • В Docker-образах зафиксирована версия FFmpeg 8.0.1 для стабильности CI.
  • Улучшена точность бенчмарков редактирования и переиспользование Chrome в Studio.
v0.8.156patchbreaking
🕐 2 дн назад · релиз на GitHub ↗

Исправлены зависания видео на FFmpeg 8, ускорен запуск сегментированных рендеров и улучшена работа GPU в WSL.

  • Breaking: Inspector больше не поставляется с инструментами агентов; теперь их определяют сами harness, удалены старые экспорты.
  • Fixed: Исправлено зависание части видео при рендере на FFmpeg 8 за счёт выборки VFR-видео по временным меткам.
  • Fixed: Сегментированные рендеры теперь запускаются быстрее, так как загрузка медленных медиа у рабочих процессов происходит параллельно.
  • Fixed: В WSL рендеры используют GPU через полный Chrome, если headless shell недоступен, вместо программного рендеринга.
  • Fixed: Оптимизирована обработка аудио: устранено лишнее дополнение входных данных, что снижает нагрузку при длинных миксах.
v0.8.155minor
🕐 2 дн назад · релиз на GitHub ↗

Исправлена потеря пикселей в MP4 на новых FFmpeg и добавлена поддержка параметров кодирования CRF, битрейта и формата видео.

  • Fixed: Устранена проблема с черной полосой справа в MP4-рендерах шириной 1000, 1080 или 1112 пикселей на FFmpeg 7.1 и 8.0.
  • Added: Сервер Producer теперь принимает параметры crf, videoBitrate и videoFrameFormat в эндпоинтах /render и /render/stream.
  • Added: Studio Server поддерживает параметры crf, videoBitrate, videoFrameFormat и hdrMode, возвращая ошибку 400 при некорректных значениях.
  • Fixed: В распределенном рендеринге с постоянным FPS теперь корректно сохраняется заданный параметр CRF вместо падения к пресету качества.
v0.8.154patch
🕐 2 дн назад · релиз на GitHub ↗

Исправлено зависание инспектора и обновление кэшей превью после открытия композиции с аудио.

  • Fixed: Устранена проблема, при которой кэш аудио-волны делал все вопросы в инспекторе неактуальными.
  • Fixed: Кэши waveform и миниатюр в Studio теперь корректно обрабатывают обновления, избегая устаревших превью.
v0.8.153patch
🕐 2 дн назад · релиз на GitHub ↗

В HyperFrames v0.8.153 исправлена проблема зависания проверки: теперь CLI прерывает stuck-скрипты и указывает проблемный файл.

  • Fixed: Команда `hyperframes check` теперь корректно останавливается, если скрипт зависает, вместо бесконечного ожидания.
  • Fixed: При зависании во время запуска ошибка содержит имя файла, требующего исправления.
  • Fixed: Скачивание браузеров и первый запуск больше не расходуют лимит времени проверки.
v0.8.152majorbreaking
🕐 3 дн назад · релиз на GitHub ↗

Новая структура хранения артефактов, блокировка одновременных сессий и исправление таймингов GSAP.

  • Breaking: Снимки и проверки теперь сохраняются в .hyperframes/artifacts, старые пути в snapshots/ больше не работают.
  • Added: Добавлены флаги --exclusive, --who и --if-open для управления очередностью ходов агентов в проекте.
  • Added: История проекта теперь фиксирует состояние видео, цели редактирования и очистку артефактов.
  • Fixed: Keyframes корректно сообщают о неразрешенных таймингах GSAP, а не пытаются угадать позы.
  • Added: Отключена телеметрия onnxruntime для синтеза Kokoro.
v0.8.151minor
🕐 3 дн назад · релиз на GitHub ↗

Исправлены цветовые шумы при экспорте, улучшена работа с ProRes, добавлен Inspector и CLI-снэпшоты.

  • Fixed: Устранены цветовые шумы при экспорте через JPEG, улучшена корректность цветов ProRes.
  • Added: Добавлен Inspector с поддержкой карты элементов, живого просмотра и запросов к таймлайнам.
  • Added: В CLI добавлена возможность создания снимков (snapshot) диапазона времени или композиции.
  • Fixed: Исправлено кодирование выходных файлов ProRes в формат BT.709.
  • Fixed: Улучшена точность поиска и устранены повторы кадров при обрезке видео по транскрипту.
v0.8.150minorbreaking
🕐 4 дн назад · релиз на GitHub ↗

В HyperFrames v0.8.150 добавлена глобальная цепочка аудиоэффектов, оптимизирована память при рендере видео и исправлены ошибки экспорта.

  • Added: Появилась возможность применять цепочку аудиоэффектов ко всей композиции через атрибут data-fx-chain на корневом элементе.
  • Breaking: Атрибут data-fx-chain на корневом элементе теперь обрабатывает весь микш; для сохранения старого поведения удалите неиспользуемую цепочку.
  • Fixed: Экспорт видео и аудио теперь корректно учитывает точки входа сцен и начальные времена, соответствующие превью.
  • Заменённые видеокадры больше не накапливают кэшированные ресурсы, а тяжёлые аудиоэффекты рендерятся порциями.
  • Fixed: Исправлено поведение мастер-цепочки аудио для сцен, просматриваемых или рендерящихся по отдельности.
v0.8.149minor
🕐 4 дн назад · релиз на GitHub ↗

В HyperFrames v0.8.149 добавлен модуль hyperframes/api для импорта функций transcribe и removeBackground как обычных функций.

  • Added: Появился новый entry point hyperframes/api, экспортирующий функции transcribe и removeBackground для прямого импорта.
  • Added: Функции возвращают типизированные результаты и выбрасывают типизированные ошибки, что упрощает интеграцию.
  • Added: Теперь инструменты вроде HyperFrames Desktop могут вызывать эти функции напрямую, без необходимости запуска CLI как дочернего процесса.
v0.8.148patch
🕐 4 дн назад · релиз на GitHub ↗

Исправлено исчезновение видео при скрытии слоёв, синхронизация звука и изображения в экспортах, а также позиционирование панели горячих клавиш.

  • Fixed: Видео в превью студии больше не исчезает, когда скрипт скрывает слой поверх него.
  • Fixed: Экспорт в MP4, MOV и TS теперь корректно синхронизирует звук и картинку при разном старте потоков.
  • Fixed: Панель горячих клавиш теперь всегда отображается поверх элементов управления плеером и внутри окна.
v0.8.147patch
🕐 5 дн назад · релиз на GitHub ↗

В HyperFrames v0.8.147 улучшено информирование о зависаниях рендера: теперь указывается шаг и рекомендации.

  • Fixed: Движок теперь указывает конкретный шаг Chrome, на котором произошло зависание при рендере.
  • Fixed: Добавлены рекомендации по действиям, например, ожидание завершения других тяжелых задач GPU или CPU.
v0.8.146minor
🕐 5 дн назад · релиз на GitHub ↗

Добавлен лимитер Truepeak, улучшена работа с FFmpeg и субкомпозициями, исправлены ошибки экспорта и CLI.

  • Added: Добавлен эффект лимитера Truepeak с опережающим просмотром.
  • Fixed: Субкомпозиции теперь корректно воспроизводятся с точки входа в превью и на таймлайне.
  • Fixed: FFmpeg обнаруживается автоматически после установки во время работы превью.
  • Fixed: Экспорт больше не падает, если клип выходит за пределы длины композиции.
  • Fixed: Исправлено распаковывание браузерных сборок на системах без команды unzip.
v0.8.145minor
🕐 6 дн назад · релиз на GitHub ↗

В HyperFrames v0.8.145 добавлено кодирование на GPU, исправлены зависания экспорта и оптимизирован размер npm-пакета.

  • Added: Studio теперь поддерживает кодирование видео на GPU через флаг render --gpu.
  • Fixed: Устранены зависания длинных экспортов на отметке 90% и скрытые таймауты.
  • Fixed: Превью теперь корректно восстанавливаются после зависания шрифтов или ассетов.
  • Fixed: npm-пакет Producer стал значительно меньше, так как больше не включает исходные карты.
  • Fixed: Исправлена работа CLI-команды keyframes --shot для файлов compositions/.
v0.8.144minor
🕐 6 дн назад · релиз на GitHub ↗

HyperFrames v0.8.144: улучшена стабильность CLI на Windows, добавлена прямая запись субтитров в SRT/VTT и исправлены баги превью.

  • Added: CLI: команда transcribe теперь поддерживает прямую запись субтитров в форматы SRT и VTT.
  • Added: CLI: в списке моделей отображается информация о том, какие модели распознавания речи поддерживает transcribe.
  • Fixed: Core: исправлено обрезание слоёв в маленьких превью для сложных композиций.
  • Fixed: Core: исправлено бесконечное воспроизведение сцены в превью, теперь оно останавливается в конце фильма.
  • Fixed: CLI: улучшена стабильность работы на Windows, включая исправление отмены рендеров и корректную обработку ошибок распаковки.
v0.8.143minor
🕐 7 дн назад · релиз на GitHub ↗

Ускорено планирование длинных видео за счет выборочного извлечения кадров, исправлен парсинг WebVTT и улучшена точность проверки.

  • Added: Распределенный рендеринг длинных видео теперь стартует быстрее: каждый чанк извлекает только нужные кадры, а не все сразу.
  • Fixed: Исправлен парсинг субтитров WebVTT, сохранение меток спикеров и временных меток.
  • Fixed: Улучшена точность команд hyperframes check и lint, включая обработку inline-скриптов и атрибутов.
  • Fixed: Исправлены крайние случаи в SDK при сохранении и патчинге, а также нормализация аудио в CLI.
  • Fixed: Улучшена работа с медиа: корректное отображение текста под прозрачными блоками, градиентных масок и GIF-задержек.
v0.8.142minor
🕐 7 дн назад · релиз на GitHub ↗

В CLI добавлена поддержка токенов от хост-приложений, исправлены ошибки в Studio и улучшена группировка проверок.

  • Added: CLI теперь принимает HeyGen access token от хост-приложения, позволяя авторизоваться без сохранения учётных данных.
  • Added: При наличии переменной окружения HEYGEN_ACCESS_TOKEN CLI использует её в приоритетном порядке перед файлом credentials.
  • Fixed: Исправлена группировка результатов проверок (check findings) по элементам и правилам в CLI.
  • Fixed: В Studio исправлено обновление имён сгенерированных медиафайлов при их замене.
  • Fixed: В Studio восстановлена функция overscan и опубликован zoom viewport.
v0.8.141patch
🕐 8 дн назад · релиз на GitHub ↗

Исправлены падения рендеров из-за шрифтов, улучшено декодирование HEVC/ProRes и добавлена поддержка шлюзов для media-use.

  • Fixed: Рендеры больше не падают, если ссылка на Google шрифт возвращает пустой список начертаний — используется стандартная толщина.
  • Fixed: Превью видео в Studio декодируются HEVC и ProRes в реальном размере на экране, исчезают вспышки фона при переключении 4K-клипов.
  • Fixed: Игроки загружают композиции, опираясь на длительность документа, и сообщают о первой ошибке автора.
  • Added: media-use теперь может проходить через шлюз хост-приложения с использованием переменной HEYGEN_API_BASE.
  • Fixed: Ошибки неразрешенных шрифтов теперь содержат структурированную диагностику без раскрытия имен, URL или текста страницы.
v0.8.140minor
🕐 9 дн назад · релиз на GitHub ↗

В HyperFrames v0.8.140 добавлена поддержка WebGPU, улучшено сглаживание движения и отрисовка длинных таймлайнов.

  • Added: Добавлены шесть новых фонов на базе WebGPU и возможность рендеринга через программную графику.
  • Fixed: Исправлена работа motion blur для видео, улучшена производительность масштабирования длинных таймлайнов.
  • Added: В интерфейс добавлены отчеты о прогрессе кодирования и сборки, а также улучшена замена изображений.
  • Fixed: Устранены ложные предупреждения о статичном движении и перекрытии текста в валидных композициях.
  • Added: Улучшена работа транскрипции, сохранение обновлений таймлайна и предзагрузка сцен в превью.
v0.8.139minor
🕐 9 дн назад · релиз на GitHub ↗

Встроенная транскрипция теперь работает в десктопном приложении, добавлен новый визуальный блок Gooey и исправлены баги интерфейса.

  • Added: Встроенная транскрипция перенесена в десктопное приложение HyperFrames.
  • Added: В каталог добавлен блок Gooey с эффектом метаболлов и направленной размытостью движения.
  • Added: Команда transcribe --json теперь потоково выводит слова в реальном времени.
  • Fixed: Исправлено смещение элементов при перетаскивании после изменения размера, отмены или перезагрузки.
  • Fixed: Улучшена работа parakeet-mlx: автоматическое определение языка и корректное чтение WAV в JS.
v0.8.138patch
🕐 9 дн назад · релиз на GitHub ↗

Обновление HyperFrames v0.8.138: улучшена стабильность CLI, исправлены ошибки Studio и сохранены SVG-иконки.

  • Added: CLI теперь синхронизирует изменения, сделанные в десктопном приложении с момента передачи проекта.
  • Added: При повреждении кэша Parakeet транскрипция загружает резервную копию Sherpa, поставляемую с CLI.
  • Fixed: Исправлено некорректное поведение Studio при офлайн-превью: теперь выводится понятное сообщение об ошибке GSAP.
  • Fixed: Сохранены SVG-иконки в загруженных композициях и устранено выделение названий строк при перетаскивании.
  • Fixed: Исправлено смещение заголовка за пределы экрана из-за программной прокрутки и очищены маршруты файлов.
v0.8.137minor
🕐 10 дн назад · релиз на GitHub ↗

Оптимизация памяти при загрузке, улучшенное распознавание языка в Whisper и новые флаги CLI.

  • Added: Whisper теперь автоматически определяет язык речи и отображает прогресс транскрипции.
  • Added: В CLI добавлен флаг --no-runtime-install для предотвращения установки runtime Whisper.
  • Fixed: Значительно снижено потребление памяти при загрузке композиций с крупными изображениями и скриптами.
  • Fixed: В Studio добавлено уведомление «Too loud» при превышении порога громкости с отображением пикового значения.
v0.8.136patch
🕐 10 дн назад · релиз на GitHub ↗

Исправлены крахи приложения и зависания превью из-за кавычек в URL, улучшена проверка длины имени папки.

  • Fixed: Устранены крахи запуска приложения и зависания превью в Studio, вызванные экранированными кавычками в URL изображений.
  • Fixed: CLI теперь корректно отказывает в инициализации, если имя папки превышает допустимую длину, выводя понятное сообщение об ошибке.
  • Added: Превью теперь открываются без исчерпания памяти при использовании больших встроенных фоновых изображений.
v0.8.134patch
🕐 10 дн назад · релиз на GitHub ↗

Исправлено поведение элементов при добавлении ключевых кадров и улучшено автозапись размеров в Studio.

  • Fixed: В Studio элементы теперь сохраняют позицию и размер при добавлении ключевых кадров.
  • Added: Реализована автозапись размеров элементов по текущему положению курсора воспроизведения.
  • Added: Добавлены страницы документации для приложения Studio на macOS и Linux.