💡 Bạn cần tài liệu chuyên sâu? Bản README này tóm tắt nhanh để bạn có thể bắt đầu tạo video trong 5 phút. Để xem đầy đủ kiến trúc, JSON Schema kịch bản, bảng tính chi phí và hướng dẫn nâng cao, vui lòng xem 👉 README.full.md.

Toàn bộ video dưới đây được tạo 100% tự động từ kịch bản text — Voice TTS + Visuals HTML/CSS + Hiệu ứng SFX/BGM, không qua bước edit video thủ công:

🕸️ Demo CodeGraph	🖥️ Demo OpenScreen
📺 Xem Shorts	📺 Xem Shorts

🔗 Xem thêm tại: Facebook Reels · TikTok @cuongit96

• ⚡ Tự động hóa toàn diện: Từ URL bài báo hoặc file .txt/.md → Kịch bản → Giọng đọc (TTS) → HTML Motion Graphics → Ghép âm thanh & SFX → Render file MP4 1080x1920 60FPS.
• 🎙️ Voice miễn phí 100% (Edge TTS): Tích hợp sẵn giọng đọc tiếng Việt của Microsoft Edge, không tốn tiền, không cần API Key. Đồng thời hỗ trợ LucyLab (voice cloning tiếng Việt kèm SRT), Vbee (chuẩn giọng tin tức Việt Nam) và ElevenLabs (đa ngôn ngữ cao cấp).
• 🎨 HTML-to-Video Engine (HyperFrames): Layout video được viết bằng HTML + CSS + GSAP animation. Dễ dàng can thiệp, tuỳ biến font chữ, màu sắc thương hiệu như lập trình web.
• 🤖 Thiết kế riêng cho AI Coding Agents: Tối ưu sẵn cho Google Antigravity IDE (.agents/skills) và Claude Code (.claude/skills) qua lệnh /create-news-video. Bạn chỉ cần đưa URL bài báo hoặc file .txt, AI sẽ tự đọc hiểu, tóm tắt, chọn template đồ họa và chạy pipeline tạo video trọn gói từ A đến Z.
• 📐 6 Template dựng sẵn linh hoạt:
  • 🚨 breaking-news: Tin nóng, sự kiện giật gân
  • 📊 stat-callout: Nhấn mạnh số liệu, biểu đồ
  • 🔀 split-screen: So sánh 2 đối tượng hoặc chèn ảnh minh họa bài viết
  • 💬 quote-card: Trích dẫn phát biểu, châm ngôn
  • 📋 listicle: Danh sách điểm tin, bảng xếp hạng
  • 🔢 big-number: Số liệu thống kê ấn tượng

Dự án sử dụng cơ chế Agentic Video Generation:

• Công cụ bắt buộc: Node.js 22+ và FFmpeg trên máy.
• AI Coding Agent (Khuyên dùng để tự động hoá 100%):
  • 🪐 Antigravity IDE — AI IDE của Google DeepMind.
  • 🧠 Claude Code — Agentic CLI của Anthropic.
  • Hoặc bất kỳ AI tool nào khác (Cursor, Codex, Windsurf) thông qua kịch bản JSON.

# Clone repository
git clone https://github.com/Cuongyd196/auto-video-gen.git
cd auto-video-gen

# Cài đặt dependencies
npm install

Cài đặt FFmpeg nếu máy chưa có:

• Windows: winget install Gyan.FFmpeg
• macOS: brew install ffmpeg
• Linux: sudo apt install ffmpeg

Tạo file môi trường từ file mẫu:

cp .env.example .env.local

💡 Mặc định dự án cấu hình Edge TTS hoàn toàn miễn phí, không cần bất kỳ API key nào. Bạn có thể tạo video ngay lập tức!

(Nếu muốn dùng LucyLab, Vbee hoặc ElevenLabs, mở file .env.local và điền key tương ứng).

Mở project trong Antigravity IDE, tại khung chat gõ lệnh:

/create-news-video https://github.com/Cuongyd196/auto-compare-video

Mở terminal tại thư mục dự án và chạy:

claude
# Trong màn hình tương tác Claude Code, gõ:
/create-news-video https://github.com/Cuongyd196/auto-compare-video

💡 Quy trình AI tự động xử lý:

1. Đọc nội dung từ URL (repo GitHub, bài báo) hoặc file .txt tiếng Việt.
2. Viết lời bình tiếng Việt chuẩn ngữ âm, chia cảnh và chọn template motion graphics.
3. Tự gọi pipeline: sinh voice (Edge TTS Free) + render HyperFrames + mix nhạc & SFX.
4. Xuất video .mp4 cùng file caption.txt có sẵn hashtag đăng TikTok!

Nếu không dùng AI, bạn có thể render từ file mẫu hoặc file script.json tự viết:

npm run pipeline -- tests/fixtures/sample-script-no-image.json

🎉 Kết quả: Video thành phẩm sẽ được lưu tại output/<slug>/<slug>.mp4.

Chuyển đổi provider linh hoạt trong .env.local qua biến TTS_PROVIDER:

# Chạy toàn bộ pipeline (TTS + Render visuals + Audio Mix)
npm run pipeline -- output/<slug>/script.json

# Chỉ render lại hình ảnh (giữ nguyên voice đã tạo, tiết kiệm thời gian)
npm run rerender -- output/<slug>

# Chạy test kiểm thử toàn bộ hệ thống
npm test

auto-video-gen/
├── .claude/skills/        # Claude Code skill tạo kịch bản tự động
├── src/
│   ├── config.ts          # Đọc & validate biến môi trường (.env)
│   ├── pipeline.ts        # Pipeline chính: TTS -> HyperFrames -> FFmpeg
│   ├── schema.ts          # Zod schema định nghĩa cấu trúc kịch bản video
│   ├── render/            # Template HTML/CSS/GSAP & HyperFrames composer
│   ├── tts/               # Bộ kết nối TTS (Edge TTS, Vbee, ElevenLabs)
│   └── audio/             # Ghép âm thanh, SFX, căn chỉnh timing bằng FFmpeg
├── tests/                 # Unit tests (Vitest)
├── output/                # Thư mục lưu video thành phẩm theo từng slug
├── README.full.md         # 📖 Tài liệu hướng dẫn chi tiết toàn bộ dự án
└── README.en.md           # 🇬🇧 English Documentation

Để tìm hiểu chi tiết hơn, vui lòng xem README.full.md:

• Cấu trúc chi tiết của file kịch bản script.json
• Hướng dẫn tùy biến màu sắc, font chữ và animation CSS
• Bảng ước tính chi phí chi tiết
• Bảng tra cứu và xử lý sự cố (Troubleshooting)
• Giải đáp các câu hỏi thường gặp (FAQ)

Xem các mẫu tạo video khác tại:

• Link repo tạo video từ 1 chủ đề với Remotion: 🔗 github.com/Cuongyd196/remotion-cuongit-template
• Link tạo video so sánh kiến thức: 🔗 github.com/Cuongyd196/auto-compare-video

Mình tạo nhóm này cho các bạn trao đổi về Làm Video với AI nhé.
Với các repo mình công khai, có vướng mắc mình sẽ giải đáp cho các bạn.

• 👥 Nhóm trên Facebook: facebook.com/groups/1010029065373486
• 👥 Nhóm trên Zalo: zalo.me/g/8bfeotyh5ewtkzxmp5gt

Nếu hữu ích với các bạn thì cho mình 1 star GitHub nhé 🌟

• Dự án phát hành theo giấy phép MIT.
• Dự án là bản fork và phát triển mở rộng từ tác phẩm gốc của tác giả Ho Quang Hai.
• Bản cập nhật & duy trì bởi CuongIT.