OpenMontage
Mã nguồn mở bởi calesthio
OpenMontage là bộ quy trình sản xuất video cho trợ lý lập trình AI như Claude Code, Cursor, Codex. Bạn mô tả video bằng lời, trợ lý tự tìm tư liệu, viết kịch bản, tạo hình ảnh, giọng đọc, nhạc rồi dựng thành video. Dự án chạy trên máy cá nhân, mở trong trợ lý AI chứ không phải ứng dụng có giao diện riêng.
OpenMontage dùng để làm gì?
- Làm video giải thích có thuyết minh, phụ đề và nhạc nền từ một câu mô tả
- Dựng phim tài liệu ghép từ cảnh quay thật trên Archive.org, NASA, Wikimedia Commons, Pexels
- Phân tích một video mẫu (YouTube, Short, Reel, TikTok) rồi đề xuất 2–3 hướng làm video tương tự
- Cắt podcast hoặc video dài thành nhiều clip ngắn cho mạng xã hội
- Thêm phụ đề, lồng tiếng, dịch video sang ngôn ngữ khác
Giao diện
Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.
Cần biết trước khi dùng
- Lưu ýLicense AGPL-3.0: nếu sửa mã nguồn và cho người khác dùng qua mạng thì phải công bố phần đã sửa.
- Lưu ýRepo chưa có bản phát hành (release) chính thức: phiên bản cài đặt là mã mới nhất trên nhánh chính.
- Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
- Lưu ýDependency được khai báo theo khoảng phiên bản (ví dụ ">="), chưa tra lỗ hổng tự động được. Cần quét trên bản cài thật.
- Lưu ýTino chưa kiểm thử dự án này.
Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
OpenMontage là gì?
Phần lớn công cụ video AI chỉ sinh một clip từ một câu lệnh. OpenMontage tổ chức việc làm video thành quy trình nhiều bước như một nhóm sản xuất: research, đề xuất, kịch bản, phân cảnh, tạo tư liệu, dựng, ghép. Không có chương trình điều phối riêng: chính trợ lý AI của bạn đọc file hướng dẫn và điều phối.
Mỗi quy trình (pipeline) là một file YAML liệt kê các bước, công cụ và tiêu chí kiểm tra. Mỗi bước có một skill viết bằng Markdown dạy trợ lý cách làm. Phần Python cung cấp công cụ: tạo video, ảnh, giọng đọc, nhạc, trộn âm, phụ đề, phân tích khung hình. Video cuối được ghép bằng Remotion, HyperFrames hoặc FFmpeg.
Trợ lý dừng lại xin duyệt ở các điểm quyết định: đề xuất, kịch bản, phân cảnh, tư liệu đã tạo và trước khi xuất bản. Bảng Backlot chạy trên máy hiển thị tiến độ, kịch bản, từng cảnh và số tiền đã tiêu. Sau khi render, hệ thống tự kiểm tra bằng ffprobe, trích khung hình và đo mức âm thanh.
Không cần khoá API vẫn làm được video: Piper đọc thuyết minh offline, cảnh quay lấy từ kho miễn phí, Remotion dựng hình. Thêm khoá API của các dịch vụ tạo ảnh, video, giọng đọc, nhạc (fal.ai, Kling, ElevenLabs, OpenAI, Suno…) thì có thêm công cụ, nhưng phải trả phí theo dịch vụ đó.
Nên dùng khi
- Bạn đã dùng Claude Code, Cursor hoặc Codex và muốn làm video giải thích, video tài liệu mà không tự dựng tay
- Bạn cần video từ cảnh quay thật miễn phí mà không trả tiền cho mô hình tạo video
- Bạn muốn kiểm soát từng bước: duyệt kịch bản, phân cảnh, chi phí trước khi trợ lý tạo tư liệu
Không nên dùng khi
- Bạn định sửa mã rồi cung cấp như dịch vụ qua mạng cho người khác mà không muốn công khai mã: giấy phép AGPL-3.0 buộc phải công bố mã nguồn đã sửa
- Bạn chưa đặt giới hạn chi tiêu: mỗi khoá API trong .env cho phép trợ lý gọi dịch vụ trả phí; README nêu mặc định trần $10 và hỏi duyệt với lệnh trên $0,50
- Bạn không muốn trợ lý AI chạy mã Python, cài gói và tìm kiếm web trên máy mình
- Bạn định làm lại video của người khác mà chưa kiểm tra bản quyền nội dung gốc và điều khoản của nền tảng
- Máy không có Python 3.10+, Node.js 18+ và FFmpeg
Tính năng chính
- Hơn 10 quy trình: video giải thích, hoạt hình, người dẫn ảo, trailer, phim tài liệu ghép cảnh, cắt clip, lồng tiếng, podcast, quay màn hình, talking head
- Bắt đầu từ video mẫu: giữ nhịp, kiểu mở đầu, cấu trúc; đổi chủ đề, hình ảnh, giọng kể
- Bước research tìm trên web trước khi viết kịch bản và ghi nguồn
- Bảng Backlot trên máy: theo dõi tiến độ, duyệt phân cảnh, xem lại toàn bộ lượt chạy
- Chọn nhà cung cấp theo điểm 7 tiêu chí, có nhật ký quyết định
- Kiểm soát ngân sách: ước tính trước, giữ trần chi tiêu, hỏi duyệt theo ngưỡng
- Kiểm tra trước và sau render: chặn video giống trình chiếu ảnh, kiểm khung đen, âm thanh câm
- Chạy được không cần khoá API: Piper TTS, kho cảnh quay mở, Remotion, HyperFrames, FFmpeg
- Tạo video trên GPU của máy bằng WAN, Hunyuan, CogVideo, LTX-Video (tuỳ chọn)
- File hướng dẫn riêng cho Claude Code, Cursor, GitHub Copilot, Codex, Windsurf
Cách cài đặt OpenMontage
-
Cài FFmpeg
Lệnh cho Ubuntu/Debian; macOS dùng brew install ffmpeg. Cần thêm Python 3.10+, Node.js 18+ và một trợ lý lập trình AI (Claude Code, Cursor, Copilot, Windsurf hoặc Codex).
sudo apt install ffmpeg -
Tải mã nguồn và cài đặt
make setup tạo môi trường Python, cài thư viện, cài Remotion và Piper TTS, tạo file .env từ .env.example.
git clone https://github.com/calesthio/OpenMontage.git cd OpenMontage make setup -
Windows không có make
Chạy trong PowerShell, đứng ở thư mục OpenMontage. Nếu npm install báo lỗi ERR_INVALID_ARG_TYPE, dùng npx --yes npm install.
py -3 -m venv .venv; .\.venv\Scripts\Activate.ps1; python -m pip install -r requirements.txt; cd remotion-composer; npm install; cd ..; python -m pip install piper-tts; Copy-Item .env.example .env -
Thêm khoá API (tuỳ chọn)
Ghi vào file .env; mọi khoá đều tuỳ chọn. Khoá Pexels, Pixabay, Unsplash miễn phí; các khoá tạo ảnh, video, giọng đọc, nhạc là dịch vụ trả phí. Danh sách đầy đủ trong README và docs/PROVIDERS.md.
PEXELS_API_KEY=your-key # Free stock footage and images PIXABAY_API_KEY=your-key # Free stock footage and images FAL_KEY=your-key # FLUX images + Google Veo, Kling, MiniMax video + Recraft images ELEVENLABS_API_KEY=your-key # Premium TTS, AI music, sound effects -
Tạo video trên GPU của máy (tuỳ chọn)
Sau đó thêm VIDEO_GEN_LOCAL_ENABLED=true và VIDEO_GEN_LOCAL_MODEL=wan2.2-ti2v-5b (hoặc wan2.1-1.3b, hunyuan-1.5, ltx2-local, cogvideo-5b…) vào .env.
make install-gpu
Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.
Cấu hình quan trọng
| Mục | Ý nghĩa |
|---|---|
FAL_KEY, ATLASCLOUD_API_KEY | Cổng gọi nhiều mô hình tạo ảnh, video (FLUX, Veo, Kling, MiniMax, Seedream…), trả phí |
PEXELS_API_KEY, PIXABAY_API_KEY, UNSPLASH_ACCESS_KEY | Kho ảnh, cảnh quay miễn phí; khoá nhà phát triển đăng ký miễn phí |
ELEVENLABS_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY | Giọng đọc, ảnh, nhạc, hiệu ứng âm thanh từ các dịch vụ tương ứng |
KLING_API_KEY, RUNWAY_API_KEY, ARK_API_KEY, HEYGEN_API_KEY, XAI_API_KEY | Gọi trực tiếp các dịch vụ tạo video tương ứng |
SUNO_API_KEY | Tạo bài hát, nhạc nền |
VIDEO_GEN_LOCAL_ENABLED, VIDEO_GEN_LOCAL_MODEL | Bật tạo video trên GPU của máy và chọn mô hình |
Cách tích hợp và sử dụng
- Mở dự án trong trợ lý AIMở thư mục OpenMontage trong Claude Code, Cursor, Codex… rồi gõ yêu cầu, ví dụ "Make a 60-second animated explainer about how neural networks learn". Trợ lý chọn quy trình phù hợp và chạy từng bước.
- Làm video từ cảnh quay thậtGhi rõ documentary montage và use real footage only trong yêu cầu, ví dụ "Make a 75-second documentary montage about city life in the rain. Use real footage only, no narration, elegiac tone, with music."
- Duyệt ở từng bướcTrợ lý dừng ở đề xuất, kịch bản, phân cảnh và tư liệu đã tạo để bạn trả lời trong khung chat. Xem bảng tiến độ bằng python -m backlot open.
- Thử không tốn tiềnmake demo xuất vài video mẫu không cần khoá API. python scripts/backlot_simulate_run.py mô phỏng một lượt chạy trên bảng Backlot.
- Kiểm tra bản càimake test-contracts chạy kiểm thử hợp đồng không cần khoá API; make test chạy toàn bộ kiểm thử.
Cập nhật và sao lưu
README không nêu cách cập nhật; vì cài bằng git clone nên có thể kéo bản mới bằng Git rồi chạy lại make setup, cần tự kiểm tra.
Sao lưu file .env (chứa khoá API, không commit lên Git) và thư mục projects/, nơi lưu tư liệu, trạng thái và video đã xuất của từng dự án.
Câu hỏi thường gặp
Làm video với OpenMontage có tốn tiền không?
Không bắt buộc. Không có khoá API, OpenMontage vẫn dùng Piper đọc thuyết minh, cảnh quay từ kho miễn phí và Remotion để dựng. Khi thêm khoá dịch vụ tạo ảnh, video, giọng đọc, bạn trả phí cho dịch vụ đó; các con số chi phí trong README là ví dụ tác giả tự báo.
Giấy phép AGPL-3.0 ảnh hưởng gì khi dùng?
Dùng trên máy để làm video cho mình thì không phát sinh nghĩa vụ đặc biệt. Nếu bạn sửa mã và cho người khác dùng qua mạng, hoặc phân phối lại, bạn phải công bố mã nguồn đã sửa theo cùng giấy phép. Doanh nghiệp định tích hợp vào sản phẩm nên hỏi bộ phận pháp lý.
Có chạy được với mô hình AI cục bộ như Ollama không?
Chưa. README ghi hỗ trợ Ollama và LM Studio là "coming soon"; hiện cần một trợ lý lập trình AI như Claude Code, Cursor hoặc Codex. Riêng phần tạo video có thể chạy trên GPU của máy.
OpenMontage có giao diện để bấm không?
Không có trình dựng kéo thả. Bạn ra lệnh qua khung chat của trợ lý AI; bảng Backlot trên máy chỉ để theo dõi tiến độ, xem phân cảnh và chi phí.
Ứng dụng liên quan
Miễn trừ trách nhiệm
Tino không phát triển, không sở hữu và không liên kết với OpenMontage hay nhóm phát triển calesthio. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
OpenMontage được phân phối theo giấy phép AGPL-3.0 của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.
