OpenMontage × Hermes 통합 설계안
OpenMontage는 Hermes에서 영상 제작용 외부 harness로 활용 가치가 높지만, AGPL-3.0 라이선스, 대량 agent skill 충돌, API key·비용 관리, Remotion/HyperFrames/FFmpeg 런타임 복잡성이 크므로 격리 PoC + wrapper skill + 단계별 승인 게이트 방식으로 도입하는 것이 안전합니다.
1. 목적 및 적용 범위
본 설계안은 calesthio/OpenMontage를 Hermes에서 사용할 수 있는지 판단하고, 설치 전에 안전한 통합 구조를 정의하기 위한 문서입니다. 이번 범위는 read-only GitHub 분석과 통합 설계이며, clone·dependency install·runtime 실행은 수행하지 않았습니다.
범위 제한: 설치, API key 등록, npm install, make setup, provider 호출, 영상 렌더링은 하지 않았습니다. 저장소 README, GitHub API, 주요 문서/파일 구조, Makefile, requirements, architecture/provider 문서를 기준으로 작성했습니다.
2. Executive Summary
| 판단 항목 | 결론 | 의미 |
|---|---|---|
| Hermes 적합성 | 높음 | OpenMontage도 agent-first 구조라 Hermes와 철학적으로 맞습니다. |
| 즉시 기본 편입 | 비추천 | .agents, .claude, skills 규모가 커서 Hermes skill catalog 충돌 가능성이 큽니다. |
| PoC 도입 | 추천 | 격리 repo, zero-key smoke, wrapper skill 기반으로 검증하는 것이 안전합니다. |
| 라이선스 | 주의 | AGPL-3.0이므로 고객 제공형 서비스화·수정 배포 전 법무 검토가 필요합니다. |
| 업무 활용 | 중~높음 | AIR Studio/TRUST 소개, PoC walkthrough, MBR trend video, 워크숍 오프닝에 유용합니다. |
3. OpenMontage 핵심 구조
OpenMontage는 단일 prompt-to-video 도구가 아니라, AI coding assistant가 pipeline과 stage director skill을 읽고 도구를 호출하는 instruction-driven video production system입니다.
4. Repository 분석 요약
| 영역 | 확인 내용 | 설계 시사점 |
|---|---|---|
| License | GNU AGPL-3.0 | 고객 제공형·서비스형 활용 전 법무 검토 필요 |
| 구성 규모 | 약 2,259 paths | Hermes로 직접 import하지 말고 repo-local 참조 |
| Agent guides | AGENT_GUIDE.md, CLAUDE.md, CODEX.md 등 | 외부 agent contract를 Hermes global persona로 가져오면 안 됨 |
| Pipeline | 13개 YAML manifest | animated-explainer, documentary-montage, screen-demo 우선 검토 |
| Tools | video/audio/graphics/analysis 등 Python tools | selector/provider pattern과 비용 추적을 wrapper에서 통제 |
| Renderer | Remotion, HyperFrames, FFmpeg | Node/FFmpeg/HTML animation runtime 검증 필요 |
5. Hermes 연동 원칙
- Do not install by default: 한스님 승인 전 clone/setup/npm install/provider 호출을 하지 않습니다.
- Do not import skills globally: OpenMontage의 `.agents`, `.claude`, `skills`는 Hermes unified skill catalog로 대량 흡수하지 않습니다.
- Use wrapper skill: `hans-openmontage-workflow`가 route, approval, credential, cost, QA를 강제합니다.
- Isolate runtime: `/opt/data/cowork/OpenMontage` 같은 별도 경로와 별도 Python/Node runtime으로 둡니다.
- Prefer zero-key first: API key 없이 가능한 demo/preflight/render path부터 검증합니다.
- Protect credentials: `.env`를 repo 내부에 무심코 만들지 않고 `/opt/data/secrets/openmontage/` 또는 Hermes secure env injection을 사용합니다.
- Deliver verified artifacts: MP4, thumbnail/contact sheet, ffprobe report, source/copyright manifest를 함께 산출합니다.
6. Target Use Cases for Hans
AIR Explainer
AIR Studio, AIR TRUST, AgentOps, 거버넌스 모델을 45~90초 영상으로 설명합니다.
MBR Trend Video
AI/cloud market trend를 stock footage, chart, caption으로 임원 보고용 montage로 구성합니다.
PoC Walkthrough
screen-demo pipeline으로 고객 PoC 결과와 기능 흐름을 내레이션 포함 영상으로 만듭니다.
Workshop Opener
AI governance, model routing, agentic operations 워크숍 오프닝 영상 제작에 적합합니다.
7. Wrapper Skill 설계
권장 skill 이름은 hans-openmontage-workflow입니다. 이 skill은 OpenMontage를 Hermes 기본 도구로 흡수하는 것이 아니라, 외부 harness를 안전하게 호출하기 위한 통제 계층입니다.
| Phase | 주요 활동 | 산출물 / Gate |
|---|---|---|
| 0. Intake | 목적, 길이, 청중, 민감정보, reference 여부 확인 | Production brief |
| 1. Route | pipeline 후보 선택: animated-explainer, screen-demo, documentary-montage 등 | Pipeline decision |
| 2. Guard | AGPL, API key, 비용, 외부 provider, 저작권 위험 판단 | Risk approval |
| 3. Preflight | Python/Node/FFmpeg/Remotion/HyperFrames 상태 확인 | Preflight report |
| 4. Production | script, scene plan, asset manifest, edit decisions 작성 | Human checkpoint |
| 5. Render | Remotion/HyperFrames/FFmpeg 조합으로 MP4 생성 | Render report |
| 6. QA | ffprobe, frame sampling, subtitle/font, audio, source attribution 검증 | Final review |
| 7. Delivery | MP4, preview, thumbnail, source manifest, cost log 전달 | MEDIA delivery |
8. Credential / Cost / License Guard
핵심 리스크: OpenMontage는 다양한 media provider key를 요구할 수 있습니다. 한스님 환경에서는 OpenAI API key를 GBrain embedding 용도로 제한하는 선호가 있으므로, 영상 생성에서 OpenAI API key를 직접 사용하는 route는 기본 비활성화해야 합니다.
| Guard | 정책 | 기본값 |
|---|---|---|
| License | AGPL-3.0 영향 검토. 고객 제공형 SaaS·서비스화 전 법무 확인. | PoC only |
| API keys | repo-local `.env` 금지. 별도 secrets dir 또는 Hermes secure injection. | zero-key 우선 |
| Cost | 예상 비용, single action approval, total cap를 production 전 제시. | cap mode |
| Customer data | 고객 민감자료는 외부 provider 전송 금지 또는 명시 승인. | block |
| Copyright | stock/music/source attribution manifest 필수. | required |
| Global import | OpenMontage skill 대량 import 금지. | deny |
9. PoC 실행 계획
설치 승인 후에도 바로 실무 적용하지 않고 아래 순서로 진행하는 것을 권장합니다.
- Read-only clone: `/opt/data/cowork/OpenMontage`에 격리 clone. Hermes global skill 경로와 분리.
- Runtime pinning: Python 3.11 또는 3.12 venv 권장. 현재 macOS Python 3.14는 일부 패키지 호환 리스크가 있습니다.
- Node validation: 현재 Node 26은 요구조건 18+를 충족하지만 Remotion 호환성 확인 필요.
- Zero-key smoke: `make preflight`, `make demo-list`, local render/demo 중심으로 검증.
- One-provider test: Pexels/Pixabay, Piper TTS, HyperFrames local composition처럼 비용·보안 부담이 낮은 provider부터 적용.
- First business sample: “AIR Studio / AIR TRUST 45초 executive explainer”를 한국어 자막·no paid video generation 기준으로 제작.
10. QA 체계
| 검증 항목 | 방법 | 통과 기준 |
|---|---|---|
| Video structure | ffprobe | duration, codec, resolution, fps, audio stream 정상 |
| Visual quality | frame sampling / contact sheet | black frame, broken asset, layout collapse 없음 |
| Korean text | subtitle/font review | 자막 줄바꿈, tofu/□, overflow 없음 |
| Audio | loudness / silence / sync check | 무음 구간, TTS sync, BGM 볼륨 이상 없음 |
| Source rights | source manifest | stock/video/music attribution 기록 |
| Cost | cost log | 예상 비용 대비 초과 없음 |
| Security | secret scan | API key, token, auth file 노출 없음 |
11. Decision Options
| 옵션 | 설명 | 추천도 |
|---|---|---|
| A. 설치 보류 | 분석 문서만 유지하고 즉시 작업하지 않음 | 중 |
| B. Wrapper skill만 작성 | 설치 전 운영 원칙과 route/gate를 먼저 고정 | 높음 |
| C. 격리 PoC 설치 | 승인 후 read-only clone → zero-key smoke → one-provider test | 높음 |
| D. Hermes 기본 영상 제작기로 편입 | skill 대량 흡수 및 기본 route화 | 낮음 / 비추천 |
| E. 고객 산출물 정식 적용 | 법무·보안·품질 검증 후 제한적 적용 | 조건부 |
12. Recommended Next Step
추천: 다음 단계는 설치가 아니라 hans-openmontage-workflow wrapper skill 초안 작성입니다. 그 후 한스님 승인 시 격리 PoC 설치와 zero-key smoke test를 진행하는 순서가 가장 안전합니다.
Appendix A. 분석 근거
- Repository: https://github.com/calesthio/OpenMontage
- License: AGPL-3.0
- 주요 문서: README.md, AGENT_GUIDE.md, PROJECT_CONTEXT.md, docs/ARCHITECTURE.md, docs/PROVIDERS.md
- 주요 구조: pipeline_defs, skills, .agents, tools, schemas, remotion-composer
- 설치 미수행: clone, make setup, npm install, provider 호출, 영상 생성 미실행
Appendix B. 설치 승인 시 예비 체크리스트
- AGPL-3.0 검토 범위 확정
- PoC 경로:
/opt/data/cowork/OpenMontage - Python version pin: 3.11 또는 3.12
- Node/Remotion compatibility smoke
- zero-key smoke 가능 여부 확인
- provider key 사용 정책 확정
- cost cap 기본값 설정
- Korean subtitle/font QA 기준 설정
- source/copyright manifest template 작성