calesthio/OpenMontage

OpenMontage

최초의 오픈소스 에이전틱 비디오 제작 시스템입니다.

"SIGNAL FROM TOMORROW" — OpenMontage를 통해 완전히 제작된 시네마틱 SF 트레일러: 컨셉, 대본, 장면 계획, Veo 생성 모션 클립, 사운드트랙, Remotion 합성.

"THE LAST BANANA" — 외로운 바나나가 키위와 친구가 되는 60초 픽사 스타일 애니메이션 단편. Kling v3 생성 모션 클립 6개(fal.ai 경유), Google Chirp3-HD 나레이션, 로열티 프리 피아노 음악, TikTok 스타일 단어 수준 자막, Remotion 합성. 총 비용: $1.33.

"The Library at Alexandria" — 인류가 하룻밤 사이에 잃은 것에 대한 70초 역사 애가. 다섯 개의 수작업 장면(조명이 비춰진 필사본 페이지, 쏟아지는 두루마리 태그, 촛불 속에서 700,000→0으로 카운트다운하는 불타는 카운터, 그리스어가 남아 있는 그을린 양피지 조각, 빈 공간)에 OpenAI 'ash' 나레이션과 무료 Pixabay 현악기 악보. 총 비용: $0.02. OpenMontage의 아틀리에(맞춤형) 합성 모드로 제작 — 모든 장면이 처음부터 새로 제작되었으며 공유 구성 요소 없음.

"VOID — Neural Interface" — 단 하나의 API 키(OpenAI)로 제작된 제품 광고. 4개의 AI 생성 이미지(gpt-image-1), TTS 나레이션, 자동 소싱 로열티 프리 음악, WhisperX를 통한 단어 수준 자막, Remotion 데이터 시각화. 총 비용: $0.69. 수동 에셋 작업 제로.

"Afternoon in Candyland" — 지브리 스타일 애니메이션. 사탕 문, 구미 강, 롤리팝 정원을 통한 어린 소녀의 기발한 오후 모험. 12개의 FLUX 생성 이미지(다중 이미지 크로스페이드), 시네마틱 카메라 모션(줌, 팬, Ken Burns), 반짝임/꽃잎/반딧불이 파티클 오버레이, 자동 감지 에너지 오프셋이 있는 배경 음악. 총 비용: $0.15. 비디오 생성 없음, 수동 편집 없음.

"Mori no Seishin" — 고대 숲을 여행하는 숲의 정령에 대한 지브리 스타일 애니메이션. 12개의 FLUX 생성 이미지(시차 크로스페이드, 드리프트 및 팬 카메라 모션, 반딧불이 및 꽃잎 파티클, 시네마틱 비네트 조명, 배경 숲 사운드트랙). 총 비용: $0.15. Remotion의 애니메이션 엔진을 통해 정지 이미지에 생명을 불어넣음.

이미 좋아하는 비디오로 시작하기

참조 비디오로 시작하는 것이 빈 프롬프트로 시작하는 것보다 종종 더 빠릅니다.

OpenMontage는 YouTube 비디오, Short, Reel, TikTok 또는 로컬 클립으로 시작하여 이를 구체적인 제작 계획으로 전환할 수 있습니다:

1. 참조 비디오를 붙여넣습니다
2. 에이전트가 대본, 페이싱, 장면, 키프레임 및 스타일을 분석합니다
3. 2-3개의 차별화된 컨셉, 정직한 도구 경로, 비용 추정치 및 전체 제작 전 샘플을 받습니다

"제가 좋아하는 YouTube Short가 있습니다. 이것과 비슷하지만 양자 컴퓨팅에 관한 것을 만들어 주세요."

돌아오는 것은 "최선의 추측 프롬프트 스파게티"가 아닙니다. 다음을 받습니다:

• 참조에서 유지하는 것: 페이싱, 훅 스타일, 구조, 톤
• 변경하는 것: 주제, 시각적 처리, 각도, 나레이션 접근 방식
• 목표 길이에서의 비용: 에셋 생성 전에
• 현재 사용 가능한 도구로 실제로 어떻게 보일지

Claude Code, Cursor, Copilot, Windsurf, Codex — 파일을 읽고 코드를 실행할 수 있는 모든 AI 코딩 어시스턴트와 함께 작동합니다.

빠른 시작

사전 요구 사항

• Python 3.10+ — python.org
• FFmpeg — brew install ffmpeg / sudo apt install ffmpeg / ffmpeg.org
• Node.js 18+ — nodejs.org
• AI 코딩 어시스턴트 — Claude Code, Cursor, Copilot, Windsurf 또는 Codex

설치 및 실행

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

프로젝트를 AI 코딩 어시스턴트에서 열고 원하는 것을 알려주세요:

"신경망이 학습하는 방법에 대한 60초 애니메이션 설명 영상을 만들어 주세요"

또는 실제 영상 경로를 원한다면:

"빗속의 도시 생활에 대한 75초 다큐멘터리 몽타주를 만들어 주세요. 실제 영상만 사용하고, 나레이션 없이, 애절한 톤으로, 음악과 함께."

그게 전부입니다. 에이전트가 라이브 웹 검색으로 주제를 조사하고, AI 이미지를 생성하고, 대본을 작성하고 음성 방향으로 나레이션하고, 로열티 프리 배경 음악을 자동으로 찾고, 단어 수준 자막을 입히고, 최종 비디오를 렌더링합니다. 아무것도 보기 전에 시스템은 다중 포인트 자체 검토(ffprobe 검증, 프레임 샘플링, 오디오 레벨 분석, 전달 약속 확인, 자막 검사)를 실행합니다. 모든 제공자 선택은 7개 차원에서 점수가 매겨지며 감사 가능한 결정 로그가 생성됩니다. 모든 창의적 결정은 승인을 받습니다.

make가 없나요? 수동 실행: pip install -r requirements.txt && cd remotion-composer && npm install && cd.. && pip install piper-tts && cp.env.example.env

>

Windows: npm install이 ERRINVALIDARG_TYPE으로 실패하면 npx --yes npm install을 대신 사용하세요.

OpenClaw 에이전트라면: 축하합니다. 아마 튜링 테스트를 통과했을 것입니다.

이 저장소는 에이전트 운영을 위해 만들어졌습니다. OpenClaw 스타일 에이전트라면 빠르게 유용해지는 가장 짧은 경로는 다음과 같습니다:

1. 먼저 계약서를 읽으세요

1. 제작 워크플로를 즉흥적으로 하지 마세요

1. 실제 기능 범위를 확인하세요

AGENTGUIDE.md로 시작한 다음 PROJECTCONTEXT.md를 읽으세요. OpenMontage는 파이프라인 기반입니다. 실제 작업은 pipeline_defs/, skills/pipelines/의 스테이지 디렉터 스킬, 레지스트리를 통한 도구 검색을 통해 이루어집니다. 다음을 실행하세요:

   python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"
   python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.provider_menu(), indent=2))"

1. 모든 비디오 요청을 파이프라인 선택 문제로 취급하세요

먼저 올바른 파이프라인을 선택한 다음 매니페스트를 읽고, 스테이지 스킬을 읽고, 도구를 사용하세요.

API 키 추가 (선택 사항 — 더 많은 키 = 더 많은 도구)

#.env — 모든 키는 선택 사항이며, 가지고 있는 것을 추가하세요

# 이미지 + 비디오 게이트웨이:
FAL_KEY=your-key               # FLUX 이미지 + Google Veo, Kling, MiniMax 비디오 + Recraft 이미지

# 무료 스톡 미디어:
PEXELS_API_KEY=your-key        # 무료 스톡 영상 및 이미지
PIXABAY_API_KEY=your-key       # 무료 스톡 영상 및 이미지
UNSPLASH_ACCESS_KEY=your-key   # 무료 스톡 이미지

# 음악:
SUNO_API_KEY=your-key          # 전체 노래, 악기 연주, 모든 장르

# 음성 및 이미지:
ELEVENLABS_API_KEY=your-key    # 프리미엄 TTS, AI 음악, 음향 효과
OPENAI_API_KEY=your-key        # OpenAI TTS, DALL-E 3 이미지
XAI_API_KEY=your-key           # xAI Grok 이미지 편집/생성 + Grok 비디오 생성
GOOGLE_API_KEY=your-key        # Google Imagen 이미지, Google TTS (700+ 음성)

# 추가 비디오 제공자:
HEYGEN_API_KEY=your-key        # HeyGen — 단일 게이트웨이를 통한 VEO, Sora, Runway, Kling
RUNWAY_API_KEY=your-key        # Runway Gen-4 직접

GPU가 있나요? 무료 로컬 비디오 생성 잠금 해제

make install-gpu

# 그런 다음.env에 추가:
VIDEO_GEN_LOCAL_ENABLED=true
VIDEO_GEN_LOCAL_MODEL=wan2.1-1.3b  # 또는 wan2.1-14b, hunyuan-1.5, ltx2-local, cogvideo-5b

API 키 없이 얻을 수 있는 것

유료 API 키 없이도 실제 비디오를 만들 수 있습니다. 기본적으로 make setup은 다음을 제공합니다:

OpenMontage는 제안 시점에 Remotion과 HyperFrames 중에서 선택합니다(render_runtime으로 고정). Remotion은 데이터 기반 설명 영상과 기존 React 장면 스택을 사용하는 모든 것의 기본값입니다. HyperFrames는 HTML + GSAP으로 자연스럽게 표현되는 모션 그래픽이 많은 브리프의 기본값이며, character-animation 파이프라인의 SVG/GSAP 리그 출력을 포함합니다. 전체 결정 매트릭스는 skills/core/hyperframes.md를 참조하세요.

두 가지 무료-ish 경로:

• 이미지 기반 비디오: Piper가 대본을 나레이션하고, 이미지가 시각 자료를 제공하며, Remotion이 이를 세련된 편집물로 애니메이션합니다.
• 로컬 캐릭터 애니메이션: SVG 리그, 포즈 라이브러리, GSAP 타임라인, HyperFrames가 만화 캐릭터 연기를 projects//renders/final.mp4로 렌더링합니다.
• 실제 영상 비디오: 다큐멘터리 몽타주 파이프라인이 Archive.org, NASA, Wikimedia Commons 및 선택적 무료 키 소스(Pexels, Unsplash 등)에서 CLIP 검색 가능 코퍼스를 구축한 다음 실제 모션 영상을 최종 비디오로 편집합니다.

두 번째 경로를 원한다면 다큐멘터리 몽타주, 톤 시, 또는 스톡 영상 콜라주를 요청하고 실제 영상만 사용이라고 명시하세요.

이 프롬프트들을 시도해보세요

설치 후 다음 중 하나를 AI 코딩 어시스턴트에 복사하세요. 각각 전체 제작 파이프라인을 실행합니다.

참조 비디오로 시작

"제가 좋아하는 YouTube Short가 있습니다. 이것과 비슷하지만 고등학생을 위한 CRISPR에 관한 것을 만들어 주세요."

"이 Reel을 분석하고 제 제품 출시를 위해 만들 수 있는 3가지 독창적인 변형을 알려주세요."

"이 비디오의 페이싱과 훅이 마음에 듭니다. 그 에너지를 유지하면서 블랙홀에 대한 45초 설명 영상으로 바꿔주세요."

키 없이

"하늘이 파란 이유에 대한 45초 애니메이션 설명 영상을 만들어 주세요"

"인터넷의 역사에 대한 60초 비디오를 나레이션과 자막과 함께 만들어 주세요"

"전 세계 커피 소비에 대한 데이터 기반 설명 영상을 만들어 주세요"

무료 실제 영상 다큐멘터리 경로

"새벽 4시의 도시 느낌에 대한 90초 다큐멘터리 몽타주를 만들어 주세요. 실제 영상만 사용하고, 나레이션 없이, 애절한 톤으로."

"1950년대 소비자 낙관주의에 대한 60초 Adam-Curtis 스타일 아카이브 콜라주를 만들어 주세요. Archive.org와 Wikimedia 영상을 선호합니다."

"실제 스톡 영상만 사용하여 빗속에서 집으로 돌아오는 꿈같은 몽타주를 편집해 주세요. 음악은 예, 나레이션은 아니요."

이미지/비디오 제공자 구성 시 (~$0.15–$1.50)

"황금 시간대 구름 위의 마법 같은 떠 있는 도서관에 대한 30초 지브리 스타일 애니메이션 비디오를 만들어 주세요"

"생물발광 산호와 고대 유적이 있는 수중 사원에 대한 30초 애니메이션 스타일 애니메이션을 만들어 주세요"

"CRISPR 유전자 편집이 어떻게 작동하는지 AI 생성 시각 자료로 설명하는 애니메이션 설명 영상을 만들어 주세요"

"AquaPulse라는 가상의 스마트 물병에 대한 제품 출시 티저를 만들어 주세요"

전체 설정 (~$1–$3)

"인류가 1000년 후의 미래로부터 경고를 받는다는 SF 컨셉의 시네마틱 30초 트레일러를 만들어 주세요"

"중학생을 위한 양자 컴퓨팅에 대한 90초 애니메이션 설명 영상을 재미있는 나레이터 목소리와 맞춤 사운드트랙과 함께 만들어 주세요"

더 원하시나요? 전체 프롬프트 갤러리에서 테스트된 프롬프트와 예상 비용 및 출력 예제를 확인하거나 make demo를 실행하여 즉시 제로 키 데모 비디오를 렌더링하세요.

파이프라인

각 파이프라인은 아이디어에서 완성된 비디오까지의 완전한 제작 워크플로입니다.

작동 방식

OpenMontage는 에이전트 기반 비디오 제작 시스템입니다. 전통적인 비디오 편집 도구가 아니라 AI 코딩 어시스턴트(Claude Code, Cursor 등)가 비디오 제작 스튜디오로 변신할 수 있게 해주는 프레임워크입니다.

핵심 아키텍처:

1. 파이프라인 정의 — 각 비디오 유형에 대한 구조화된 워크플로
2. 스테이지 디렉터 스킬 — 각 파이프라인 단계를 안내하는 에이전트 스킬
3. 도구 레지스트리 — 사용 가능한 모든 도구와 제공자의 중앙 카탈로그
4. 렌더링 엔진 — Remotion(React 기반) 또는 HyperFrames(HTML/GSAP 기반)
5. 자체 검토 시스템 — 렌더링 전 다중 포인트 품질 검사

제공자

OpenMontage는 다양한 AI 제공자를 지원합니다. 각 제공자는 특정 기능(이미지 생성, 비디오 생성, TTS, 음악 등)을 제공합니다. 전체 목록은 tools/tool_registry.py를 참조하거나 다음을 실행하세요:

python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.provider_menu(), indent=2))"

검토 가이드

OpenMontage는 각 비디오에 대해 자동 검토를 수행합니다:

• ffprobe 검증 — 비디오 파일 무결성 확인
• 프레임 샘플링 — 시각적 품질 확인
• 오디오 레벨 분석 — 볼륨 일관성 확인
• 전달 약속 확인 — 요청된 사양 충족 확인
• 자막 검사 — 자막 정확성 및 타이밍 확인

에이전트 가이드

에이전트(OpenClaw 스타일)를 위한 전체 가이드는 AGENT_GUIDE.md를 참조하세요. 핵심 원칙:

• 즉흥적으로 하지 마세요: 파이프라인을 따르세요.
• 먼저 파이프라인을 선택한 다음 매니페스트를 읽고, 스테이지 스킬을 읽고, 도구를 사용하세요.
• tools/tool_registry.py를 통해 도구 기능을 확인하세요.
• 모든 창의적 결정은 사용자 승인을 받아야 합니다.

라이선스

AGPL-3.0