OpenMontage, 별도 오케스트레이터 없이 별 4.5만 개

대부분의 AI 영상 도구는 대시보드에 로그인하라고 요구합니다. OpenMontage는 저장소를 git clone한 뒤, 사용 중인 코딩 에이전트가 감독석에 앉게 합니다.

SaaS 대시보드가 아니라 감독처럼 움직이는 저장소

OpenMontage는 오픈소스 에이전트형 영상 제작 프레임워크입니다. 자체 오케스트레이터를 제공하지 않고, 이미 사용 중인 AI 코딩 에이전트가 감독 역할을 맡습니다. 2026년 라이브 스냅샷 기준, calesthio/OpenMontage는 스타 45,042개, 포크 5,540개, 커밋 323개를 기록했고, 라이선스는 AGPL-3.0입니다. 이 저장소는 2026-03-29에 생성됐으며 태그된 릴리스가 없습니다. 버전이 붙은 제품이라기보다 계속 굴러가는 main 브랜치에 가까워, 정확한 버전 기준으로 설명하기는 어렵습니다.

핵심은 아키텍처입니다. Python은 도구와 JSON/YAML 상태 저장을 담당하고, 코딩 에이전트인 Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, OpenCode가 전체 제어 루프를 맡습니다. 제작 과정은 research → proposal → script → scene_plan → assets → edit → compose의 7단계 순서로 인코딩됩니다. 각 단계는 pipeline_defs/의 YAML 매니페스트와 skills/pipelines/의 Markdown 감독 스킬이 한 쌍을 이루며, 이는 파이프라인 워크스루에 문서화되어 있습니다.

"Every video request must go through a named pipeline; ad hoc scripts and bypassing the checkpoint loop are disallowed by design." — OpenMontage AGENT_GUIDE (source: AGENT_GUIDE.md)

이 제약은 단순한 권고가 아니라 실제로 강제됩니다. 에이전트는 매니페스트를 읽고, 사전 점검을 실행하고, 레지스트리를 통해 도구를 찾고, 자체 검토를 수행하고, 상태를 체크포인트로 남기며, 창작 판단이 필요한 지점마다 사람의 승인을 받기 위해 멈춥니다.

시작 전 준비: Python 3.10, FFmpeg, 에이전트

OpenMontage는 기본적으로 로컬에서 실행되므로 준비 목록은 짧고, 설정도 명령어 하나로 끝납니다. 도구 실행과 JSON 상태 저장을 위한 Python 3.10+, 후반 합성을 위한 FFmpeg, Remotion 렌더러용 Node.js 18+, 그리고 감독 역할을 맡을 여섯 가지 지원 코딩 에이전트 중 하나인 Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, OpenCode가 필요합니다 .

git clone 후 cd OpenMontage로 이동하면, 단일 make setup 명령이 Python 패키지, Remotion의 Node 패키지, 오프라인 내레이션용 Piper TTS까지 세 가지 의존성 계층을 한 번에 설치합니다 . 별도로 pip이나 npm 단계를 쫓아갈 필요가 없습니다.

.env.example을 .env로 복사하는 것은 선택 사항입니다. ElevenLabs, Kling, fal.ai 같은 유료 제공자를 연결할 때만 하면 됩니다. 그대로 두면 키 없이 쓰는 경로에 머뭅니다. Docker도, 클라우드 프로비저닝도, 대시보드 로그인도 없습니다.

Claude Code가 빈 폴더에서 초안까지 영상을 지휘하는 방식

설정이 끝나면 넘겨주기 전에 터미널에 입력할 명령은 두 개뿐입니다. 저장소를 클론하고 안으로 들어갑니다.

git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage && make setup

이제 코딩 에이전트가 감독석에 앉습니다. Claude Code에서 저장소를 열면 CLAUDE.md를 읽고, 이 파일은 공통 운영 규칙이 담긴 AGENT_GUIDE.md를 가리킵니다 . Cursor, Copilot, Codex, Windsurf도 각자의 플랫폼용 Markdown 파일을 읽고 동일한 안내로 이어집니다 . 그런 다음 에이전트는 레지스트리를 통해 호출 가능한 도구를 탐색합니다.

python -c "from tools.tool_registry import registry; registry.discover()"

AGENT_GUIDE는 꽤 엄격합니다. 에이전트는 어떤 작업을 호출하기 전에 skills/의 관련 스킬 파일을 읽어야 하며, 모든 요청은 반드시 파이프라인을 거쳐야 합니다. 임시 스크립트나 검토 우회는 명시적으로 금지됩니다 .

이제 "Make a 60-second animated explainer about how neural networks learn."처럼 평문 영어 브리프를 입력합니다. 에이전트는 research → proposal → script → scene_plan → assets → edit → compose로 이어지는 단계형 워크플로에서 파이프라인을 선택하고, 사전 점검을 실행하고, 자체 검토를 거치고, JSON 상태를 체크포인트로 남기며, 다음 단계로 진행하기 전에 모든 창작 판단 지점에서 사용자의 승인을 받기 위해 멈춥니다 .

전체 제작물이 저장소 상태만으로 재현 가능하므로, 블랙박스 렌더 안에 숨는 것은 없습니다. 스크립트는 Markdown으로, 장면 메타데이터는 JSON과 YAML로, 에셋은 안정적인 이름 아래 저장되고, 렌더 명령과 자체 검토 메모도 함께 남습니다. 모두 일반 파일이기 때문에 다른 코드베이스처럼 diff를 보고, 버전 관리하고, 감사할 수 있습니다 .

API 키가 0개여도 완전히 무료라는 뜻은 아닙니다

OpenMontage의 "zero API keys" 주장은 기본 경로에서는 사실이지만, 모든 기능이 무료라는 의미는 아닙니다. 기본 구성만으로도 Piper TTS를 통한 로컬 오프라인 내레이션, Archive.org, NASA, Wikimedia Commons의 영상과 스틸 이미지, WhisperX의 단어 단위 전사, Remotion 합성, FFmpeg 후반 작업을 사용할 수 있으며 API 키가 필요 없습니다 . 스틸 이미지를 이어 붙인 결과가 아니라 무료 실제 영상 경로를 제공한다는 점이 슬라이드쇼 도구와의 차이를 만듭니다.

생성형 클립은 키가 있어야 사용할 수 있습니다. Kling, Runway Gen-4, Google Veo 3, MiniMax, Grok Imagine, HeyGen은 모두 유료 접근 권한이 필요하며, 보통 fal.ai를 통해 연결됩니다. 로컬 WAN 2.1, Hunyuan, CogVideo는 키 없이 사용할 수 있지만 GPU 부담이 큽니다 . README의 비용 예시는 그 차이를 이렇게 보여줍니다.

기본 예산 상한은 대략 $10로, 비용이 통제 없이 불어나는 일을 막아 줍니다. 더 큰 주의점은 비용이 아니라 법적 문제입니다. 이 저장소는 AGPL-3.0이므로, 해당 코드를 포함해 배포되는 소프트웨어에는 카피레프트 의무가 따라붙습니다. 제품 출시 전 검토할 만한 부분입니다.

"로컬 영상은 사용자의 기기에 머물고, 합성과 렌더링은 워터마크나 사용량 과금 없이 로컬에서 실행되며, 무료를 포함한 모든 티어에서 상업적 사용이 가능합니다." — OpenMontage Studio (source: daily.dev)

아직 비공개 알파 단계인 호스팅 레이어 OpenMontage Studio는 AGPL 배포가 부담스러운 팀에게 더 깔끔한 상업용 경로를 제공합니다 .

애니메이션 설명 영상을 넘어: 다른 11가지 형식

애니메이션 설명 영상은 현재 저장소에 포함된 12가지 제작 파이프라인 중 하나입니다 . 명시된 구성에는 애니메이션, 아바타 대변인, 시네마틱, 클립 팩토리, 다큐멘터리 몽타주, 하이브리드, 현지화/더빙, 팟캐스트 재가공, 화면 데모, 토킹 헤드가 포함되며, 각각은 이미 한 번 실행해 본 것과 같은 승인 기반 체크포인트 루프로 제어됩니다 .

차별화되는 항목은 다큐멘터리 몽타주입니다. 정적인 이미지를 애니메이션으로 만드는 대신 Archive.org, NASA, Wikimedia Commons에서 가져온 실제 움직임 영상으로 CLIP 검색 가능한 코퍼스를 구축한 뒤, 실제 클립들을 편집해 이어 붙입니다. 이는 다른 입문용 도구가 제공하지 않는 무료 실제 영상 경로입니다 . 현지화/더빙은 기존 영상을 처음부터 다시 만들지 않고 확장하며, 팟캐스트 재가공은 오디오 중심 콘텐츠를 최소한의 새 에셋만으로 시각 형식으로 바꿉니다 .

확장은 절차적으로 진행됩니다. skills/pipelines/에서 대상 파이프라인의 스킬 파일을 열고 새 브리프를 입력하면 됩니다. 첫 렌더에서 익힌 디렉터 루프는 12개 파이프라인 모두에 그대로 적용됩니다.

자주 묻는 질문

OpenMontage는 정말 API 키 없이도 작동하나요?

네, 기본 경로에서는 가능합니다. 내레이션은 Piper(로컬 오프라인 TTS)로 실행되고, 영상과 스틸 이미지는 Archive.org, NASA, Wikimedia Commons에서 가져오며, 전사는 WhisperX를 사용하고, 합성은 Remotion에서, 후반 작업은 FFmpeg로 처리됩니다. 이 모든 과정이 키 없이 로컬에서 실행됩니다 . 키는 생성형 클립(Kling, Runway Gen-4, Veo 3)과 프리미엄 음성을 사용할 때만 필요합니다. 저장소 자체 예시에는 OpenAI 내레이션과 무료 Pixabay 음악을 사용한 70초짜리 역사 영상의 0.02달러 실행 사례가 포함되어 있으며, 무료 소스만 사용하는 워크플로도 명시적으로 지원됩니다 .

OpenMontage는 어떤 코딩 에이전트와 함께 쓸 수 있나요?

지원되는 디렉터는 Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, OpenCode까지 여섯 가지입니다 . 설정은 에이전트별 파일 라우팅 방식입니다. Claude Code는 CLAUDE.md를 읽은 뒤 AGENT_GUIDE.md를 읽고, Cursor는 CURSOR.md와 .cursor/rules/를 사용하며, Copilot, Codex, Windsurf에는 각각 전용 플랫폼 Markdown 파일이 제공됩니다. 이 모든 파일은 AGENT_GUIDE.md의 동일한 공통 운영 지침을 가리킵니다 .

OpenMontage 스킬 파일은 정확히 무엇인가요?

스킬은 채팅 프롬프트가 아니라, 재사용 가능한 제작 역량을 담은 Markdown 파일입니다. 예를 들어 음악 트랙의 비트를 감지하거나, 불규칙한 이미지를 늘리지 않고 16:9에 맞추거나, QA 체크리스트를 실행하는 기능이 여기에 포함됩니다 . 에이전트는 어떤 도구를 호출하기 전에 관련 스킬 파일을 먼저 읽습니다. 현재 README는 700개 이상의 스킬 및 제작 지식 파일을 내세우고 있으며, 출시 당시 언급된 약 500개보다 늘어난 수치입니다 .

AGPL-3.0 라이선스에서도 상업적 사용이 가능한가요?

네, AGPL-3.0은 상업적 사용을 허용합니다. 다만 조건이 있습니다. 해당 코드를 포함한 소프트웨어를 배포하는 경우, 네트워크를 통해 제공하는 경우까지 포함해, 수정한 소스도 같은 라이선스로 배포해야 합니다 . OpenMontage 위에 제품을 만들려는 팀은 출시 전에 이 의무를 검토해야 합니다. 현재 비공개 알파 단계이고 베타가 예정된 호스팅형 OpenMontage Studio는 모든 티어에서 상업적 사용이 가능하다고 밝히고 있어, 독점 배포에는 더 현실적인 경로일 수 있습니다 .

내 영상에는 어떤 파이프라인을 써야 하나요?

직접 고르지 않아도 됩니다. 에이전트가 AGENT_GUIDE.md를 읽고, 자연어로 작성한 요청에서 적합한 파이프라인을 선택한 뒤, 어떤 에셋도 건드리기 전에 승인할 수 있는 제안을 제시합니다 . AGENT_GUIDE는 규범적으로 작성되어 있습니다. 모든 영상 요청은 이름이 지정된 파이프라인을 거쳐야 하며, 임시 스크립트를 쓰거나 검토 체크포인트를 우회하는 것은 명시적으로 금지되어 있습니다 .

이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.

구독하기