AIEV: tự chạy công cụ dựng video AI với Claude Code hoặc Antigravity

Bạn có một video nói chuyện và muốn thêm phụ đề karaoke, chữ chuyển động, hình minh họa rồi xuất thành clip để xem lại? AIEV (AI Edit Video) của noti.vn gom các bước đó vào một dashboard chạy trên máy. Bạn đưa video và yêu cầu dựng; Claude điều phối việc xử lý, còn bạn xem bản nháp và chỉnh trước khi xuất MP4.

Người đã dùng Claude Code hoặc Antigravity có thể nhờ AI tải mã nguồn và hỗ trợ thiết lập. Repo có sẵn file khởi động cho ba hệ điều hành. Tuy vậy, tải xong repo chưa đồng nghĩa đã đủ tài khoản AI và công cụ để dựng video. Bài này hướng dẫn cách bắt đầu và những phần cần kiểm tra trước lần dựng đầu tiên.

Mở repo AIEV và hướng dẫn cài đặt

AIEV làm được gì?

AIEV phù hợp với người làm nội dung muốn thử một quy trình dựng video có thể sửa bằng lời nhắc. Theo tài liệu dự án, các luồng chính gồm:

• Dựng từ video có sẵn: thêm phụ đề karaoke, nhấn từ khóa, chữ động, cảnh minh họa và hiệu ứng âm thanh; xem và sửa trên timeline.
• Cắt video dài thành clip ngắn: chia theo thời gian, đoạn nổi bật do AI đề xuất hoặc yêu cầu của bạn.
• Từ văn bản thành video: xử lý nội dung, viết kịch bản lời đọc, tạo giọng rồi dựng thành dự án video.
• Dịch video: lấy lời thoại, dịch và tạo phụ đề, lồng tiếng hoặc kết hợp cả hai.
• Tạo poster và thumbnail: dùng hình nền với lớp chữ, số liệu và nhận diện được dựng riêng.

Các tính năng này phụ thuộc thành phần và dịch vụ đã cấu hình. Chẳng hạn, nhận dạng lời nói cần faster-whisper; giọng Việt offline dùng VieNeu-TTS; các tính năng Gemini cần kết nối tương ứng. Không nên bật tất cả ở lần thử đầu tiên.

Claude Code và Antigravity đóng vai trò nào?

Ở bước cài đặt, bạn dùng trợ lý lập trình để đọc tài liệu, tải repo, kiểm tra công cụ và chạy script đúng hệ điều hành. Nếu trợ lý có quyền thao tác terminal và thư mục dự án, nó có thể hỗ trợ các bước này.

Bên trong AIEV, Claude là AI điều phối dựng video. HyperFrames tạo cảnh đồ họa chuyển động bằng HTML và GSAP; Remotion ghép cảnh, video, âm thanh và phụ đề thành timeline để xuất. Dùng Antigravity để cài repo không thay thế yêu cầu xác thực Claude của ứng dụng. Tài liệu AIEV cũng lưu ý gói Antigravity không thay cho Gemini API key.

Sơ đồ biên tập từ tài liệu AIEV; không phải ảnh chụp giao diện hoặc kết quả chạy thử.

Chuẩn bị trước khi chạy

Bạn cần Git nếu dùng cách clone repo. Ngoài ra, kiểm tra các thành phần sau:

Thành phần	Cần chuẩn bị
Node.js	Nhánh 24 LTS với phiên bản đáp ứng package.json; bản được kiểm tra yêu cầu từ 24.22.1 trong nhánh 24. Đọc lại yêu cầu khi tải phiên bản mới.
FFmpeg và Google Chrome	Dùng cho xử lý âm thanh, video và kết xuất cảnh. Script kiểm tra môi trường có thể đề nghị cài.
Claude	Đăng nhập Claude Code trên máy chạy AIEV hoặc cấu hình ANTHROPIC_API_KEY theo tài liệu.
Gemini	Cấu hình key khi dùng tính năng cần Gemini. Giữ key trong cấu hình riêng của ứng dụng.
Python	Bản 3.11–3.14 cho phụ đề và giọng offline; gateway ảnh tùy chọn yêu cầu 3.13 hoặc 3.14 theo README.
GPU	Tùy chọn để tăng tốc một số công đoạn; không phải mọi bước đều chạy trên GPU.

Các thư viện, môi trường Python và model có thể chiếm nhiều GB. Thời gian cài và dựng phụ thuộc mạng, cấu hình máy, độ dài video và dịch vụ AI. Dashboard mở được cũng chưa chứng minh các tính năng dựng đã đủ điều kiện hoạt động.

Tạo thư mục và nhờ AI tải repo

Tạo một thư mục riêng, chẳng hạn AIEV-workspace, rồi mở hoặc thêm thư mục đó vào Claude Code hay Antigravity theo giao diện bạn đang dùng. Sau đó gửi lời nhắc sau. Đây là mẫu để điều chỉnh theo máy của bạn:

Hãy tải repo AIEV từ địa chỉ GitHub tôi vừa cung cấp
vào thư mục AIEVv2 bên trong workspace này.
Đọc README.vi.md, package.json và script trong thư mục start.
Kiểm tra hệ điều hành, Git và phiên bản Node.js.
Cho tôi biết những thành phần còn thiếu, rồi hỗ trợ thiết lập
theo tài liệu repo và chạy đúng script khởi động.
Để tôi tự đăng nhập Claude và nhập các API key cần thiết.
Không in key hoặc token vào nội dung trả lời.

Lấy địa chỉ repo qua trang GitHub của AIEV. Nếu AI đã tạo thư mục con AIEVv2, các bước tiếp theo thực hiện trong thư mục con đó. Nếu clone lỗi, kiểm tra Git và kết nối mạng trước khi thử lại; tránh tạo nhiều bản repo mà không biết đang chạy bản nào.

Chạy file start đúng hệ điều hành

Mở thư mục AIEVv2, vào start rồi dùng file tương ứng:

Hệ điều hành	Khởi động	Dừng ứng dụng
Windows	Nhấp đúp start\start.bat	start\stop.bat
macOS	Mở start/start.command	start/stop.command
Linux	Chạy ./start/start.sh	./start/stop.sh

Lần đầu, script kiểm tra môi trường, đề nghị cài thành phần hỗ trợ, cài thư viện dự án và build. Đọc các thông báo trong cửa sổ terminal; một số bước vẫn cần bạn cài Node.js, chọn Python phù hợp hoặc đăng nhập tài khoản.

Theo README, sau khi khởi động thành công, dashboard mở tại http://localhost:6868. Nếu không tự mở, nhập địa chỉ đó vào trình duyệt. Khi dùng bản ZIP trên macOS hoặc Linux, làm bước cấp quyền chạy script theo README trước.

Trong dashboard, mở Settings / Cấu hình để xem kiểm tra hệ thống và Connections / Kết nối để cấu hình dịch vụ. Đăng nhập Claude bằng luồng claude rồi /login trên máy chạy ứng dụng, hoặc dùng cách API key được tài liệu hướng dẫn. Mỗi trang còn có nút Guide để đọc hướng dẫn đúng tính năng.

Đọc README tiếng Việt và cách xử lý môi trường

Dựng thử bằng một clip ngắn

Chọn một clip của chính bạn, có lời thoại rõ, dài khoảng 20–30 giây để dễ kiểm tra. Đây là bài tập gợi ý, không phải giới hạn thời lượng của AIEV.

1. Vào Videos Project, tạo dự án và chọn khổ hình. Dùng 9:16 nếu muốn thử clip dọc, hoặc 16:9 cho video ngang.
2. Thêm video trong Sources & Assets. Bắt đầu bằng tệp có sẵn trên máy.
3. Điền brief: giữ nội dung nào, đoạn nào cần nhấn, có phụ đề hay không. Tắt ảnh AI, nhạc và các phần chưa cần ở lần thử đầu.
4. Chọn Start editing with AI và theo dõi tiến độ. Nếu thiếu thành phần hoặc xác thực, xử lý thông báo trước khi chạy lại.
5. Xem bản nháp, sửa trên timeline hoặc yêu cầu trong chat. Chỉ render bản cuối khi đã đọc lại phụ đề, tên riêng và số liệu.

Bạn có thể bắt đầu bằng brief:

Dựng clip dọc 9:16 từ video này.
Giữ đúng ý chính, thêm phụ đề karaoke tiếng Việt dễ đọc.
Chỉ nhấn những từ khóa có trong lời thoại.
Không thêm ảnh AI hoặc nhạc ở bản thử đầu.
Tạo bản nháp để tôi xem trước khi xuất bản cuối.

Theo tài liệu, MP4 hoàn chỉnh được lưu trong outputs/ của dự án AIEV. Mở tệp và xem hết trước khi chia sẻ: phụ đề có khớp lời, âm lượng có ổn, chữ có bị che hoặc sát mép và đoạn kết có bị cắt hay không.

Chi phí, quyền sử dụng và truy cập từ xa

Mã nguồn chính của AIEV dùng giấy phép MIT, nhưng tự chạy không có nghĩa toàn bộ quá trình miễn phí. Bạn cần tài khoản hoặc hạn mức phù hợp cho Claude; các lượt gọi Gemini và dịch vụ khác có thể tính phí riêng. Bài này hướng dẫn theo tài liệu và mã nguồn, chưa đo chi phí hay chất lượng đầu ra bằng một lượt dựng thực tế.

Remotion có giấy phép riêng: tài liệu chính thức cho phép cá nhân và công ty tối đa ba người dùng miễn phí theo điều kiện của họ; tổ chức lớn hơn cần kiểm tra Company License và trường hợp dùng Player hoặc công cụ tự động hóa. Các gateway ảnh tùy chọn trong repo cũng có giấy phép và điều khoản dịch vụ riêng.

Không dùng mặc định bộ sound effect đi kèm cho video thương mại. README cho biết nguồn cấp phép của bộ này chưa được xác định đầy đủ. Hãy thay bằng âm thanh có quyền sử dụng rõ ràng; kiểm tra riêng nhạc, logo và tư liệu bạn đưa vào.

Dashboard AIEV hiện không có đăng nhập theo cảnh báo của dự án. Nếu chỉ thử trên máy, giữ luồng local. Khi cần mở ra Internet bằng tunnel, phải có lớp kiểm soát truy cập như Cloudflare Access theo hướng dẫn của repo; không chia sẻ công khai dashboard.

Khi gặp lỗi và khi cần cập nhật

• Không tìm thấy Node hoặc báo phiên bản không phù hợp: cài bản đáp ứng package.json, mở lại terminal rồi chạy lại start.
• Dashboard lên nhưng AI hoặc render thất bại: xem System check, trạng thái Claude, FFmpeg và Chrome. Kiểm tra riêng key và hạn mức của tính năng đang dùng.
• Lần cài đầu bị ngắt: đọc lỗi cuối trong terminal, nhờ AI kiểm tra dependencies còn thiếu và chạy lại theo tài liệu; giữ nguyên dự án và tệp nguồn.
• Muốn cập nhật: dùng thông báo cập nhật ở sidebar hoặc script trong thư mục update. Sao lưu dự án, cấu hình và tài sản riêng trước khi cập nhật; README phân biệt kênh Stable và Latest.

Khi đã dựng thành công một clip đơn giản, bật thêm từng tính năng và so sánh bản nháp. Cách này giúp bạn biết phần nào cải thiện video, phần nào làm tăng thời gian hoặc chi phí.