Bỏ qua tới nội dung
Ông T.vn

HyperFrames: viết HTML là ra video MP4, dành cho AI agent — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

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 →

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ở của HeyGen, cho phép bạn viết video bằng HTML rồi render ra MP4 bằng headless Chrome và FFmpeg. Bạn có thể tự gõ lệnh CLI hoặc cài skill để Claude Code, Codex, Cursor làm video theo yêu cầu. Cài khá nhanh nếu đã có Node.js 22+ và FFmpeg.

HyperFrames là một framework mã nguồn mở, miễn phí, giúp bạn biến HTML, CSS, file media và các animation có thể tua (seekable) thành video MP4. Mỗi lần render cùng một đầu vào sẽ ra đúng cùng một video. Tác giả tóm tắt bằng một câu: viết HTML, render video, xây dựng cho agent.

Repo này hợp với ba nhóm người. Nhóm một là lập trình viên đã quen HTML và CSS, muốn làm video mà không phải học một công cụ dựng phim riêng. Nhóm hai là người làm marketing, kinh doanh, văn phòng đang dùng Claude Code, Codex hay Cursor và muốn nói một câu là có video giới thiệu sản phẩm. Nhóm ba là đội làm nội dung tự động, cần render hàng loạt và kết quả ổn định.

Điểm đáng giá nhất là hướng đi “agent làm video”. HyperFrames có sẵn bộ skill dạy AI agent quy trình làm video: lên kế hoạch, viết HTML hợp lệ, gắn animation, thêm media, kiểm tra, xem thử rồi render. Repo hiện có khoảng 83.600 sao và khoảng 7.700 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây.

Framework

heygen-com/hyperframes

HyperFrames biến HTML, CSS và animation thành video MP4 giống hệt nhau mỗi lần render; dùng qua CLI hoặc nhờ AI agent như Claude Code làm giúp.

★ 84kTypeScriptApache-2.0
Xem repo trên GitHub

I.HyperFrames làm được gì

Dưới đây là những tính năng chính, giải thích theo lợi ích bạn nhận được.

  • Video viết bằng HTML. Một video là một file HTML có các thuộc tính dữ liệu để đặt thời gian bắt đầu, độ dài và lớp (track). Bạn không cần học định dạng timeline riêng, cũng không bắt buộc dùng React.
  • Không cần bước build. File index.html chạy được ngay và xem trực tiếp trên trình duyệt. Sửa xong là thấy kết quả.
  • Kết quả lặp lại được. Trình render tua từng khung hình trong Chrome không giao diện (headless), rồi mã hoá bằng FFmpeg. Cùng đầu vào cho ra cùng video, rất hợp để chạy tự động hoặc kiểm thử.
  • Dùng nhiều thư viện animation. Bạn có thể dùng GSAP, CSS, Lottie, Three.js, Anime.js, WAAPI, hoặc tự viết bộ chuyển (adapter) riêng.
  • Kho khối dựng sẵn (catalog). Có khoảng 450 khối và thành phần làm sẵn như hiệu ứng chuyển cảnh, lớp phủ mạng xã hội, tiêu đề, chữ chuyển động, phụ đề, biểu đồ, bản đồ, 3D. Chúng được cài về dưới dạng mã nguồn để bạn sửa tiếp.
  • Bộ skill cho AI agent. Repo có 9 skill được công bố. Nhóm cốt lõi gồm /hyperframes, /hyperframes-cli, /hyperframes-registry, /media-use, /reverse-any-video và /style-sampling. Ba skill cài khi cần là /figma, /slideshow và /remotion-to-hyperframes.
  • frame.md. Đây là lớp “dịch” design system của thương hiệu sang dạng video, để agent dựng video đúng màu sắc, quy tắc mà không phải đoán.
  • Nhiều cách dùng. CLI trên máy, Studio để xem và sửa trên trình duyệt, ứng dụng desktop (macOS, Windows, Linux .deb), và render phân tán trên AWS Lambda.
  • Không tính phí theo lần render. README nêu rõ giấy phép Apache 2.0, không phí mỗi lần render và không có ngưỡng thương mại.

Lưu ý: skill /reverse-any-video và /style-sampling được README ghi là thuộc HyperFrames Pro. Bản app Studio miễn phí, còn gói Pro bổ sung các mô hình video, ảnh, giọng nói và nhạc của HeyGen.

II.Cần chuẩn bị gì

Theo README, nếu dùng CLI thủ công bạn cần:

  • Node.js bản 22 trở lên.
  • FFmpeg cài sẵn trên máy. README chỉ ghi “FFmpeg” trong phần yêu cầu, không hướng dẫn cách cài. Bạn xem thêm ở trang tài liệu của dự án: hyperframes.heygen.com.

Nếu dùng qua AI agent, bạn cần thêm một agent hỗ trợ skill như Claude Code, Codex, Cursor, Gemini CLI, IBM Bob hoặc OpenCode, kèm tài khoản của agent đó.

Về hệ điều hành, README có bản tải app desktop cho macOS, Windows và Linux (.deb). Phần CLI không nêu riêng hệ điều hành nào ngoài hai yêu cầu ở trên. Về GPU hay cấu hình phần cứng, tư liệu không nói gì.

Trong README, các skill của gói Pro và các mô hình tạo video, ảnh, giọng, nhạc của HeyGen thuộc gói Pro của Studio, có thể phát sinh phí. Bản framework và CLI thì miễn phí. Trước khi dùng tính năng tạo media bằng HeyGen, bạn nên xem trang giá để biết chi phí.

III.Cài đặt từng bước

Có hai đường: nhờ AI agent (dễ nhất cho người không rành code) hoặc gõ lệnh CLI thủ công. Mình tóm tắt như sau.

  1. Kiểm tra môi trườngCần Node.js 22+ và FFmpeg
  2. Cài plugin hoặc skillCho Claude Code dùng plugin, hoặc cài skill độc lập bằng npx
  3. Tạo dự ánChạy init để có thư mục video mẫu
  4. Xem thửChạy preview để mở trình duyệt, có tải lại tự động
  5. RenderChạy render để xuất file MP4

A.Chuẩn bị Node.js và FFmpeg

Bạn cần Node.js 22 trở lên và FFmpeg. README chưa ghi cách cài hai thứ này, nên bạn xem hướng dẫn trên trang dự án hoặc trang chính thức của từng công cụ. Mở terminal (PowerShell trên Windows, Terminal trên macOS) rồi kiểm tra Node đã có chưa:

Terminal
node --version

Nếu ra số bản từ 22 trở lên là ổn. Chỗ người mới hay vấp là cài FFmpeg xong nhưng chưa mở lại terminal, nên máy chưa nhận lệnh.

B.Cách 1: cài plugin cho Claude Code

Mở terminal ở bất kỳ đâu và chạy hai lệnh theo README. Lệnh đầu thêm “chợ” plugin của HyperFrames, lệnh sau cài plugin:

Terminal
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes

Muốn bật tự cập nhật, bạn chạy claude trong terminal ở thư mục dự án. Trong giao diện của Claude Code, gõ /plugin, chọn Marketplaces, chọn hyperframes, rồi chọn Enable auto-update. Sau đó bạn gọi skill bằng /hyperframes:hyperframes.

C.Cách 2: cài skill độc lập (Codex, Cursor, OpenCode…)

Lệnh sau mở một bảng chọn skill. Bảng này không chọn sẵn mục nào. Bạn chỉ cần nhóm Core Skills:

Terminal
npx skills add heygen-com/hyperframes

Nếu muốn cài không cần bảng chọn (ví dụ trong script), README hướng dẫn dùng lệnh này để cài đúng bộ cốt lõi:

Terminal
npx hyperframes skills update

README còn nêu hai biến thể: npx skills add heygen-com/hyperframes --all để cài đủ 9 skill, và npx skills add heygen-com/hyperframes --skill <tên> để cài đúng một skill (tên trần, không có dấu gạch chéo đầu). Skill /figma, /slideshow, /remotion-to-hyperframes cài khi cần bằng npx hyperframes skills update <tên>.

Lưu ý: hãy chạy bản cài trong thư mục dự án video của bạn. README giải thích lệnh skills update lấy skill đúng với phiên bản CLI đang dùng, nên ít lệch hơn so với skills add, vốn có thể chậm hơn nhánh chính vài giờ.

D.Cách 3: tạo dự án bằng CLI

Ba lệnh đầu dưới đây tạo dự án tên my-video, đi vào thư mục đó, rồi mở bản xem thử. Hai dòng chú thích sau dấu # là của README:

Terminal
npx hyperframes init my-video
cd my-video
npx hyperframes preview      # preview in browser with live reload
npx hyperframes render       # render to MP4

preview mở trình duyệt và tự tải lại khi bạn sửa file. render xuất ra MP4. Nếu lệnh npx báo lỗi, hãy kiểm tra lại phiên bản Node trước.

IV.Kiểm tra đã chạy được chưa

Cách kiểm tra đơn giản nhất là đi hết ba lệnh của dự án mẫu. Chạy npx hyperframes init my-video, vào thư mục, chạy npx hyperframes preview. Nếu trình duyệt mở ra và bạn thấy composition phát được, phần xem thử đã ổn. Sau đó chạy npx hyperframes render. Thành công khi bạn có một file MP4 mở xem được bằng trình phát video thông thường. README không mô tả chính xác tên thư mục hay chữ báo kết quả, nên bạn xem thông báo trong terminal để biết file nằm ở đâu.

Với cách dùng qua agent, mở Claude Code và gọi /hyperframes:hyperframes. Nếu agent nhận lệnh và bắt đầu lên kế hoạch video, plugin đã hoạt động. Với skill độc lập, bạn gọi /hyperframes trong agent của mình.

V.Dùng vào việc thật

Mấy tình huống dưới đây bám đúng khả năng mà README nêu.

A.Chủ shop làm video giới thiệu sản phẩm

Bạn bán hàng online và cần video 10 giây để đăng quảng cáo. Bạn không rành code nhưng đã dùng Claude Code. Sau khi cài plugin, bạn mở thư mục dự án và nhập prompt mẫu theo README:

text
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, ví dụ “làm video giới thiệu sản phẩm dài 10 giây, tiêu đề hiện dần, có video nền và nhạc nền nhẹ”. Agent sẽ lên kế hoạch, viết HTML, thêm media, kiểm tra rồi cho bạn xem thử. Kết quả là một file MP4 ngắn. Bạn đọc qua nội dung, chỉnh lời nhắn rồi yêu cầu agent sửa tiếp.

B.Nhân viên văn phòng cần biểu đồ động cho báo cáo

Bạn cần một biểu đồ chuyển động để chèn vào buổi họp. Catalog có sẵn khối biểu đồ, bạn cài bằng lệnh trong README:

Terminal
npx hyperframes add data-chart            # animated chart

Lệnh này cài khối data-chart về dự án dưới dạng mã nguồn. Bạn nhờ agent đổi số liệu và màu theo thương hiệu, rồi render. Khối flash-through-white (chuyển cảnh) và instagram-follow (lớp phủ mạng xã hội) cũng cài theo cách tương tự.

Cùng một đầu vào thì ra cùng một video, nên bạn sửa một chữ cũng không sợ cả đoạn phim bị lệch.

Ông T

C.Lập trình viên làm video tự động trong quy trình CI

Bạn có một kho mã và muốn tự sinh video tóm tắt mỗi lần có thay đổi. README nêu các hướng như PR walkthrough với diff code động, docs-to-video và nội dung tự động. Vì CLI mặc định không hỏi lại (non-interactive) và kết quả lặp lại được, bạn gọi npx hyperframes render trong script. README cũng nói có thể render trong Docker hoặc dùng AWS Lambda để render phân tán. Cách cấu hình chi tiết bạn xem ở tài liệu dự án.

D.Người làm nội dung chuyển video cũ sang HTML

Bạn có sẵn dự án video bằng Remotion hoặc công cụ khác. Skill /remotion-to-hyperframes được README mô tả là để đưa mã hoặc footage hiện có sang HyperFrames và kiểm tra từng khung hình. Cài nó bằng npx hyperframes skills update remotion-to-hyperframes rồi nhờ agent chuyển. Kết quả là một dự án HTML bạn sửa tiếp được.

VI.Lỗi hay gặp và cách xử lý

Lệnh npx báo lỗi hoặc không chạy. Thường do Node cũ hơn bản 22. Chạy node --version, nếu thấp hơn thì nâng Node lên rồi mở lại terminal.

Render báo thiếu FFmpeg. FFmpeg chưa cài hoặc chưa nằm trong đường dẫn hệ thống. Cài FFmpeg, mở lại terminal, gõ ffmpeg -version để chắc chắn máy nhận lệnh.

Agent không thấy skill /hyperframes. Có thể bạn chạy lệnh cài ở sai thư mục hoặc chưa khởi động lại agent. README khuyên chạy cài đặt trong thư mục dự án video. Bạn thử lại npx hyperframes skills update, rồi mở phiên làm việc mới.

Skill cài ra bị lệch bản so với CLI. README giải thích skills add lấy bản từ registry và có thể chậm hơn nhánh chính vài giờ. Dùng npx hyperframes skills update để lấy skill khớp với CLI đang dùng.

Cài trong thư mục mã nguồn HyperFrames làm mất chỉnh sửa. README cảnh báo khi cài cục bộ trong một bản checkout của repo, thư mục đích có thể trùng với thư mục skills/ và ghi đè phần bạn chưa lưu. Trong trường hợp này hãy dùng npx hyperframes skills update để cài toàn cục.

VII.Có nên dùng không

Điểm mạnh. HyperFrames đơn giản ở chỗ video chỉ là HTML, không cần bước build, và kết quả lặp lại được. Bộ skill và catalog giúp agent làm việc có quy trình thay vì đoán mò. Giấy phép Apache-2.0 không tính phí theo lần render. README còn so sánh với Remotion: HyperFrames đặt cược vào HTML thuần, Remotion đặt cược vào component React.

Giới hạn. Bạn vẫn cần Node.js 22+ và FFmpeg, mà README chưa hướng dẫn cài. Studio được ghi là đang phát triển (“evolving”). Một số skill và mô hình tạo media mạnh nằm trong gói Pro. Nếu bạn chỉ cần cắt ghép video quay sẵn bằng giao diện kéo thả, một phần mềm dựng phim thông thường sẽ nhanh hơn. Nếu nhóm bạn đã đầu tư sâu vào React và Remotion, bạn nên cân nhắc chi phí chuyển đổi, dù có skill hỗ trợ chuyển.

Tóm lại: nếu bạn muốn nhờ AI làm video hoặc tự động hoá việc render, HyperFrames đáng để thử. Hãy bắt đầu bằng dự án mẫu my-video để làm quen trước khi làm video thật.

4.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

HyperFrames có miễn phí không?

Framework và CLI là mã nguồn mở, giấy phép Apache-2.0, README ghi không có phí theo lần render hay ngưỡng thương mại. Ứng dụng Studio cũng dùng miễn phí. Gói Pro của Studio bổ sung các mô hình video, ảnh, giọng nói và nhạc của HeyGen và có trang giá riêng.

Cần cài những gì để chạy HyperFrames bằng CLI?

README ghi yêu cầu là Node.js 22 trở lên và FFmpeg. Sau đó bạn chạy `npx hyperframes init my-video` để tạo dự án. README chưa hướng dẫn cách cài Node hay FFmpeg, bạn xem trang tài liệu dự án.

Tôi không biết code thì dùng được không?

Được nếu bạn dùng qua AI agent như Claude Code, Codex hay Cursor. Bạn cài plugin hoặc skill, rồi mô tả video muốn làm bằng lời. Agent sẽ viết HTML và render giúp, nhưng bạn vẫn nên kiểm tra kết quả trước khi dùng.

HyperFrames khác Remotion ở đâu?

Cả hai đều render video bằng headless Chrome và FFmpeg. Theo README, Remotion viết bằng component React và cần bundler, còn HyperFrames dùng HTML thuần, CSS và animation seekable, không cần bước build. HyperFrames cũng có skill để chuyển dự án từ Remotion sang.

Chạy được trên Windows không?

README có link tải ứng dụng desktop cho macOS, Windows và Linux (.deb). Phần CLI chỉ nêu yêu cầu Node.js 22+ và FFmpeg, không liệt kê hệ điều hành cụ thể. Bạn thử với dự án mẫu để chắc chắn máy mình chạy được.

Có cần GPU không?

Tư liệu không nói đến yêu cầu GPU hay cấu hình phần cứng. Cách render được mô tả là dùng headless Chrome và FFmpeg trên máy. Nếu cần render số lượng lớn, README nói có thể dùng Docker hoặc AWS Lambda.

Hỗ trợ những AI agent nào?

README nêu Claude Code, Codex, Cursor, Gemini CLI, IBM Bob, OpenCode và các agent khác có hỗ trợ skill. Claude Code có plugin riêng, còn các agent khác dùng lệnh `npx skills add heygen-com/hyperframes` hoặc `npx hyperframes skills update`.

Chuyển nhanh tới mục

  1. I.HyperFrames làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chuẩn bị Node.js và FFmpeg
    2. B.Cách 1: cài plugin cho Claude Code
    3. C.Cách 2: cài skill độc lập (Codex, Cursor, OpenCode…)
    4. D.Cách 3: tạo dự án bằng CLI
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop làm video giới thiệu sản phẩm
    2. B.Nhân viên văn phòng cần biểu đồ động cho báo cáo
    3. C.Lập trình viên làm video tự động trong quy trình CI
    4. D.Người làm nội dung chuyển video cũ sang HTML
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.