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

> 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.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-18 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/hyperframes-viet-html-render-video-cho-ai-agent

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.

```repo
- repo | heygen-com/hyperframes
- kind | Framework
- desc | 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.
- stars | 84k
- lang | TypeScript
- license | Apache-2.0
```

## 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.

## 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ì.

```note
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í.
```

## 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.

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

### 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:

```bash
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.

### 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:

```bash
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á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**:

```bash
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:

```bash
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ờ.

### 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:

```bash
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.

## 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.

## 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.

### 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.

### 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:

```bash
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

### 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.

### 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.

## 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.

## 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.

## 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`.
