HyperFrames: viết HTML ra video MP4, cho AI agent — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về heygen-com/hyperframes — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: HyperFrames: viết HTML là ra video MP4, dành cho AI agent — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
HyperFrames là framework mã nguồn mở, miễn phí của HeyGen, biến HTML, CSS, media và animation thành video MP4 giống nhau ở mọi lần render. Bạn có thể dùng bằng lệnh CLI hoặc cài skill để Claude Code, Codex, Cursor làm video theo yêu cầu. Cài bằng vài lệnh, cần Node.js 22+ và FFmpeg.
HyperFrames là một framework mã nguồn mở, miễn phí của HeyGen, giúp bạn dựng video bằng cách viết HTML rồi render thành file MP4. Hiểu đơn giản: bạn (hoặc một AI agent) viết một trang web có tiêu đề, video nền, nhạc, hiệu ứng chuyển động. HyperFrames chụp từng khung hình của trang đó rồi ghép thành video.
Repo này hợp với ba nhóm người. Nhóm thứ nhất là người làm kinh doanh, văn phòng muốn có video giới thiệu sản phẩm mà không rành phần mềm dựng phim. Nhóm thứ hai là lập trình viên mới đã biết chút HTML. Nhóm thứ ba là người đang dùng Claude Code, Codex, Cursor hay agent tương tự và muốn bảo agent 'làm cho mình một video'. Hiện repo có khoảng 83.637 sao và 7.718 fork, giấy phép Apache-2.0.
Điểm đáng giá nhất là hai thứ. Thứ nhất, video là HTML thuần, không cần học React hay công cụ dựng riêng. Thứ hai, kết quả có tính lặp lại: cùng đầu vào thì ra cùng khung hình, cùng video. Nhờ vậy bạn có thể tự động hoá việc làm video.
heygen-com/hyperframes
HyperFrames là framework mã nguồn mở của HeyGen: viết HTML và animation, render ra video MP4 ổn định, dùng bằng CLI hoặc nhờ AI agent như Claude Code làm giúp.
I.HyperFrames làm được gì
Dưới đây là những tính năng chính, kèm lợi ích thực tế.
- Dựng video từ HTML. Một file
index.htmlcó các thuộc tính thời gian (bắt đầu, độ dài, lớp track) là đủ mô tả video. Không cần bước build, bạn có thể mở xem thẳng trong trình duyệt. - Làm việc với AI agent. Repo có bộ skill dạy agent quy trình làm video: lên kế hoạch, viết HTML hợp lệ, nối animation, thêm media, kiểm tra lỗi, xem trước và render. Bạn chỉ cần mô tả video bằng lời. CLI cũng chạy không cần hỏi đáp qua lại, nên agent dùng rất thuận.
- Nhiều kiểu animation. Bạn có thể dùng GSAP, CSS, Lottie, Three.js, Anime.js, WAAPI hoặc tự viết adapter. Điều kiện là animation phải 'tua được' (seekable), để máy nhảy đến đúng khung hình cần chụp.
- Kết quả ổn định. Trình render đưa từng khung vào Chrome không giao diện, rồi dùng FFmpeg mã hoá. Cùng đầu vào cho cùng đầu ra, hợp với CI và các quy trình tự động.
- Catalog có sẵn. Theo README, kho này có khoảng 450 khối và thành phần làm sẵn: chuyển cảnh, lớp phủ, tiêu đề, chữ chuyển động, phụ đề, biểu đồ, bản đồ, 3D, chuyển động camera. Chúng được cài về dạng mã nguồn để bạn sửa lại được.
- Phát triển và đưa lên đám mây. Bạn render cục bộ hoặc trong Docker. README còn nói có render phân tán trên AWS Lambda, và Studio để xem trước, chỉnh sửa trên trình duyệt (đang phát triển).
- frame.md. Đây là lớp chuyển bộ nhận diện thương hiệu (design.md) sang dạng phù hợp với khung hình video, để agent dựng video đúng phong cách mà không phải đoán.
- Không tính phí mỗi lần render. README ghi rõ giấy phép Apache 2.0, không có phí theo lượt render hay ngưỡng thương mại. Studio dùng miễn phí, còn gói Pro của Studio có thêm các mô hình video, ảnh, giọng nói và nhạc của HeyGen.
Ngoài ra README nói HyperFrames lấy cảm hứng từ Remotion. Cả hai đều render bằng Chrome không giao diện và FFmpeg. Khác biệt chính là Remotion viết video bằng React và cần bundler, còn HyperFrames dùng HTML thuần và không cần bước build.
II.Cần chuẩn bị gì
Theo README, nếu dùng thủ công bằng CLI, bạn cần:
- Node.js 22 trở lên
- FFmpeg
Nếu dùng cùng AI agent, bạn cần có sẵn một agent hỗ trợ skill, ví dụ Claude Code, Codex, Cursor, Gemini CLI hay IBM Bob. Cách cài skill cho OpenCode cũng được README nhắc tới.
Về tài khoản, API key hay phần cứng (như GPU), README không nêu yêu cầu bắt buộc nào cho phần cài cơ bản. Các tính năng Pro (mô hình video, ảnh, giọng nói, nhạc của HeyGen; hai skill /reverse-any-video và /style-sampling) cần gói Pro của HyperFrames. Chi phí cụ thể bạn xem ở trang giá của dự án.
Ngoài CLI, README còn có ứng dụng desktop cho macOS, Windows và Linux (.deb). Link tải nằm trên trang repo và trang chủ dự án.
Các tính năng dùng mô hình của HeyGen thuộc gói Pro. Trước khi bấm dùng, hãy đọc kỹ gói giá để tránh phát sinh chi phí ngoài ý muốn.
III.Cài đặt từng bước
Có hai đường: nhờ AI agent, hoặc tự gõ lệnh CLI. Phần dưới đi qua cả hai.
- Kiểm tra Node và FFmpegCần Node.js 22+ và FFmpeg trên máy
- Cài skill cho agentDùng plugin Claude Code hoặc npx skills / hyperframes skills update
- Tạo dự ánChạy npx hyperframes init để tạo thư mục video
- Xem trướcChạy npx hyperframes preview để mở trình duyệt
- Render ra MP4Chạy npx hyperframes render
A.Kiểm tra Node.js và FFmpeg
README yêu cầu Node.js 22+ và FFmpeg. README không ghi cách cài hai thứ này, nên bạn cài theo hướng dẫn chính thức của từng công cụ. Để kiểm tra đã có chưa, mở terminal (trên Windows là PowerShell) và gõ:
node --version
ffmpeg -versionNếu máy báo không tìm thấy lệnh, nghĩa là bạn chưa cài hoặc chưa thêm vào PATH. Nếu Node cũ hơn 22, hãy nâng phiên bản trước khi làm tiếp.
B.Cài cho Claude Code (plugin)
Với Claude Code, README hướng dẫn cài plugin có đánh phiên bản. Chạy hai lệnh này trong terminal:
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframesLệnh đầu thêm kho plugin của HyperFrames. Lệnh sau cài plugin. Muốn bật tự cập nhật, bạn chạy claude trong thư mục dự án, gõ /plugin, chọn Marketplaces rồi hyperframes rồi Enable auto-update. Sau đó gọi skill bằng /hyperframes:hyperframes.
C.Cài skill rời (Codex, Cursor, OpenCode và các agent khác)
Với skill rời, README dùng lệnh sau:
npx skills add heygen-com/hyperframesBảng chọn sẽ mở ra mà không chọn sẵn mục nào. Bạn chỉ cần chọn nhóm Core Skills. Ba skill còn lại là /slideshow, /remotion-to-hyperframes và /figma sẽ cài khi cần.
Nếu chạy trong script hoặc CI (không có bảng chọn), dùng lệnh dưới. Lệnh này cài đúng bộ core:
npx hyperframes skills updateREADME nói lệnh này lấy skill từ bản phát hành khớp với phiên bản CLI của bạn, nên skill luôn khớp với CLI. Muốn cài cả 9 skill đã phát hành, dùng skills add --all. Muốn cài từng skill, dùng --skill <tên> với tên trần, không có dấu gạch chéo đầu.
npx skills add heygen-com/hyperframes --all
npx skills add heygen-com/hyperframes --skill <name>Lưu ý: hãy chạy lệnh cài trong thư mục dự án video của bạn. README cảnh báo nếu bạn đang đứng trong bản checkout của HyperFrames thì nên dùng npx hyperframes skills update để cài toàn cục, tránh ghi đè lên chỉnh sửa chưa lưu.
D.Tự làm bằng CLI
Đường này không cần AI agent. Mở terminal ở nơi bạn muốn đặt dự án rồi chạy:
npx hyperframes init my-video
cd my-video
npx hyperframes preview # preview in browser with live reload
npx hyperframes render # render to MP4init tạo thư mục my-video với dự án mẫu. cd my-video đưa terminal vào thư mục đó, bước này nhiều người quên. preview mở trình duyệt xem trước và tự nạp lại khi bạn sửa file. render xuất ra file MP4.
README cũng cho biết npx hyperframes init sẽ tự cài bộ core skill nếu máy chưa có, và không đụng đến skill bạn đã cài.
IV.Kiểm tra đã chạy được chưa
README không đưa ra một lệnh 'kiểm tra' riêng. Cách đơn giản và đúng với quy trình trong tư liệu là chạy thử cả vòng:
- Chạy
npx hyperframes init my-videovàcd my-video. Thư mục dự án được tạo là dấu hiệu đầu tiên. - Chạy
npx hyperframes preview. Nếu trình duyệt mở ra và bạn thấy video mẫu chạy được, phần xem trước đã ổn. - Chạy
npx hyperframes render. Nếu ra được file MP4 mở xem được, FFmpeg và trình render đã hoạt động.
Với agent, bạn thử gọi skill (ví dụ /hyperframes) rồi nhờ làm một video ngắn. Nếu agent nhận ra skill và làm theo quy trình xem trước, render, nghĩa là bạn cài đúng.
V.Dùng vào việc thật
A.Chủ shop làm video giới thiệu sản phẩm
Chị Lan bán đồ gia dụng online và cần một video 10 giây để đăng đầu trang. Chị không biết HTML nên nhờ Claude Code. Sau khi cài skill, trong thư mục dự án chị gõ đúng câu mẫu của README:
Using /hyperframes, create a 10-second product intro with a fade-in title, a background video, and subtle background music.Bạn có thể viết bằng tiếng Việt, kèm tên sản phẩm và màu thương hiệu. Agent sẽ lập kế hoạch, viết HTML, xem trước và render. Kết quả là một file MP4 ngắn có tiêu đề hiện dần, video nền và nhạc nhẹ. Chị xem trước bằng npx hyperframes preview và yêu cầu agent chỉnh nếu chưa ưng.
Bạn mô tả video bằng lời, phần còn lại để máy lo từ HTML đến MP4.
Ông T
B.Nhân viên văn phòng thêm biểu đồ vào video báo cáo
Anh Hùng làm marketing, cần video ngắn có biểu đồ số liệu cho buổi họp. Thay vì tự dựng biểu đồ, anh lấy khối có sẵn trong catalog:
npx hyperframes add data-chart # animated chartLệnh này cài khối biểu đồ động về dự án dưới dạng mã nguồn sửa được. Anh mở file, thay số liệu của mình, rồi chạy preview để xem và render để xuất MP4. Cách tương tự dùng được với chuyển cảnh (flash-through-white) hay lớp phủ mạng xã hội (instagram-follow).
C.Lập trình viên làm video cho Pull Request
Chị Mai là dev, muốn giải thích một PR cho cả nhóm. README liệt kê ngay một ví dụ là PR walkthrough với animated code diff, lời dẫn và phụ đề. Chị đưa PR cho agent đã cài skill, nhờ dựng video hướng dẫn, rồi render ra MP4 để gửi vào kênh chat. Vì kết quả lặp lại được, bạn có thể đưa bước này vào CI để mỗi PR tự có video đi kèm.
D.Làm video mạng xã hội có phụ đề chuyển động
Bạn quản lý kênh nội dung và cần video dọc có chữ chạy theo lời nói, kèm nhạc nền. README liệt kê loại video này trong phần 'What You Can Build' (social videos với kinetic captions, overlay và nhạc). Skill /hyperframes có tài liệu về phụ đề và lớp phủ, còn /media-use hỗ trợ lấy hoặc tạo nhạc, hiệu ứng âm thanh, giọng đọc, bản ghi lời thoại. Bạn mô tả video cần làm, agent sẽ chọn khối phù hợp trong catalog và dựng.
VI.Lỗi hay gặp và cách xử lý
A.Lỗi do Node.js hoặc FFmpeg thiếu
Nếu lệnh npx hyperframes ... báo lỗi ngay, hoặc render không ra file, hãy kiểm tra lại bằng node --version và ffmpeg -version. Yêu cầu là Node.js 22+ và FFmpeg. Cài hoặc nâng cấp rồi mở lại terminal.
B.Agent không nhận ra skill
Nếu gõ /hyperframes mà agent không phản hồi đúng, có thể skill chưa cài hoặc đã cũ. Chạy lại npx hyperframes skills update trong thư mục dự án. README lưu ý lệnh skills add lấy từ kho skills.sh và có thể chậm hơn nhánh main vài giờ, còn skills update khớp với phiên bản CLI của bạn.
C.Chạy lệnh cài skill trong thư mục sai
Cài skill theo kiểu project-local nên chạy trong thư mục dự án video của bạn. Nếu bạn đang đứng trong bản checkout của HyperFrames, README khuyên dùng npx hyperframes skills update để cài toàn cục, vì cài cục bộ có thể ghi đè lên chỉnh sửa chưa lưu. Hãy sao lưu hoặc commit trước khi thử.
D.Animation không chạy hoặc đứng hình khi render
HyperFrames chụp từng khung bằng cách tua đến đúng thời điểm, nên animation phải tua được. Theo ví dụ trong README, timeline GSAP cần tạo ở trạng thái paused: true và được gán vào window.__timelines. Nếu bạn tự viết HTML mà quên hai điều này, video có thể không có chuyển động. Cách an toàn là để agent viết, rồi dùng preview kiểm tra trước khi render.
E.Ví dụ có GSAP không hiện khi mất mạng
Ví dụ trong README tải GSAP từ một địa chỉ CDN trên mạng. Nếu máy đang offline hoặc bị chặn, hiệu ứng có thể không chạy. README chưa nói cách dùng GSAP offline, nên nếu cần bạn xem mục tài liệu trên trang chủ dự án.
VII.Có nên dùng không
Điểm mạnh. Bạn dùng HTML thuần, không cần học một công cụ dựng riêng. Không có bước build, giấy phép Apache-2.0 và không có phí theo lượt render. Kết quả lặp lại được nên hợp với tự động hoá. Skill giúp AI agent làm đúng quy trình, và catalog có hàng trăm khối làm sẵn.
Giới hạn. Bạn vẫn cần cài Node.js 22+ và FFmpeg, và cần dùng terminal. README ghi Studio ở trạng thái 'Available, evolving' nên có thể còn thay đổi. Skill /reverse-any-video và /style-sampling thuộc HyperFrames Pro. Skill /slideshow cho ra bộ trình chiếu chứ không phải file MP4. README cũng không nêu yêu cầu cụ thể về cấu hình máy, nên máy yếu có chạy mượt không thì bạn nên thử một video ngắn trước.
Khi nào chọn cách khác. Nếu bạn chỉ cần chỉnh sửa nhanh một đoạn quay có sẵn bằng kéo thả, một phần mềm dựng video thông thường sẽ dễ hơn. Nếu nhóm bạn đã xây mọi thứ bằng React và muốn giữ nguyên, Remotion là lựa chọn đáng cân nhắc, và README cũng có skill /remotion-to-hyperframes để chuyển dự án sang nếu sau này bạn muốn. Còn nếu bạn muốn nói một câu rồi nhận video, hoặc cần tạo nhiều video theo cùng một khuôn, HyperFrames rất đáng thử.
Câu hỏi thường gặp
HyperFrames có miễn phí không?
Có. README ghi HyperFrames là framework mã nguồn mở, miễn phí, giấy phép Apache 2.0, không có phí theo lượt render hay ngưỡng thương mại. Ứng dụng Studio cũng dùng miễn phí, còn gói Pro của Studio có thêm các mô hình video, ảnh, giọng nói và nhạc của HeyGen. Giá cụ thể bạn xem trên trang giá của dự án.
Cần cài những gì để chạy HyperFrames?
Theo README, nếu dùng CLI bạn cần Node.js 22 trở lên và FFmpeg. Nếu muốn nhờ AI agent, bạn cần thêm một agent hỗ trợ skill như Claude Code, Codex, Cursor hoặc Gemini CLI. Tư liệu chưa nêu yêu cầu bắt buộc về GPU.
Tôi không biết lập trình thì dùng được không?
Được, nếu bạn dùng cùng AI agent. Bạn cài skill, rồi mô tả video bằng lời, ví dụ một video giới thiệu sản phẩm dài 10 giây, và agent sẽ viết HTML và render. Bạn vẫn cần gõ vài lệnh trong terminal để cài đặt.
HyperFrames khác Remotion ở điểm nào?
README nói cả hai đều render video bằng Chrome không giao diện và FFmpeg. Remotion dùng React và cần bundler, còn HyperFrames dùng HTML, CSS cùng animation tua được, và một file index.html có thể chạy ngay không cần bước build. Repo còn có skill để chuyển từ Remotion sang HyperFrames.
Có chạy được trên Windows không?
README có link tải ứng dụng desktop cho macOS, Windows và Linux (.deb). Về việc dùng CLI trên Windows, tư liệu chỉ nêu yêu cầu Node.js 22+ và FFmpeg, chưa có mục riêng cho Windows.
Video render xong có giống nhau mỗi lần không?
Có, đó là một mục tiêu thiết kế. README nói HyperFrames có tính xác định (deterministic): cùng đầu vào cho cùng khung hình và cùng video, nên hợp với CI, kiểm thử hồi quy và quy trình tự động.
Có thể render trên đám mây không?
Có. README liệt kê render qua AWS Lambda, cho phép triển khai một hệ render phân tán và điều khiển từ máy bạn hoặc CI. Bạn cũng có thể render cục bộ hoặc trong Docker. Chi tiết cách thiết lập bạn xem trong tài liệu của dự án.


