Einrichtung
Der Nutzer hat das Lab zum ersten Mal geöffnet. Er ist nicht technisch versiert. Am Ende ist alles installiert, ein Look, den er an sich selbst gesehen hat, ausgewählt, und sein eigenes Kit gespeichert. Dann ist er bereit für sein erstes Reel.
Ton: warmherzig, kurz, Schritt für Schritt. Sag, was passiert, während der Nutzer wartet. Gib niemals die rohe Tool-Ausgabe weiter. Bitte den Nutzer nie, einen Befehl auszuführen, außer der einen Homebrew-Zeile, falls sie fehlt (siehe Schritt 1).
Beginne mit einer kurzen Nachricht:
Willkommen im Reels-Editing-Lab. Die Einrichtung dauert etwa 10 Minuten: Ich installiere ein paar Dinge, stelle dir 3 kurze Fragen, und du wählst deinen Look aus, indem du ihn auf deinem eigenen Video siehst. Los geht's.
1. Installieren (≈5 Minuten, hauptsächlich der Download des Sprachmodells)
Führe python3 tools/doctor.py aus. Es gibt eine Checkliste und DOCTOR=ok oder DOCTOR=missing:<Namen> aus. Behebe die fehlenden Elemente in dieser Reihenfolge, führe den Doktor am Ende erneut aus:
- mac / space: Wenn einer davon fehlschlägt, stoppe und erkläre freundlich (Mac mit Apple-Chip nötig; ca. 6 GB frei).
- homebrew: Du kannst es nicht für sie installieren, weil es ihr Mac-Passwort in einem echten Terminal benötigt. Erkläre in einem Satz warum, gib ihnen dann die exakte Zeile aus der Reparatur des Doktors und sage ihnen, sie sollen die Terminal-App öffnen (Cmd+Leertaste, Terminal eingeben), den Befehl einfügen, die Eingabetaste drücken, ihr Mac-Passwort eingeben (während der Eingabe wird nichts angezeigt; das ist normal) und den Anweisungen folgen. Am Ende gibt Homebrew zwei „Next Steps“-Zeilen aus, die mit
echoundevalbeginnen. Bitte sie, auch diese einzufügen. Warte, bis sie sagen, dass es fertig ist, und überprüfe dann erneut. - apple-tools: Führe
xcode-select --installaus. Ein Mac-Fenster erscheint. Sage ihnen, sie sollen auf Installieren klicken und Bescheid sagen, wenn es fertig ist (ein paar Minuten). Homebrew installiert diese normalerweise bereits, also überprüfe zuerst. - ffmpeg:
brew install ffmpeg(verwende/opt/homebrew/bin/brew, wennbrewnoch nicht im Pfad ist). - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh, verwende danach~/.local/bin/uv, wennuvnoch nicht gefunden wird. - python-tools:
uv sync - renderer:
uv run playwright install chromium - speech-model: Führe
uv run tools/get_models.pyim Hintergrund aus (2,3 GB). Es setzt von selbst fort, wenn die Verbindung abbricht. Starte es und fahre dann mit dem Interview fort, während es herunterlädt. Überprüfe vor Schritt 3 noch einmal, ob es fertig ist.
Während die Installation läuft, sage ihnen in einem Satz, wofür jedes Teil ist (die Beschreibungen des Doktors sind dafür geschrieben).
2. Markeninterview (3 Fragen, eine nach der anderen)
Stelle die Fragen konversationell, eine Frage pro Nachricht. Behalte ihre genauen Worte bei.
Frage nicht nach einem Namen, Slogan oder einem „Was machst du“-Label: Das Lab fügt standardmäßig keins hinzu (siehe die Fähigkeit „new-reel“, „label“).
- Energie. „Wie bist du vor der Kamera: ruhig und nachdenklich, warmherzig und gesprächig, oder voller Energie?“ Dies bestimmt, wie dynamisch der Schnitt ist (siehe Tabelle in Schritt 4).
- Marke. „Hast du eine Marken- oder Design-Datei, Markenfarben oder Schriftarten? Wirf deine Design-Datei (eine .md oder PDF) rein und ich baue deinen Look daraus. Oder füge Farbcodes ein, oder wirf 3–6 Screenshots von Reels, deren Look du liebst, in den
inspiration-Ordner. Oder sag einfach ‚nein, zeig mir Optionen‘.“ - Nie. „Gibt es etwas, das du auf deinen Reels nie haben möchtest? Zum Beispiel Großbuchstaben, bestimmte Emojis, Soundeffekte, Wörter, die du nie sagen würdest.“
Speichere die Antworten in brand/profile.md:
# Profil
- Energie: warmherzig und gesprächig
- Marke: Farben #… / Schriftarten … / Screenshots in inspiration/ / keine
- Nie: …
Füge jedes „Nie“ als einzeilige Regel in brand/preferences.md hinzu.
3. Die Looks im eigenen Gesicht sehen
Frage: „Wirf jetzt einen Clip von dir, wie du in die Kamera sprichst, idealerweise 20 Sekunden oder länger, in diesen Chat oder in den inbox-Ordner. Es muss kein perfekter Take sein; er dient nur zum Ausprobieren der Looks.“
Wenn der Clip da ist (und das Sprachmodell fertig ist):
-
uv run tools/transcribe.py "<clip>" --name welcome-sample -
Lese
projects/welcome-sample/lines.md. Schreibecut.jsonmit den ersten 3–5 sauberen Zeilen, etwa 12–20 Sekunden, unter Verwendung der Grobschnitt-Regeln von new-reel (letzter sauberer Take, keine Fehlstarts). Führeuv run tools/roughcut.py projects/welcome-sample --no-openunduv run tools/verify.py projects/welcome-sampleaus und behebe alles, was markiert wird. Bitte sie nicht, diesen Schnitt zu überprüfen; es ist nur ein Beispiel. -
Schreibe
build.jsonwie bei der new-reel-Fähigkeit: Ein Haken, der mit der Fähigkeithooksaus dem tatsächlich Gesagten geschrieben wird (das ist ihr erster Eindruck vom Lab, also mach ihn gut), 1–2 Schlüsselwörter, 1 Zoom und eine Aussage zur stärksten Zeile. Füge 2–4 Pop-ups mit der Fähigkeitvisualshinzu (z. B. Chips für eine Liste, die sie erwähnen, oder ein Chat-Fenster, wenn sie über Prompting sprechen), damit sie sehen, was das Lab wirklich tut. Füge keinen Behind-Moment hinzu. -
Looks-Tabelle:
uv run tools/build.py projects/welcome-sample --looks presets. Es öffnet ein Bild mit ihrem Clip in jedem Look, nebeneinander, in der Reihenfolge, die nachLOOKS=ausgegeben wird. Betrachte das Bild zuerst selbst (lies es) und überprüfe, ob der Text lesbar ist und nichts das Gesicht bedeckt. -
Stelle die Looks in einer kurzen Zeile vor, in der ausgegebenen Reihenfolge, unter Verwendung der
descriptionjedes Kits (packs/<name>/kit.json). Die obere Reihe zeigt den Haken und die Untertitel; die untere Reihe zeigt die Pop-ups. Sage dann deutlich, dass ein Look ein Ausgangspunkt und keine endgültige Wahl ist:Wähle den, dessen Gefühl dir am besten gefällt. Alles kann später geändert werden: „diesen, aber in Salbeigrün und Creme“, „verwende meine Farben: #…“, „eine weichere Schriftart“, „kein Pink“. Ich erstelle es auf deinem Clip neu, damit du es sehen kannst.
Frage, welchen sie bewegt sehen möchten.
-
Für jeden gewählten Look:
uv run tools/build.py projects/welcome-sample --kit <Name> --out sample-<Name>. Es öffnet sich in QuickTime. Wenn sie zwei auswählen, erstelle beide und öffne sie nacheinander.
Wenn sie in Schritt 2 Markenfarben, Schriftarten oder Screenshots angegeben haben, biete auch an: „Oder ich kann einen Look aus deiner Marke machen.“ Siehe Schritt 5.
4. Ihr Kit speichern
Wenn sie sich entscheiden (z. B. „Editorial, aber in Salbeigrün und Creme“ oder „Verspielt, aber ruhiger“):
-
Kopiere
packs/<Voreinstellung>/kit.jsonnachpacks/<vorname-klein>/kit.json. Ändere in der Kopie:"name": ihr Name"preset": false"based_on": "<Voreinstellung>"
-
Wende ihre Energie an:
Energie Intensität Zoom-Sprung / Punch sfx.volume_db Aussagen ruhig und nachdenklich clean 1.04 / 1.08 −17 höchstens 1 warmherzig und gesprächig signature 1.07 / 1.13 −13 höchstens 1–2 voller Energie full 1.12 / 1.22 −10 bis zu 2 Ändere
rules.intensity,zoom,sfx.volume_dbund den Wortlaut vonrules.statemententsprechend.Sound-Set (
sfx.palette):- ruhig:
soft - warm:
softoderplayful - voller Energie:
punchy - Tech- oder KI-Themen:
clickyin Betracht ziehen
Erwähne einmal, dass sie jeden Sound in
sfx/sound-menu.mp4hören und Sets durch Fragen wechseln können („verwende die verspielten Sounds“). Falls sie „keine Soundeffekte“ gesagt haben, setze"sfx": {}. Falls sie keine Großbuchstaben wollten, setzestyle.caption_case,style.hook_caseundstyle.statement_caseauf"none". - ruhig:
-
Wende ihre Farben an, entweder aus dem Interview oder aus dem Moment, in dem sie fragen („verwende stattdessen diese Farben“):
- Aus Hex-Codes oder einfachen Namen: „salbeigrün“ oder „altrosa“ ist in Ordnung; wähle geschmackvolle Hex-Codes aus und teile sie ihnen mit.
- Tausche die Werte in
colorsaus und behalte die Rollen bei: Helle Farben kommen auf Karten und Untertitel, dunkle auf Statement-Hintergründe und Tinte, helle auf Highlights undvisuals.rotate. - Überprüfe den Kontrast: Text muss auf seinem Hintergrund lesbar sein.
- Rendere die Looks-Tabelle neu für ihr Kit (
--looks <ihr-Kit>), damit sie es vor dem vollständigen Beispiel sehen. - Schriftarten funktionieren genauso: Jede kostenlose Google-Schriftart (
fonts.pybestätigt ihre Existenz).
-
Schreibe den Ordnernamen des Kits in
brand/kit.txt. -
Erstelle das Beispiel einmal mehr in ihrem Kit:
uv run tools/build.py projects/welcome-sample --out sample-mine. Es öffnet sich in QuickTime. Frage: „Das ist dein Look. Möchtest du etwas ändern?“ Wende Änderungen an ihrem Kit an (nicht an der Voreinstellung) und erstelle es neu, bis sie zufrieden sind. Kleine Änderungen wie „kleinere Untertitel“, „weniger Gelb“ oder „keine Neigung“ sind einzeilige Bearbeitungen inkit.json.
5. Einen Look aus ihrer Marke erstellen (auf Anfrage)
Aus einer Design-Datei (der beste Weg)
Falls sie eine Marken- oder Design-Datei haben (eine .md, PDF oder Google Doc-Export, wie eine BRAND-DESIGN.md):
-
Hole die Datei. Bitte sie, sie in den Chat zu ziehen oder in
brand/abzulegen, und speichere dann eine Kopie alsbrand/design.md(oder behalte die PDF) als Quelle der Wahrheit für ihren Look. -
Ordne sie ihrem Kit zu:
In der Design-Datei In kit.jsonFarbpalette (Hex-Codes und wofür jede ist) colors, plusroles: Hintergründe →hook_cardundlabel_bg; Textfarbe →inkundhook_text; der „Statement“- oder dunkle Block →statement_bg; Highlight-Farben →highlight_blocks; Akzente →accent_pill,visuals.rotateRegeln wie „nie reines Schwarz oder Weiß“ verwende ihre dunkelste Markenfarbe als Tinte Überschrift- und Anzeigeschriftart fonts.display/poster, ihre kursive Variante alsfonts.italic, eine serifenlose fürlabelund UntertitelCharakteristische Bewegungen (kursive Einmischung, Highlight-Blöcke hinter Wörtern, Neigung, Sticker, Großbuchstaben) movesundstyle(hook_case,statement_case,radius)Stimmung („ruhig“, „verspielt“, „luxuriös“) visuals.motion,visuals.density,sfx.paletteFoto- oder Videostil (warm, stimmungsvoll, hell, filmisch) grade:contrast,saturation,brightness,warmth(−0,05 bis 0,05),vignette(0–0,5),legibility(dunkle Farbverläufe hinter Text, 0–0,5). Halte die Haut natürlich: keine Filmkörnung, keine starke Kompression.Symbole, grafische Elemente, Sticker, Schaltflächen (Linienstärke, abgerundet oder eckig, gefüllte Farbkacheln) visuals.icon_stroke(dünn 1,5 → fett 2,5),visuals.radius,visuals.card(solid / outline / glass),visuals.accent(Symbolkachel-Farbe),visuals.rotate(Chip- und Sticker-Farben) -
Bezahlte oder benutzerdefinierte Schriftarten: Suche nach den Schriftartdateien. Wenn sie welche haben, legen sie sie in
fonts/private/ab und das Kit verwendet"file". Falls nicht, wähle die nächstgelegene kostenlose Google-Schriftart: Stimme den Kontrast, die Breite (groß oder schmal?) und ob eine kursive Variante existiert, ab. Teile ihnen mit, was du ersetzt hast und warum. Zum Beispiel „deine bezahlte Serifenschrift → Instrument Serif: gleiches großes, kontrastreiches Gefühl, hat eine kursive Variante.“ -
Zeige es: Rendere
--looks <ihr-Kit>und erstellesample-mine. Sage, welche Teile direkt aus ihrer Datei stammen und welche du interpretiert hast. -
Halte es synchron: Wenn sie die Design-Datei später aktualisieren („Ich habe meine Markenfarben geändert“), lies
brand/design.mderneut und aktualisiere das Kit auf die gleiche Weise.
Aus Screenshots oder eingefügten Farben
Wenn sie ihren eigenen Look anstelle einer Voreinstellung möchten:
- Lese ihre Screenshots in
inspiration/, ihren Markenleitfaden oder die von ihnen eingefügten Codes. Notiere:- Art: Serife oder serifenlos, wie fett, ob alles Großbuchstaben ist, ob eine kursive Variante gemischt wird
- Untertitel-Behandlung: Umriss, Schatten oder Box; ganze Phrase oder Wort für Wort
- Kartenformen und Radius
- 4–6 Farben
- wie vollgestopft es ist
- Beginne mit der nächsten Voreinstellung und ändere nur, was abweicht. Schriftarten müssen kostenlose Google-Schriftarten sein: Schreibe
{"family": "<Google-Schriftart-Name>", "google": true, "weight": N}(füge"italic": truefür eine kursive Variante hinzu). Bestätige jeden Download mituv run tools/fonts.py "<Schriftartname>" --weight N. Wenn sie eine kostenpflichtige Schriftart besitzen, können sie die Datei infonts/private/ablegen und{"family": "...", "file": "fonts/private/<Datei>", "weight": N}verwenden. - Kopiere nicht die exakten Schriftarten und Farben eines anderen Erstellers. Übernimm das Gefühl, nicht den markenrechtlich geschützten Look.
- Rendere
--looks <ihr-Kit>zur Überprüfung, erstelle dannsample-minewie in Schritt 4 und iteriere im Chat.
6. Abschluss
Erkläre in etwa 3 Zeilen:
-
ihr Look ist gespeichert und jedes Reel wird ihn automatisch verwenden
-
wie man ein Reel bearbeitet: Wirf einen Clip in
inbox/oder den Chat und sage „bearbeite dieses Reel“. Du schneidest es, sie überprüfen die Zeilen im Chat, und du erstellst es in ihrem Look. -
dass Pop-up-Grafiken veranschaulichen, was sie sagen; „zeig mir die Grafiken“ spielt den Katalog aller 14 in ihrem Look ab
-
optionale Extras: Wirf 6 ihrer eigenen Reels in den Chat für den „Reels umkreisen dich“-Effekt und das Profilraster (
tools/reels.py add); gib einmal ihre echten Instagram-Zahlen an (gespeichert inbrand/instagram.json) für die Follow-Animation -
dass sie nach einem Meme oder GIF zu einer beliebigen Zeile fragen können („der David Rose ‚ew‘-Meme hier“). Die Suche benötigt einen kostenlosen GIPHY-Key, den du beim ersten Mal besorgst; ihre eigenen GIF-Dateien funktionieren sofort
-
dass Farben und Schriftarten nie festgelegt sind: „verwende stattdessen diese Farben“ funktioniert bei jedem Reel, jederzeit
-
dass sie jederzeit alles ändern können, indem sie es einfach sagen („Untertitel kleiner“, „bei diesem keine Sounds“, „probier den lauten Look bei diesem Reel“)
-
dass fertige Reels im Ordner Fertige Reels landen
-
die Befehle: /new-reel für einen neuen Clip (starte für jedes Reel einen neuen Chat in diesem Ordner), /update für neue Versionen und /report-problem, falls etwas kaputt geht
Dann biete an: „Möchtest du den gesamten Clip, den du mir gerade gegeben hast, als dein erstes richtiges Reel bearbeiten?“ Falls ja, führe die new-reel-Fähigkeit darauf in diesem Chat aus.
Stil-Schalter für das Kit (für Anpassungen)
kit.json → "style":
caption_outline: px; 0 bedeutet nur ein Schattencaption_case: "none" / "uppercase"hook: "card" / "bare" (keine Karte, Text mit Umriss)hook_sizehook_casestatement_caselabel: "ticket" / "pill"label_mark: das Symbol zwischen Name und Themaradiusshadow/shadow_soft: rgba-Farben
"captions":
mode: "karaoke" (Wörter leuchten auf), "phrase" (ganze Phrase), "word" (ein großes Wort nach dem anderen)sizemax_wordsposition_y
"moves":
tilt_degreeshighlighter_blocks