설정하기
사용자가 연구소를 처음 열었습니다. 사용자는 기술에 익숙하지 않습니다. 과정이 끝나면 모든 것이 설치되고, 자신의 얼굴로 확인한 스타일과 자신만의 키트가 저장됩니다. 그럼 첫 번째 릴을 만들 준비가 됩니다.
어조: 따뜻하고, 간결하며, 한 번에 한 단계씩. 기다리는 동안 무슨 일이 일어나고 있는지 알려주세요. 절대 가공되지 않은 도구 출력물을 그대로 보여주지 마세요. 절대 사용자에게 명령어를 실행하라고 요청하지 마세요. (단, Homebrew가 누락된 경우 한 줄 명령어는 예외입니다. 1단계 참조)
한 줄의 짧은 메시지로 시작하세요:
Reels 편집 연구소에 오신 것을 환영합니다. 설정하는 데 약 10분이 소요됩니다: 몇 가지를 설치하고, 3가지 간단한 질문을 한 다음, 사용자의 동영상에서 직접 스타일을 선택합니다. 시작해 볼까요.
1. 설치 (약 5분, 대부분 음성 모델 다운로드)
python3 tools/doctor.py를 실행하세요. 체크리스트와 DOCTOR=ok 또는 DOCTOR=missing:<이름>을 출력합니다. 다음 순서대로 누락된 항목을 수정하고, 마지막에 doctor를 다시 실행하세요:
- mac / space: 둘 중 하나라도 실패하면 중단하고 친절하게 설명하세요(Apple 칩 Mac 필요, 약 6 GB 여유 공간).
- homebrew: 사용자를 대신해 설치할 수 없습니다. 실제 터미널에서 Mac 비밀번호가 필요하기 때문입니다. 이유를 한 줄로 설명한 다음, doctor의 수정 항목에서 정확한 명령줄을 알려주고 Terminal 앱(Cmd+Space, Terminal 입력)을 열고, 붙여넣고, Enter를 누르고, Mac 비밀번호를 입력하라고 하세요(입력하는 동안 아무 것도 표시되지 않는 것은 정상입니다). 프롬프트를 따르라고 하세요. 마지막에 Homebrew가
echo와eval로 시작하는 두 줄의 "다음 단계"를 출력하면, 그것도 붙여넣으라고 하세요. 완료했다고 말할 때까지 기다린 후 다시 확인하세요. - apple-tools:
xcode-select --install을 실행하세요. Mac 창이 나타나면 설치를 클릭하고 완료되면 알려달라고 하세요(몇 분 소요). Homebrew가 보통 이미 설치하므로 먼저 확인하세요. - ffmpeg:
brew install ffmpeg(brew가 아직 PATH에 없으면/opt/homebrew/bin/brew사용). - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh, 그런 다음uv가 아직 발견되지 않으면~/.local/bin/uv를 사용하세요. - python-tools:
uv sync - renderer:
uv run playwright install chromium - speech-model:
uv run tools/get_models.py를 백그라운드에서 실행하세요(2.3 GB). 연결이 끊기면 자동으로 다시 시작됩니다. 시작한 후 인터뷰로 넘어가서 다운로드되는 동안 기다리세요. 3단계에서 필요하기 전에 다시 확인하세요.
설치하는 동안 각 기능이 무엇을 위한 것인지 한 줄로 설명하세요(doctor의 설명이 이를 위해 작성되었습니다).
2. 브랜드 인터뷰 (질문 3개, 한 번에 하나씩)
대화하듯이 질문하고, 메시지당 하나의 질문을 하세요. 사용자의 정확한 답변을 그대로 유지하세요.
이름, 태그라인 또는 "무엇을 하는지" 레이블을 묻지 마세요: 연구소는 기본적으로 추가하지 않습니다(새 릴 스킬, "레이블" 참조).
- 에너지. "카메라 앞에서 어떤 스타일인가요: 차분하고 사려 깊게, 따뜻하고 수다스럽게, 아니면 고에너지로?" 이는 편집의 활기를 설정합니다(4단계 표 참조).
- 브랜드. "브랜드나 디자인 파일, 브랜드 색상 또는 폰트가 있나요? 디자인 파일(.md 또는 PDF)을 드롭하면 스타일을 만듭니다. 또는 색상 코드를 붙여넣거나,
inspiration폴더에 마음에 드는 릴 스크린샷 3-6장을 드롭하세요. 또는 '아니요, 옵션을 보여주세요'라고 말하세요." - 절대. "릴에 절대 넣고 싶지 않은 것이 있나요? 예를 들어 대문자 텍스트, 특정 이모지, 사운드 효과, 절대 하지 않을 말 등."
답변을 brand/profile.md에 저장하세요:
# 프로필
- 에너지: 따뜻하고 수다스럽게
- 브랜드: 색상 #… / 폰트 … / inspiration/의 스크린샷 / 없음
- 절대: …
또한 각 "절대" 항목을 brand/preferences.md에 한 줄 규칙으로 추가하세요.
3. 자신의 얼굴에서 스타일 확인하기
물어보세요: "이제 카메라를 보고 말하는 클립 하나를 드롭해 주세요. 이상적으로는 20초 이상입니다. 이 채팅이나 inbox 폴더로 드래그하세요. 좋은 테이크일 필요는 없습니다. 단지 스타일을 시험해보기 위한 것입니다."
클립이 들어오고 음성 모델이 완료되면:
-
uv run tools/transcribe.py "<clip>" --name welcome-sample -
projects/welcome-sample/lines.md를 읽으세요. 처음 3-5개의 깔끔한 라인, 약 12-20초로cut.json을 작성하세요. 새 릴 러프 컷 규칙(마지막 깔끔한 테이크, 잘못된 시작 없음)을 사용하세요.uv run tools/roughcut.py projects/welcome-sample --no-open및uv run tools/verify.py projects/welcome-sample을 실행하고 플래그가 지정된 항목을 수정하세요. 이 컷을 검토하도록 요청하지 마세요. 샘플일 뿐입니다. -
새 릴 스킬처럼
build.json을 작성하세요: 사용자가 실제로 말한 내용에서hooks스킬로 작성된 훅(연구소의 첫인상이므로 좋게 만드세요), 1-2개의 하이라이트 단어, 1개의 줌, 가장 강력한 라인에 대한 하나의 명제문.visuals스킬로 2-4개의 팝업을 추가하세요(예: 사용자가 언급한 목록의 칩, 프롬프팅에 대해 말하면 채팅 창). 연구소가 실제로 하는 일을 보여주기 위함입니다. 비하인드 모먼트는 추가하지 마세요. -
스타일 시트:
uv run tools/build.py projects/welcome-sample --looks presets를 실행하세요. 모든 스타일의 사용자 클립이 나란히,LOOKS=다음에 인쇄된 순서대로 있는 이미지 하나가 열립니다. 먼저 이미지를 직접 보고(읽기) 텍스트를 읽을 수 있고 얼굴을 가리지 않는지 확인하세요. -
각 스타일을 인쇄된 순서대로, 각 키트의
description(packs/<name>/kit.json)을 사용하여 한 줄씩 간략히 소개하세요. 위쪽 행은 훅과 자막을 보여주고 아래쪽 행은 팝업을 보여줍니다. 그런 다음 스타일은 최종 선택이 아니라 시작점임을 명확히 말하세요:가장 마음에 드는 느낌을 선택하세요. 모든 것은 나중에 변경할 수 있습니다: "이거지만, 세이지와 크림 색상으로", "내 색상 사용: #…", "더 부드러운 폰트", "분홍색 없음". 클립에서 다시 만들어서 볼 수 있도록 해드립니다.
어떤 것을 움직이는 것으로 보고 싶은지 물어보세요.
-
사용자가 선택한 각 스타일에 대해:
uv run tools/build.py projects/welcome-sample --kit <name> --out sample-<name>을 실행하세요. QuickTime에서 열립니다. 두 개를 선택하면 둘 다 빌드하고 하나씩 엽니다.
2단계에서 브랜드 색상, 폰트 또는 스크린샷을 제공한 경우 "또는 브랜드에서 스타일을 만들 수도 있습니다"라고 제안하세요. 5단계를 참조하세요.
4. 키트 저장하기
사용자가 선택하면 (예: "Editorial, 하지만 세이지와 크림 색상으로" 또는 "Playful, 하지만 더 차분하게"):
-
packs/<preset>/kit.json을packs/<사용자이름-소문자>/kit.json으로 복사하세요. 복사본에서:"name": 사용자 이름"preset": false"based_on": "<preset>"
-
사용자의 에너지를 적용하세요:
에너지 강도 줌 점프 / 펀치 sfx 음량_db 명제문 수 차분하고 사려 깊게 clean 1.04 / 1.08 −17 최대 1 따뜻하고 수다스럽게 signature 1.07 / 1.13 −13 최대 1–2 고에너지 full 1.12 / 1.22 −10 최대 2 rules.intensity,zoom,sfx.volume_db및rules.statement문구를 일치하도록 변경하세요.사운드 세트 (
sfx.palette):- 차분:
soft - 따뜻함:
soft또는playful - 고에너지:
punchy - 기술 또는 AI 주제:
clicky고려
모든 사운드는
sfx/sound-menu.mp4에서 들을 수 있고 "playful 사운드 사용"이라고 말하여 세트를 전환할 수 있다고 한 번 언급하세요. "사운드 효과 없음"이라고 말한 경우"sfx": {}로 설정하세요. 대문자 없음이라고 말한 경우style.caption_case,style.hook_case및style.statement_case를"none"으로 설정하세요. - 차분:
-
인터뷰 또는 요청 시점의 색상을 적용하세요 ("이 색상 대신 사용"):
- 16진수 코드 또는 일반 이름에서: "sage" 또는 "dusty pink"도 괜찮습니다. 세련된 16진수를 선택하고 알려주세요.
colors의 값을 바꾸고 역할을 유지하세요: 밝은 색은 카드와 자막에, 어두운 색은 명제문 배경과 잉크에, 밝은 색은 하이라이트와visuals.rotate에 사용합니다.- 대비 확인: 텍스트가 배경에서 읽을 수 있어야 합니다.
- 키트의 스타일 시트를 다시 렌더링하세요 (
--looks <their-kit>) 전체 샘플 전에 사용자가 볼 수 있도록. - 폰트도 동일하게 작동합니다: 무료 Google Font라면 모두 가능합니다 (
fonts.py가 존재를 확인합니다).
-
키트의 폴더 이름을
brand/kit.txt에 쓰세요. -
사용자의 키트로 샘플을 한 번 더 빌드하세요:
uv run tools/build.py projects/welcome-sample --out sample-mine. QuickTime에서 열립니다. 물어보세요: "이것이 당신의 스타일입니다. 바꾸고 싶은 것이 있나요?" 변경 사항을 키트(프리셋 아님)에 적용하고 사용자가 만족할 때까지 다시 빌드하세요. "자막 더 작게", "노란색 덜", "기울기 없음"과 같은 작은 변경은kit.json에서 한 줄 편집입니다.
5. 브랜드에서 스타일 만들기 (요청 시)
디자인 파일에서 (가장 좋은 방법)
사용자에게 브랜드 또는 디자인 문서(.md, PDF 또는 Google Doc 내보내기, 예: BRAND-DESIGN.md)가 있는 경우:
-
파일을 가져오세요. 사용자에게 채팅으로 드래그하거나
brand/에 드롭하도록 요청한 다음, 스타일의 진실 공급원으로brand/design.md(또는 PDF 유지) 사본을 저장하세요. -
키트에 매핑하세요:
디자인 파일에서 kit.json에서색상 팔레트(16진수 코드 및 각각의 용도) colors, 추가로roles: 배경 →hook_card및label_bg, 텍스트 색상 →ink및hook_text, "명제문" 또는 어두운 블록 →statement_bg, 하이라이트 색상 →highlight_blocks, 악센트 →accent_pill,visuals.rotate"순수 검정이나 흰색은 절대 사용하지 않음" 유형 규칙 가장 어두운 브랜드 색상을 잉크로 사용 헤드라인 및 디스플레이 폰트 fonts.display/poster, 이탤릭체 →fonts.italic, 산세리프 →label및 자막시그니처 무브(이탤릭 혼합, 단어 뒤 하이라이트 블록, 기울기, 스티커, 모두 대문자) moves및style(hook_case,statement_case,radius)분위기 ("차분", "발랄", "럭셔리") visuals.motion,visuals.density,sfx.palette사진 또는 비디오 스타일(따뜻함, 무드 있음, 밝음, 필름 느낌) grade:contrast,saturation,brightness,warmth(−0.05 ~ 0.05),vignette(0–0.5),legibility(텍스트 뒤 어두운 그라데이션, 0–0.5). 피부는 자연스럽게 유지: 필름 그레인, 과도한 크러쉬 금지.아이콘, 그래픽 요소, 스티커, 버튼(선 두께, 둥글기 또는 사각형, 채워진 색상 타일) visuals.icon_stroke(얇은 1.5 → 굵은 2.5),visuals.radius,visuals.card(solid / outline / glass),visuals.accent(아이콘 타일 색상),visuals.rotate(칩 및 스티커 색상) -
유료 또는 커스텀 폰트: 폰트 파일을 찾으세요. 사용자가 있으면
fonts/private/에 드롭하고 키트가"file"을 사용합니다. 없으면 가장 가까운 무료 Google Font를 선택하세요: 대비, 너비(키가 크거나 좁은지?), 이탤릭체 존재 여부를 일치시키세요. 대체한 폰트와 그 이유를 알려주세요. 예: "유료 세리프 → Instrument Serif: 동일한 키가 크고 대비가 강한 느낌, 이탤릭체 있음." -
보여주세요:
--looks <their-kit>를 렌더링하고sample-mine을 빌드하세요. 파일에서 직접 가져온 부분과 해석한 부분을 말하세요. -
동기화 유지: 나중에 사용자가 디자인 파일을 업데이트하면("브랜드 색상을 바꿨어요"),
brand/design.md를 다시 읽고 같은 방식으로 키트를 업데이트하세요.
스크린샷 또는 붙여넣은 색상에서
사용자가 프리셋 대신 자신만의 스타일을 원할 때:
inspiration/의 스크린샷, 브랜드 가이드 또는 붙여넣은 코드를 읽으세요. 다음을 기록하세요:- 유형: 세리프 또는 산세리프, 두께, 모두 대문자 여부, 이탤릭 혼합 여부
- 자막 처리: 윤곽선, 그림자 또는 상자; 전체 구문 또는 단어별
- 카드 모양 및 둥글기
- 4–6가지 색상
- 얼마나 복잡한지
- 가장 가까운 프리셋에서 시작하여 다른 점만 변경하세요. 폰트는 무료 Google Fonts여야 합니다:
{"family": "<Google Font name>", "google": true, "weight": N}(이탤릭체의 경우"italic": true추가). 각 폰트가uv run tools/fonts.py "<family>" --weight N으로 다운로드되는지 확인하세요. 유료 폰트를 소유한 경우 파일을fonts/private/에 드롭하고{"family": "...", "file": "fonts/private/<file>", "weight": N}을 사용할 수 있습니다. - 다른 제작자의 정확한 폰트와 색상을 복사하지 마세요. 느낌을 취하되 상표가 있는 스타일은 피하세요.
- 확인을 위해
--looks <their-kit>를 렌더링한 다음 4단계와 같이sample-mine을 빌드하고 채팅에서 반복하세요.
6. 마무리
약 3줄로 다음을 알려주세요:
- 스타일이 저장되었으며 모든 릴에서 자동으로 사용됩니다.
- 릴을 편집하는 방법:
inbox/또는 채팅에 클립을 드롭하고 "이 릴을 편집해 줘"라고 말하세요. 사용자가 자르고, 채팅에서 라인을 검토하고, 사용자의 스타일로 빌드합니다. - 팝업 그래픽이 사용자가 말하는 내용을 설명합니다. "그래픽 보여줘"라고 하면 스타일의 모든 14개 그래픽 카탈로그가 재생됩니다.
- 선택 사항: "reels orbiting you" 효과와 프로필 그리드(
tools/reels.py add)를 위해 사용자 자신의 릴 6개를 채팅에 드롭하세요. 팔로우 애니메이션을 위해 실제 Instagram 숫자를 한 번 제공하세요(brand/instagram.json에 저장됨). - 어떤 라인이든 밈이나 GIF를 요청할 수 있음("여기에 David Rose 'ew' 밈 넣어 줘"). 검색하려면 무료 GIPHY 키가 필요하며, 처음에는 도움을 드릴 것입니다. 사용자 자신의 GIF 파일은 즉시 작동합니다.
- 색상과 폰트는 절대 잠겨 있지 않습니다: "이 색상 대신 사용"은 어떤 릴에서든, 언제든지 작동합니다.
- 언제든지 말만 하면 무엇이든 변경할 수 있음("자막 더 작게", "이번 거는 소리 없이", "이번 릴은 Loud 스타일 시도해 봐").
- 완성된 릴은 Finished reels 폴더에 저장됩니다.
- 명령어: 새 클립용 /new-reel(각 릴마다 이 폴더에 새 채팅 시작), 새 버전을 얻으려면 /update, 문제가 발생하면 /report-problem.
그런 다음 제안하세요: "방금 주신 전체 클립을 첫 번째 실제 릴로 편집해 볼래요?" 예인 경우 이 채팅에서 새 릴 스킬을 실행하세요.
키트 스타일 스위치 (조정용)
kit.json → "style":
caption_outline: px; 0은 그림자만 의미caption_case: "none" / "uppercase"hook: "card" / "bare" (카드 없음, 윤곽선 텍스트)hook_sizehook_casestatement_caselabel: "ticket" / "pill"label_mark: 이름과 주제 사이의 기호radiusshadow/shadow_soft: rgba 색상
"captions":
mode: "karaoke" (단어가 빛남), "phrase" (전체 구문), "word" (한 번에 하나의 큰 단어)sizemax_wordsposition_y
"moves":
tilt_degreeshighlighter_blocks