Ưu, nhược và chỗ chưa rõ
| Ưu | Video là file HTML thường, không cần React hay bước build, nên agent viết được ngay và bạn mở file trong trình duyệt là xem được. Giấy phép Apache-2.0, không thu phí theo lượt render. | README ghi, mục Why HyperFrames? |
|---|---|---|
| Ưu | Một bài viết độc lập khen cách render cố định: cùng một file HTML luôn ra cùng một video, hợp để đưa vào CI. | yuv.ai, 10/07/2026 |
| Ưu | Khi người dùng báo skill bảo agent tự cập nhật "run silently, don't ask", HeyGen sửa trong khoảng một tháng: skill giờ phải hỏi người dùng trước khi cập nhật. | Issue #2613 |
| Nhược | CLI gửi số liệu sử dụng đến PostHog ngay từ đầu, gồm tên lệnh, thông tin máy và tên agent đang gọi (claude_code, codex, cursor). Đăng nhập HeyGen thì số liệu gắn với tài khoản của bạn. Muốn tắt: đặt HYPERFRAMES_NO_TELEMETRY=1. | docs/packages/cli.mdx, mục telemetry |
| Nhược | Render trên một máy chậm: một bài viết dẫn phép đo khoảng 3 phút cho video 30 giây 1080p, so với khoảng 25 giây trên Remotion Lambda. Cách chụp khung nhanh (BeginFrame) chỉ chạy trên Linux; macOS và Windows dùng chụp màn hình. | yuv.ai, 10/07/2026 |
| Nhược | Một trang review (do Kompozy, một sản phẩm cạnh tranh, viết) ghi HyperFrames chỉ render: không viết kịch bản, không đăng bài, mỗi khổ video phải làm riêng, và dự án còn dưới 1.0 nên đổi nhanh giữa các bản. | Kompozy review (đối thủ), 18/07/2026 |
| Chưa rõ | Đường cài plugin và npx skills add đều lấy bản mới nhất trên main, README còn hướng dẫn bật tự cập nhật; không có cách ghim commit cho skill. Chỉ CLI ghim được bằng [email protected]. | README, With an AI coding agent |
| Chưa rõ | Issue #2613 còn nêu hai điểm khác: một hàm trong media-use chạy lệnh với shell: true, và template three.js tải từ CDN không có mã kiểm tra SRI. Bản sửa chỉ nói tới phần tự cập nhật; mình chưa xác nhận hai điểm kia đã được xử lý. | Issue #2613 |
Khi nên dùng
- Bạn muốn agent làm video ngắn, intro sản phẩm hay video changelog bằng HTML và GSAP, render ra MP4 trên máy mà không trả phí theo lượt.
Khi không nên dùng
- Bạn cần render nhanh hàng loạt trên Mac hoặc Windows, đã có quy trình Remotion chạy ổn, hoặc không muốn CLI gửi số liệu sử dụng mà quên tắt.
Cách cài
Claude Code (plugin)
claude plugin marketplace add heygen-com/hyperframes && claude plugin install hyperframes@hyperframesCodex / Cursor / OpenCode (skill)
npx skills add heygen-com/hyperframesCLI
npx [email protected] init my-videoNó chạm vào những gì
- File đọc và ghi
- Ghi project video trong thư mục bạn chọn; cấu hình và ID cài đặt trong ~/.hyperframes/ (config.json, install-state.json, auto-update.log); Chrome headless trong ~/.cache/hyperframes/chrome.
- Gọi mạng
- Tải Chrome headless lần đầu; gửi số liệu sử dụng đến us.i.posthog.com (bật sẵn, tắt bằng HYPERFRAMES_NO_TELEMETRY=1 hoặc DO_NOT_TRACK=1); kiểm tra bản mới trên npm; api2.heygen.com khi bạn đăng nhập hoặc dùng media-use; cdn.jsdelivr.net trong một số template.
- Script lúc cài
- Gói npm hyperframes 0.8.216 không có postinstall. Cần Node.js 22+ và FFmpeg có sẵn.
- Tiến trình
- Chrome headless và FFmpeg khi render; server xem trước khi chạy preview; khi cài toàn cục, CLI có thể bật một tiến trình nền để tự cập nhật trong cùng major version (bỏ qua khi chạy qua npx, trong CI hoặc khi agent gọi).
Đọc từ: config.ts#L12-L16, config.ts#L620-L625, transport.ts#L10, policy.ts, autoUpdate.ts#L1-L25, manager.ts#L42-L43
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin
