OpenMontage: 코딩 에이전트로 영상 제작 파이프라인 구축하기
요약: OpenMontage는 기존 AI 코딩 어시스턴트에서 실행되는 오픈소스 에이전트 기반 영상 제작 시스템입니다. 11개의 제작 파이프라인, 100개 이상의 도구, 60개 이상의 공급자 통합, 700개 이상의 스킬 및 지식 파일을 사용해 연구부터 스크립트, 에셋, 편집, 렌더링까지 처리합니다. 2026년 9월 1일 기준 55,047개의 별을 받았습니다. 다만 두 가지를 먼저 확인해야 합니다. 라이선스는 MIT가 아닌 AGPL-3.0이며, 재시도마다 실제 비용이 발생할 수 있는 API 중심 시스템입니다.
본 문서는 2026년에 설치할 가치가 있는 오픈소스 AI 에이전트 도구 5가지에 대한 종합 분석 중 하나의 도구를 심층적으로 다룬 것입니다.
대부분의 “AI 영상” 도구는 프롬프트 하나로 클립 하나를 만듭니다. OpenMontage는 코딩 에이전트에 제작 부서를 제공합니다.
연구 -> 제안 -> 스크립트 -> 장면 계획 -> 에셋 -> 편집 -> 합성
각 단계에는 디렉터 스킬이 있습니다. 스킬은 에이전트가 특정 단계를 실행하는 방법을 정의한 마크다운 지시 파일입니다. 에이전트는 스킬을 읽고 도구를 호출한 뒤 결과를 검토하고, 상태를 체크포인트하며, 중요한 창작 결정에서는 사람의 승인을 기다립니다.
OpenMontage가 실제로 하는 일
Claude Code, Cursor, Copilot, Windsurf 또는 Codex에서 저장소를 열고 원하는 영상을 설명합니다.
신경망이 학습하는 방법에 대한 60초 분량의 애니메이션 설명 영상을 만드세요.
에이전트는 고정된 제작 파이프라인을 실행합니다. 특히 연구 단계가 단순한 프롬프트-투-비디오 도구와 차별화됩니다.
스크립트를 작성하기 전에 YouTube, Reddit, Hacker News, 뉴스 사이트와 학술 자료를 대상으로 약 15~25회의 웹 검색을 수행하고, 인용문을 포함한 구조화된 연구 요약서를 만듭니다. 따라서 스크립트는 모델의 기억보다 에이전트가 실제로 수집한 자료를 기반으로 작성됩니다.
지원하는 제작 파이프라인
README에는 11개의 완성된 제작 워크플로가 정리되어 있지만, 저장소 설명에는 12개로 표시되어 있습니다.
| 파이프라인 | 제작물 | 적합한 용도 |
|---|---|---|
| 애니메이션 설명 영상 | 연구, 내레이션, 시각 자료, 음악 | 튜토리얼, 주제 분석 |
| 애니메이션 | 모션 그래픽, 키네틱 타이포그래피 | 소셜 미디어, 제품 데모 |
| 아바타 대변인 | 발표자 주도 영상 | 기업 커뮤니케이션, 교육 |
| 시네마틱 | 예고편, 티저, 분위기 편집 | 브랜드 필름 |
| 클립 팩토리 | 긴 소스에서 순위가 매겨진 짧은 클립 | 긴 콘텐츠 재활용 |
| 다큐멘터리 몽타주 | 인덱싱된 무료 푸티지에서 테마별 컷 | 영상 에세이, 실제 푸티지 B-롤 |
| 하이브리드 | 원본 푸티지와 생성된 시각 자료 | 기존 푸티지 개선 |
| 현지화 및 더빙 | 자막, 더빙, 번역 | 다국어 배포 |
| 팟캐스트 재활용 | 팟캐스트 하이라이트를 영상으로 변환 | 팟캐스트 마케팅 |
| 화면 데모 | 세련된 화면 녹화 | 제품 데모, 문서 |
| 토킹 헤드 | 푸티지 기반 발표자 영상 | 프레젠테이션, 인터뷰 |
다큐멘터리 몽타주
다큐멘터리 몽타주는 기술적으로 가장 흥미로운 파이프라인 중 하나입니다.
스틸 이미지를 애니메이션화하는 대신 Pexels, Archive.org, NASA, Wikimedia, Unsplash 등의 무료 스톡 및 공개 아카이브에서 CLIP으로 인덱싱한 코퍼스를 구축합니다. 이후 의미론적 일치로 실제 모션 클립을 검색해 타임라인에 삽입합니다.
유료 생성 API 없이 실제 푸티지로 완성된 영상을 만들 수 있다는 점에서 일반적인 무료 AI 영상 스택과 접근 방식이 다릅니다.
화면 데모와 클립 팩토리
개발자 콘텐츠를 만드는 팀이라면 화면 데모와 클립 팩토리부터 검토할 만합니다.
릴리스가 나오면 이미 변경 로그가 존재합니다. 이를 안내 영상으로 만드는 일에는 보통 편집 기술과 시간이 필요하지만, OpenMontage는 이 과정을 자동화할 수 있습니다. 긴 컨퍼런스 영상이나 팟캐스트를 여러 개의 소셜 클립으로 재활용하는 작업에도 적합합니다.
Backlot과 승인 관문
채팅은 에이전트가 무엇을 말했는지 보여줍니다. Backlot은 제작이 실제로 어떻게 진행되는지 보여주는 로컬 보드입니다.
단계의 활성화 상태, 시나리오 페이지로 완성되는 스크립트, 장면별 에셋 카드, 공급자 선택과 비용이 하나의 보드에 표시됩니다.
python -m backlot open # 디스크에 있는 모든 프로젝트 라이브러리
python -m backlot open <project-id> # 특정 제작물의 실시간 보드
python scripts/backlot_simulate_run.py # 먼저 시뮬레이션 실행 보기
제작을 시작하면 보드가 자동으로 열립니다. 별도의 리포팅 시스템 없이 파이프라인이 생성하는 파일에서 정보를 읽어옵니다.
핵심은 스토리보드가 실제 승인 관문이라는 점입니다. 에셋 생성 단계에서는 테이크, 프롬프트, 에셋별 비용, 품질 점수를 보여주는 연락 시트에서 작업이 멈춥니다. 따라서 비용을 지불한 뒤가 아니라 렌더링 전에 시각 자료를 승인할 수 있습니다. 스크립트도 사용자가 답변할 때까지 대기합니다.
실행이 끝난 뒤에는 타임스탬프를 통해 전체 제작 과정을 다시 재생할 수 있습니다.
비용이 발생하는 에이전트 시스템에서는 지출 전에 사람의 승인을 받는 설계가 중요합니다. 승인 전에는 시작할 수 없는 작업은 이 범주에서 가장 유용한 안전장치 중 하나입니다.
참조 영상으로 시작하기
완벽한 프롬프트를 처음부터 작성할 필요도 없습니다. 원하는 참조 영상을 제공하면 됩니다.
YouTube 영상, 쇼츠, 릴, TikTok 또는 로컬 클립을 붙여넣으면 에이전트가 스크립트, 페이싱, 장면, 키프레임과 스타일을 분석합니다. 그다음 전체 제작을 시작하기 전에 차별화된 콘셉트 두세 가지, 사용할 도구 경로, 비용 추정치와 샘플을 제시합니다.
제가 좋아하는 YouTube 쇼츠입니다. 이것과 비슷하게 만들되, API 버전 관리에 대한 내용을 담아주세요.
결과에는 다음 내용이 포함됩니다.
- 참조 영상에서 유지할 요소
- 변경할 요소
- 목표 길이에 따른 예상 비용
- 현재 구성된 공급자로 구현했을 때의 결과
제작을 시작하기 전에 비용과 결과를 확인하는 것이 OpenMontage의 전체적인 설계 방향입니다.
설치하기
git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage
make setup
필요한 환경은 다음과 같습니다.
- Python 3.10 이상
- FFmpeg
- Node.js 18 이상
- 파일을 읽고 코드를 실행할 수 있는 AI 코딩 어시스턴트
설치 후 에이전트에서 프로젝트를 열고 원하는 영상을 설명하면 됩니다.
공급자 설정은 선택 사항이며 점진적으로 추가할 수 있습니다. 모든 기능은 유료 API뿐 아니라 오픈소스 및 로컬 대안을 지원합니다. 점수가 매겨진 선택기는 다음 7개 기준으로 공급자를 평가합니다.
- 작업 적합성
- 출력 품질
- 제어 가능성
- 신뢰성
- 비용 효율성
- 지연 시간
- 연속성
특정 공급업체에 종속되지 않으며, 유료 설정 없이도 상당한 기능을 실행할 수 있습니다.
프로젝트의 쇼케이스 영상은 세 가지 이미지 모델과 네 가지 영상 모델로 7개의 생성된 세계를 보여주며, 소스 생성 비용은 약 5달러였다고 보고합니다.
개발하기 전에 AGPL-3.0을 확인하세요
OpenMontage를 다른 오픈소스 에이전트 도구와 구분하는 가장 중요한 요소 중 하나는 라이선스입니다.
OpenMontage는 AGPL-3.0을 사용합니다. 반면 agency-agents, Agent-Reach, Orca, codebase-memory-mcp는 모두 MIT 라이선스입니다.
AGPL의 네트워크 조항에 따르면 수정된 버전을 네트워크 서비스로 실행할 경우, 해당 서비스 사용자에게 수정된 소스 코드를 제공해야 할 수 있습니다.
내부 도구나 개인 프로젝트로 사용하는 것은 가능하지만, 이를 SaaS 제품으로 묶어 외부에 제공하고 요금을 부과하는 경우에는 법률 검토가 필요합니다. 워크플로를 구축한 뒤가 아니라 도입 전에 법무팀과 라이선스를 확인하세요.
가장 어려운 부분은 API 통합입니다
사용자가 두 번째 주에 어려움을 겪는 부분은 대개 창작 작업이 아닙니다. OpenMontage는 영상·이미지 생성, 텍스트 음성 변환, 음악, 오디오 믹싱, 자막, 향상, 분석 등 60개 이상의 공급자 통합을 조율합니다.
각 타사 API는 고유한 인증 방식, 할당량, 오류 형식과 지연 시간 프로필을 가집니다. 에이전트는 단순히 영상을 작성하는 것이 아니라 수십 개의 유료 서비스에 분산 작업을 실행하고 결과를 결합합니다.
이 구조에서는 다음과 같은 실패 모드를 반드시 처리해야 합니다.
- 장시간 비동기 작업: 영상 생성은 요청 직후 완료되지 않습니다. 작업을 제출한 뒤 몇 분 동안 상태를 폴링해야 합니다. 에이전트가 이를 제대로 처리하지 못하면 타임아웃이나 무한 대기 상태가 발생할 수 있습니다. 구현 패턴은 AI 에이전트와 함께 장시간 실행되는 API 작업 처리하기에서 확인할 수 있습니다.
- 비용이 발생하는 재시도: 요청은 성공했지만 응답 타임아웃이 발생한 경우, 동일한 생성 요청을 재시도하면 같은 클립에 두 번 비용을 지불할 수 있습니다. 유료 작업에는 AI 에이전트를 위한 멱등성 키를 적용해야 합니다.
- 할당량 및 속도 제한: 429 오류는 500 오류와 다르게 처리해야 합니다. 기다리면 해결되는 요청을 즉시 다른 공급자로 페일오버하면 비용과 품질이 모두 악화될 수 있습니다. 오류 형식은 AI 에이전트를 위한 API 오류 메시지 설계, 복구 전략은 AI 에이전트 오류 복구에서 다룹니다.
- 예고 없는 API 변경: 응답 필드가 이동하거나 제작 중 파이프라인이 깨질 수 있습니다. 때로는 오류가 아니라 잘못된 렌더링 결과로 변경을 발견합니다. 자세한 내용은 API 변경이 AI 에이전트를 망가뜨릴 때 발생하는 일을 참고하세요.
OpenMontage는 이 문제를 비교적 진지하게 다룹니다.
- 실행 전 비용 추정
- 지출 상한선
- 작업별 승인 임계값
- GPU 시간을 낭비하기 전에 계획 오류를 감지하는 사전 합성 검증
- 프레임 추출과 오디오 분석을 포함한
ffprobe기반 렌더링 후 자체 검토 - 공급자 선택과 페일오버에 대한 감사 가능한 결정 경로
공급자를 추가하거나 OpenMontage를 자체 서비스 뒤에 래핑하려면 같은 규율을 적용하는 것이 좋습니다. 계약을 OpenAPI 사양으로 작성하고, 해당 사양에서 모의를 생성해 실제 호출 비용 없이 실패 분기를 테스트하며, CI에서 계약 테스트를 실행해야 합니다.
비싸고 느리며 비결정적인 API를 실시간 서비스가 아닌 모의 대상으로 테스트하는 것이 가장 큰 비용 절감 효과를 냅니다. Apidog는 다운로드 페이지에서 오류 응답을 포함한 사양 기반 모의를 생성할 수 있습니다. 일반적인 접근 방식은 OpenAPI 사양을 에이전트 도구로 사용하기에서 확인할 수 있습니다.
제작은 팀 스포츠입니다
Backlot은 좋은 보드이지만 한 대의 머신에서 하나의 제작물을 관리하는 로컬 보드입니다. 개인 작업에는 충분하지만 팀 작업에는 한계가 있습니다.
실제 영상 제작에는 다음과 같은 협업이 필요합니다.
- 스크립트에 대한 주제 전문가 검토
- 시각 자료에 대한 브랜드 담당자 검토
- 주장과 통계에 대한 사실 확인
- 최종 편집본에 대한 채널 소유자 승인
OpenMontage의 관문은 특정 승인 담당자를 지정하거나 승인 대기열을 관리하지 않습니다. 누가 무엇을 승인했는지에 대한 기록도 로컬 프로젝트 폴더의 타임스탬프에 의존합니다.
Sharkly는 이 협업 계층을 보완합니다.
- 작업이 기록이 됩니다. 진행 상황, 도구 호출과 결과가 스트리밍되고, 에이전트 출력은 답글을 달 수 있는 댓글로 저장됩니다.
- Crew가 리더 우선으로 작동합니다. 리더 에이전트가 브리핑을 읽고 필요한 전문가와 사람을 결정한 뒤 결과를 결합합니다.
- Backlog는 실행을 시작하지 않습니다. 한 달 분량의 작업을 비용 없이 대기열에 넣고 승인된 항목만 릴리스할 수 있습니다.
- Agent는 저장된 구성입니다. 지침, 런타임, 스킬, 저장소, 환경과 예산 제한을 재사용할 수 있습니다.
- 실행 머신을 지정할 수 있습니다. 노트북, 서버 또는 컨테이너 등 실제 디스크와 CPU를 가진 장비에서 렌더링할 수 있습니다.
- 저장소 작업은 별도 작업 트리에서 실행됩니다. 여러 제작물이 동시에 실행되어도 서로 충돌하지 않습니다.
요약하면 OpenMontage는 제작을 자동화하지만 승인, 할당과 조직 차원의 기록까지 자동화하지는 않습니다. 팀에서는 바로 이 부분이 출시를 결정하는 관문입니다.
누가 설치해야 할까요?
다음 조건에 해당한다면 설치할 가치가 있습니다.
- 개발자 콘텐츠를 정기적으로 제작하는 경우
- 편집 비용을 줄이거나 편집 없이 콘텐츠를 배포하려는 경우
- 화면 데모, 클립 팩토리 또는 현지화가 필요한 경우
- 무료 아카이브 기반의 실제 푸티지 결과물이 필요한 경우
특히 변경 로그를 안내 영상으로 바꾸거나, 하나의 컨퍼런스 강연을 수십 개의 소셜 클립으로 변환하는 작업은 일주일 안에 설정 비용을 회수할 수 있습니다.
반대로 다음 경우에는 건너뛰는 편이 낫습니다.
- 일회성 영상 하나만 필요한 경우
- 공급자 설정과 학습 곡선을 감당하기 어려운 경우
- AGPL-3.0이 제품 배포 방식과 맞지 않는 경우
자주 묻는 질문
유료 API 키가 필요한가요?
아니요. 모든 기능은 오픈소스 또는 로컬 대안을 지원하며, 다큐멘터리 몽타주는 무료 아카이브를 기반으로 구축됩니다. 유료 공급자는 더 높은 품질과 다양한 생성 옵션을 제공합니다. 무료 설정으로 시작한 뒤 한계에 도달했을 때 공급자를 추가하면 됩니다.
어떤 코딩 어시스턴트가 작동하나요?
Claude Code, Cursor, Copilot, Windsurf와 Codex가 언급되어 있습니다. 파이프라인이 Python과 마크다운 스킬 파일로 구성되어 있으므로, 파일을 읽고 코드를 실행할 수 있는 도구라면 사용할 수 있습니다.
영상 제작 비용은 얼마인가요?
파이프라인과 공급자에 따라 달라집니다.
- 7개 세계 쇼케이스: 생성 비용 약 5달러
- 무료 아카이브를 사용하는 다큐멘터리 몽타주: 거의 0에 가까운 비용
- 생성 API 중심 파이프라인: 선택한 모델과 재시도 횟수에 따라 증가
시스템은 실행 전에 비용을 추정하고 지출 상한선을 적용하므로 약정 전에 예상 비용을 확인할 수 있습니다.
AGPL 라이선스가 문제가 되나요?
내부 사용, 개인 프로젝트와 오픈소스 작업은 일반적으로 사용할 수 있습니다. 수정된 버전을 다른 사람을 위한 네트워크 서비스로 실행하면 소스 공개 의무가 발생할 수 있으므로, 제품을 구축하기 전에 법무팀에 문의하세요.
제 푸티지를 편집할 수 있나요?
가능합니다. 토킹 헤드, 하이브리드, 화면 데모, 클립 팩토리와 현지화 파이프라인은 사용자가 제공하는 푸티지에서 작동합니다. 생성은 여러 옵션 중 하나일 뿐입니다.
에이전트 프레임워크와 어떻게 다른가요?
OpenMontage는 agency-agents와 비슷한 스킬 라이브러리이지만 영상 제작이라는 하나의 도메인에 집중하고 실제 도구를 함께 제공합니다.
Strands나 AgentKit과 같은 오케스트레이션 인프라는 아닙니다. 기존 코딩 에이전트가 영상 제작을 수행하도록 만드는 도메인 특화 스킬 및 도구 라이브러리입니다.
마무리
OpenMontage는 현재 에이전트 도구 중 가장 야심찬 프로젝트 중 하나입니다. 지출 전 승인, 실행 전 비용 추정, 렌더링 후 자체 검토와 감사 가능한 결정 경로를 제공한다는 점도 인상적입니다.
개발자 콘텐츠를 만든다면 화면 데모와 클립 팩토리만으로도 설치를 정당화할 수 있습니다. 무료 아카이브 기반의 실제 푸티지가 필요하다면 다큐멘터리 몽타주도 독특한 선택입니다.
다만 시작하기 전에 두 가지를 확인하세요.
- 라이선스는 MIT가 아닌 AGPL-3.0입니다.
- 창작 작업 뒤에는 비용이 발생하는 장시간 API 통합이 있습니다.
따라서 서면 계약, 실제 비용 없이 실패 분기를 검증할 수 있는 모의, 멱등성 재시도, 할당량 초과와 서비스 중단을 구분하는 오류 처리가 필요합니다. Apidog는 이러한 API 계약과 모의 테스트를 지원하고, 누가 무엇을 언제 승인했는지에 대한 협업 기록은 Sharkly가 담당합니다.
에이전트는 영상을 지시할 수 있습니다. 그러나 영상이 승인되었다는 유일한 기록이 되어서는 안 됩니다.


Top comments (0)