
ReelMimic이란?
ReelMimic은 참조 동영상이 어떻게 제작되었는지 분석하고, 그 기법을 사용해 새로운 오리지널 2D 애니메이션을 만드는 오픈 소스 도구입니다. 로컬 파일, 휴대폰으로 촬영한 영상 또는 YouTube 링크를 제공한 다음, 만들고 싶은 동영상을 짧은 설명으로 작성할 수 있습니다.
이 프로젝트는 숏 수, 숏 길이, 편집 리듬, BPM, 전환, 구도, 색상, 카메라 움직임 등의 요소를 분석합니다. 그런 다음 스토리보드, 캐릭터, 에셋, 샘플 스타일 프레임으로 구성된 제작 계획을 제시하여 검토와 승인을 받을 수 있습니다.
ReelMimic은 참조 동영상의 제작 기법을 학습합니다. 영상, 캐릭터, 로고 또는 기타 에셋을 복사하지 않습니다.



제작 워크플로 작동 방식
계획을 승인하면 ReelMimic은 여러 AI 에이전트에 제작 작업을 나눕니다. 최대 6개의 에이전트가 동영상의 서로 다른 부분을 동시에 작업할 수 있습니다. 완성된 각 숏은 별도의 에이전트에게 검토를 위해 전달되므로, 숏을 만든 에이전트가 자신의 작업을 평가하지 않습니다.
검토자가 문제를 발견하면 해당 숏은 수정 단계로 돌아갑니다. 수정 과정에는 검토자가 확인할 수 있는 수정 전후 스크린샷이 포함됩니다. 인터페이스에서는 에이전트 활동, 명령, 검사한 프레임 및 전체 로그도 확인할 수 있습니다.

주요 기능
- 참조 분석: 타이밍, 전환, 색상, 구도, 카메라 움직임 및 관련 스타일 요소를 분석합니다.
- 계획 우선 워크플로: 렌더링을 시작하기 전에 스토리보드, 캐릭터, 에셋 및 스타일 프레임을 검토하고 논의할 수 있습니다.
- 병렬 AI 에이전트: 여러 에이전트에 제작의 서로 다른 부분을 배정합니다.
- 독립 검토: 품질 확인을 위해 각 숏을 제작자가 아닌 다른 에이전트에게 보냅니다.
- 근거 기반 수정: 수정 전후 스크린샷을 기록합니다.
- 시간 기반 피드백: 완성된 동영상에서 특정 초로 이동한 뒤 메모를 첨부할 수 있습니다.
- Markdown 기반 스타일: 각 스타일을 코드 대신 Markdown 파일로 정의합니다.
- 다국어 인터페이스: 영어, 번체 중국어 및 간체 중국어를 지원합니다.
지원되는 출력 스타일과 제한 사항
ReelMimic은 현재 2D 애니메이션에 초점을 맞추고 있습니다. 실제 인물이 등장하는 실사 영상을 생성하지 않습니다.
7개의 드로잉 엔진은 다음과 같습니다.
- HyperFrames 기반 벡터 및 모션 그래픽
- painted-animation 기반 손그림 수채화
- 크레용 그림책 아트
- 픽셀 아트
- 종이 콜라주 스톱 모션
- 화이트보드 낙서
- 애니메이션 셀 애니메이션
README에 따르면 새로 추가된 5개의 엔진은 벡터 및 수채화 엔진보다 실제 사용 사례가 적습니다. 참조 영상이 알려진 스타일과 일치하지 않으면 ReelMimic은 가장 가까운 엔진을 선택하고 새로운 스타일을 위한 제안서를 준비합니다.
30~60초 분량의 동영상은 일반적으로 계획 승인 후 약 1~3.5시간이 걸립니다. 수채화와 크레용 출력은 브러시로 프레임을 그리기 때문에 대체로 더 느립니다.
사전 요구 사항
ReelMimic을 설정하기 전에 다음 도구를 설치하고 구성하세요.
- Node.js 22.18 이상
- Python 3.10 이상
- FFmpeg
- Google Chrome
- 인증된 계정이 있는 Claude Code 또는 Codex CLI
이 프로젝트는 주로 Windows에서 테스트되었습니다. macOS와 Linux에서도 작동할 수 있지만 테스트 횟수는 적습니다.
ReelMimic 설치
macOS 또는 Linux에 설치
저장소를 복제하고 해당 디렉터리로 이동한 다음 설치 프로그램을 실행하고 애플리케이션을 시작하세요.
git clone https://github.com/edenfunf/reelmimic.git && cd reelmimic
./install.sh
./start.shWindows에 설치
저장소를 복제하거나 다운로드하세요. 프로젝트 폴더에서 install.bat을 두 번 클릭한 다음 start.bat을 두 번 클릭합니다.
설치 스크립트는 필수 소프트웨어를 확인하고 누락된 항목을 알려줍니다. 나중에 이 진단 확인을 다시 실행하려면 다음 명령을 실행하세요.
cd app
npm run doctorClaude Code는 저장소에 포함된 스킬을 자동으로 검색합니다. Codex는 제공된 AGENTS.md 파일을 읽으므로 어느 쪽도 ReelMimic 전용 에이전트 설정을 추가로 요구하지 않습니다.
웹 인터페이스 열기
ReelMimic을 시작한 후 브라우저에서 http://localhost:4318을 여세요. 포트 4318이 기본값이며 ReelMimic 설정에서 변경할 수 있습니다.

첫 번째 동영상 만들기
- 참조 자료를 추가합니다. 홈 페이지에 동영상을 끌어 놓거나 지원되는 링크를 붙여넣습니다.
- 요청서를 작성합니다. ReelMimic이 만들기를 원하는 원본 동영상을 설명합니다. README에서 설명하는 의도된 작업 흐름은 상세한 기술 사양보다 간결한 요청을 사용하는 방식입니다.
- AI 도구를 선택합니다. 인증된 Claude Code 또는 Codex 설치를 선택합니다.
- 분석을 기다립니다. ReelMimic이 참조 자료를 분석하고 제안된 제작 계획을 준비합니다.
- 계획을 검토합니다. 제작을 시작하기 전에 스토리보드, 캐릭터, 에셋 및 스타일 프레임을 확인합니다.
- 변경을 요청합니다. 채팅 패널을 사용해 제안 내용을 수정합니다. 스크린샷을 입력으로 제공할 수도 있습니다.
- 요청된 자료를 제공합니다. 계획에서 가사와 같은 자료를 요청하면 추가하거나 건너뛰도록 선택합니다.
- 제작을 시작합니다. 계획이 준비되면 Approve and start를 선택합니다.
요청서 예시
간단한 요청으로 주제와 원하는 결과를 설명하고, 참조 자료가 제작의 표현 방식과 흐름을 제시하도록 할 수 있습니다.
참조 동영상의 속도감과 구도를 활용해 목욕 시간을 피하려는 고양이에 관한 30초 분량의 독창적인 애니메이션 이야기를 만들어 주세요.이는 시작점으로 활용해야 합니다. 더 긴 제작 과정에 들어가기 전에 검토 단계에서 캐릭터, 에셋, 시각적 방향 또는 이야기 세부 사항을 명확히 할 수 있습니다.
제작 모니터링 및 검토
렌더링이 시작되면 Production line 탭을 엽니다. 이 탭에는 각 캐릭터와 동영상 세그먼트의 상태 및 검토용 스크린샷이 표시됩니다. 어떤 에이전트가 실행되었는지, 어떤 프레임을 검토했는지, 전체 제작 로그를 확인할 수 있습니다.
Claude Code 또는 Codex 계정의 사용량 한도에 도달하면 작업이 일시 중지됩니다. 다시 사용 가능해지면 중단된 지점부터 재개할 수 있습니다.
완성된 동영상에 의견 남기기
동영상이 완성되면 주의가 필요한 순간으로 이동해 해당 타임스탬프에 메모를 입력합니다. 여러 메모를 모아 한 번에 제출할 수 있으므로, 관찰할 때마다 전체 창작 과정을 다시 시작하지 않아도 됩니다.
키, 경로 및 동시성 구성
ReelMimic은 API 키와 선택한 도구 경로를 다음 위치에 저장합니다.
~/.reelmimic/secrets.json이 파일은 저장소 외부에 있으므로 프로젝트와 함께 비밀 정보가 커밋되는 것을 방지하는 데 도움이 됩니다. 형식은 저장소의 secrets.example.json을 참고하세요.
사용 가능한 설정
YATING_KEY: Yating 대만 만다린 내레이션 음성을 활성화합니다.PIXABAY_KEY및FREESOUND_KEY: 사용이 허가된 이미지, 음악 및 음향 효과를 위한 추가 소스를 제공합니다. Openverse는 키 없이도 작동하므로 선택 사항입니다.FFMPEG_DIR: 시스템 경로에서 FFmpeg를 사용할 수 없을 때 FFmpeg의 위치를 지정합니다.CHROME_PATH: ReelMimic이 Chrome 실행 파일을 사용하도록 경로를 지정합니다.CODEX_BIN: Codex 실행 파일을 지정합니다.PYTHON: Python 실행 파일을 지정합니다.CODEX_SANDBOX: Codex 샌드박싱을 제어합니다. 기본값은danger-full-access입니다. README에서는workspace-write가 Chrome 렌더러를 차단한다고 경고합니다.BUILDERS: 하나의 동영상에서 동시에 작업하는 에이전트 수를 제어합니다. 기본값은 6입니다.MAX_AGENTS: 모든 프로젝트에서 동시에 실행할 수 있는 에이전트 수를 제한합니다. 기본값은 12입니다.PORT: 기본값4318에서 웹 포트를 변경합니다.
고급 작업 흐름 팁
렌더링 전에 계획 다듬기
렌더링에는 몇 시간이 걸릴 수 있으므로 계획 단계에서 명확한 이야기, 캐릭터, 에셋 및 스타일 문제를 해결하세요. 옆의 채팅과 스크린샷을 사용해 구체적인 변경 사항을 전달한 다음, 스토리보드와 샘플 프레임이 의도와 일치할 때만 승인합니다.
동시성은 보수적으로 선택하기
에이전트가 많으면 작업을 나눌 수 있지만, 모든 활동은 Claude Code 또는 Codex 계정의 사용량에 포함됩니다. 처음에는 기본 제한을 유지하고 리소스 및 계획 사용량을 모니터링한 뒤, 필요한 경우에만 BUILDERS 또는 MAX_AGENTS를 조정하세요.
환경 변경 후 진단 검사 사용하기
Node.js, Python, FFmpeg, Chrome, Claude Code 또는 Codex를 업데이트했다면 app 디렉터리에서 npm run doctor를 다시 실행하세요. 실행 파일이 설치되어 있지만 시스템 경로에서 사용할 수 없는 경우 secrets.json에 도구 경로를 명시하면 도움이 될 수 있습니다.
애플리케이션 코드를 변경하지 않고 스타일 확장하기
ReelMimic은 Markdown 파일을 통해 스타일을 정의합니다. 스타일, 렌더링 엔진 또는 다른 AI 통합을 추가하기 전에 저장소의 확장 관련 문서를 확인하세요. 아키텍처 문서에서는 런타임 동작, 파일 위치 및 AI 도구가 시스템에 연결되는 방식을 설명합니다.
출처와 권리 존중하기
ReelMimic은 온라인에서 찾은 자료의 출처, 작성자 및 라이선스를 기록하고 불분명한 라이선스에 플래그를 표시합니다. 가사는 사용자가 제공한 텍스트에서 가져와야 하며, 도구가 상업용 노래를 다운로드하지는 않습니다. 입력 자료를 사용하고 결과 동영상을 게시할 권리가 있는지 확인하는 책임은 사용자에게 있습니다.
결론
ReelMimic은 동영상의 창작 기법을 새로운 2D 애니메이션으로 전환할 수 있는 로컬 기반의 검토 중심 작업 흐름을 제공합니다. 계획을 먼저 수립하는 과정, 병렬 제작 에이전트, 독립적인 장면 검토, 가시적인 로그 및 타임스탬프 기반 피드백을 통해 단일 단계 생성 방식보다 결과를 더 세밀하게 제어할 수 있습니다. 짧은 참조 자료와 명확한 요청서로 시작하고, 제안된 계획을 꼼꼼히 검토하며, 에이전트가 결과를 제작하고 확인하는 동안 계정 사용량을 모니터링하세요.
