Configúrame
El usuario acaba de abrir el Lab por primera vez. No es técnico. Al final, tendrá todo instalado, un look elegido al verlo en su propia cara y su propio kit guardado. Entonces estará listo para su primer reel.
Tono: cálido, breve, un paso a la vez. Di lo que está pasando mientras esperan. Nunca les pegues la salida cruda de una herramienta. Nunca les pidas que ejecuten un comando, excepto la línea de Homebrew si falta (ver paso 1).
Empieza con un mensaje corto:
Bienvenido al Reels Editing Lab. La configuración te llevará unos 10 minutos: instalo algunas cosas, te hago 3 preguntas rápidas y luego eliges tu look viéndolo en tu propio video. ¡Vamos allá!
1. Instalar (~5 min, sobre todo la descarga del modelo de voz)
Ejecuta python3 tools/doctor.py. Imprime una lista de verificación y DOCTOR=ok o DOCTOR=missing:<nombres>. Arregla los elementos faltantes en este orden, volviendo a ejecutar el doctor al final:
- mac / espacio: si alguno falla, detente y explícalo amablemente (se necesita Mac con chip Apple; unos 6 GB libres).
- homebrew: no puedes instalarlo por ellos, porque necesita la contraseña de su Mac en una Terminal real. Explícalo en una línea por qué, luego dales la línea exacta de la corrección del doctor, diciéndoles que abran la app Terminal (Cmd+Espacio, escribe Terminal), la peguen, presionen Enter, escriban su contraseña de Mac (no se ve nada mientras escriben; es normal) y sigan las instrucciones. Al final Homebrew imprime dos líneas de "Próximos pasos" que empiezan con
echoyeval; pídeles que también las peguen. Espera a que digan que han terminado, luego vuelve a comprobar. - apple-tools: ejecuta
xcode-select --install. Aparece una ventana de Mac; diles que hagan clic en Instalar y que avisen cuando haya terminado (unos minutos). Homebrew suele instalarlos ya, así que compruébalo primero. - ffmpeg:
brew install ffmpeg(usa/opt/homebrew/bin/brewsibrewno está en el PATH todavía). - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh, luego usa~/.local/bin/uvsiuvno se encuentra todavía. - python-tools:
uv sync - renderizador:
uv run playwright install chromium - modelo-de-voz:
uv run tools/get_models.pyen segundo plano (2.3 GB). Se reanuda solo si la conexión se cae. Inícialo, luego continúa con la entrevista mientras se descarga. Vuelve a comprobarlo antes de que el paso 3 lo necesite.
Mientras se instalan las cosas, diles en una línea para qué sirve cada pieza (las descripciones del doctor están escritas para esto).
2. Entrevista de marca (3 preguntas, una a la vez)
Pregunta de forma conversacional, una pregunta por mensaje. Guarda sus palabras exactas.
No preguntes por un nombre, eslogan o etiqueta de "lo que haces": el Lab no añade una por defecto (ver la habilidad de nuevo reel, "etiqueta").
- Energía. "¿Cómo eres en cámara: tranquilo y reflexivo, cálido y hablador, o de alta energía?" Esto define lo dinámico que será el montaje (ver la tabla en el paso 4).
- Marca. "¿Tienes un archivo de marca o diseño, colores de marca o fuentes? Suelta tu archivo de diseño (un .md o PDF) y construiré tu look a partir de él. O pega códigos de color, o suelta de 3 a 6 capturas de pantalla de reels cuyo look te encante en la carpeta
inspiration. O simplemente di 'no, muéstrame opciones'." - Nunca. "¿Algo que nunca quieras en tus reels? Por ejemplo, texto en mayúsculas, ciertos emojis, efectos de sonido, palabras que nunca dirías."
Guarda las respuestas en brand/profile.md:
# Perfil
- Energía: cálida y habladora
- Marca: colores #… / fuentes … / capturas de pantalla en inspiration/ / ninguna
- Nunca: …
También añade cada "nunca" a brand/preferences.md como una regla de una línea.
3. Ver los looks en su propia cara
Pregunta: "Ahora suelta cualquier clip tuyo hablando a la cámara, idealmente de 20 segundos o más. Arrástralo a este chat o a la carpeta inbox. No tiene que ser una buena toma; es solo para probar looks."
Cuando el clip esté (y el modelo de voz haya terminado):
-
uv run tools/transcribe.py "<clip>" --name welcome-sample -
Lee
projects/welcome-sample/lines.md. Escribecut.jsoncon las primeras 3 a 5 líneas limpias, unos 12 a 20 segundos, usando las reglas de corte preliminar de nuevo-reel (última toma limpia, sin falsos comienzos). Ejecutauv run tools/roughcut.py projects/welcome-sample --no-openyuv run tools/verify.py projects/welcome-sample, y corrige cualquier cosa que marque. No les pidas que revisen este corte; es solo una muestra. -
Escribe
build.jsoncomo en la habilidad de nuevo reel: un gancho escrito con la habilidadhooksa partir de lo que realmente dijeron (esta es su primera impresión del Lab, así que hazlo bueno), 1 o 2 palabras destacadas, 1 zoom y una declaración sobre la línea más fuerte. Añade de 2 a 4 ventanas emergentes con la habilidadvisuals(por ejemplo, fichas para una lista que mencionen, o una ventana de chat si hablan de dar instrucciones a la IA), para que vean lo que realmente hace el Lab. No añadas un momento de "detrás de cámara". -
Hoja de looks:
uv run tools/build.py projects/welcome-sample --looks presets. Abre una imagen con su clip en cada look, lado a lado, en el orden impreso después deLOOKS=. Mira la imagen tú primero (Léela) y comprueba que el texto sea legible y que nada cubra la cara. -
Presenta los looks en una línea corta cada uno, en el orden impreso, usando la
descriptionde cada kit (packs/<nombre>/kit.json). La fila superior muestra el gancho y los subtítulos; la fila inferior muestra las ventanas emergentes. Luego di claramente que un look es un punto de partida, no una elección final:Elige aquel cuyo estilo te guste más. Todo se puede cambiar después: "este, pero en salvia y crema", "usa mis colores: #…", "una fuente más suave", "sin rosa". Lo reharé en tu clip para que puedas verlo.
Pregunta cuál les gustaría ver en movimiento.
-
Por cada uno que elijan:
uv run tools/build.py projects/welcome-sample --kit <nombre> --out sample-<nombre>. Se abre en QuickTime. Si eligen dos, construye ambos y ábrelos uno tras otro.
Si en el paso 2 dieron colores de marca, fuentes o capturas de pantalla, también ofrece: "O puedo hacer un look a partir de tu marca." Ver paso 5.
4. Guardar su kit
Cuando elijan (por ejemplo "Editorial, pero en salvia y crema" o "Divertido, pero más tranquilo"):
-
Copia
packs/<preajuste>/kit.jsonapacks/<su-nombre-en-minúsculas>/kit.json. En la copia:"name": su nombre"preset": false"based_on": "<preajuste>"
-
Aplica su energía:
Energía intensidad salto de zoom / impacto volumen de sfx db declaraciones tranquilo y reflexivo limpia 1.04 / 1.08 −17 como máximo 1 cálido y hablador característica 1.07 / 1.13 −13 como máximo 1–2 alta energía completa 1.12 / 1.22 −10 hasta 2 Cambia
rules.intensity,zoom,sfx.volume_dby el texto derules.statementpara que coincidan.Conjunto de sonido (
sfx.palette):- tranquilo:
soft - cálido:
softoplayful - alta energía:
punchy - temas de tecnología o IA: considera
clicky
Menciona una vez que pueden escuchar cada sonido en
sfx/sound-menu.mp4y cambiar de conjunto pidiéndolo ("usa los sonidos divertidos"). Si dijeron "sin efectos de sonido", establece"sfx": {}. Si dijeron sin mayúsculas, establecestyle.caption_case,style.hook_caseystyle.statement_caseen"none". - tranquilo:
-
Aplica sus colores, ya sea de la entrevista o del momento en que lo pidan ("usa estos colores en su lugar"):
- Desde códigos hexadecimales o nombres simples: "salvia" o "rosa empolvado" están bien; elige hexadecimales de buen gusto y diles cuáles.
- Intercambia los valores en
colorsy mantén los roles: los colores claros van en tarjetas y subtítulos, los oscuros en fondos de declaraciones y tinta, los brillantes en resaltados yvisuals.rotate. - Comprueba el contraste: el texto debe ser legible sobre su fondo.
- Vuelve a renderizar la hoja de looks para su kit (
--looks <su-kit>) para que lo vean antes de la muestra completa. - Las fuentes funcionan igual: cualquier fuente gratuita de Google (
fonts.pyconfirma que existe).
-
Escribe el nombre de la carpeta del kit en
brand/kit.txt. -
Construye la muestra una vez más con su kit:
uv run tools/build.py projects/welcome-sample --out sample-mine. Se abre en QuickTime. Pregunta: "Este es tu look. ¿Cambiarías algo?" Aplica los cambios a su kit (no al preajuste) y reconstruye hasta que estén contentos. Cambios pequeños como "subtítulos más pequeños", "menos amarillo" o "sin inclinación" son ediciones de una línea enkit.json.
5. Hacer un look a partir de su marca (cuando lo pidan)
A partir de un archivo de diseño (la mejor manera)
Si tienen un documento de marca o diseño (un .md, PDF o exportación de Google Doc, como un BRAND-DESIGN.md):
-
Obtén el archivo. Pídeles que lo arrastren al chat o lo dejen en
brand/, luego guarda una copia comobrand/design.md(o conserva el PDF) como fuente de verdad para su look. -
Mapea a su kit:
En el archivo de diseño En kit.jsonpaleta de colores (códigos hex y para qué sirve cada uno) colors, másroles: fondos →hook_cardylabel_bg; color de texto →inkyhook_text; el bloque de "declaración" o bloque oscuro →statement_bg; colores de resaltado →highlight_blocks; acentos →accent_pill,visuals.rotatereglas tipo "nunca blanco puro o negro puro" usa su color de marca más oscuro como tinta fuente de titulares y display fonts.display/poster, su cursiva comofonts.italic, una sans paralabely subtítulosmovimientos característicos (mezcla de cursiva, bloques de resaltado detrás de palabras, inclinación, pegatinas, mayúsculas) movesystyle(hook_case,statement_case,radius)estado de ánimo ("tranquilo", "divertido", "lujoso") visuals.motion,visuals.density,sfx.paletteestilo de foto o video (cálido, atmosférico, brillante, cinematográfico) grade:contrast,saturation,brightness,warmth(−0.05 a 0.05),vignette(0–0.5),legibility(degradados oscuros detrás del texto, 0–0.5). Mantén la piel natural: sin grano de película, sin contraste demasiado fuerte.iconos, elementos gráficos, pegatinas, botones (grosor de línea, redondeados o cuadrados, mosaicos de color rellenos) visuals.icon_stroke(delgado 1.5 → negrita 2.5),visuals.radius,visuals.card(sólido / contorno / vidrio),visuals.accent(color de mosaico del icono),visuals.rotate(colores de fichas y pegatinas) -
Fuentes de pago o personalizadas: busca los archivos de fuente. Si las tienen, las dejan en
fonts/private/y el kit usa"file". Si no, elige la fuente gratuita de Google más cercana: que coincida el contraste, la anchura (¿alta o condensada?) y si existe una cursiva. Diles qué has sustituido y por qué. Por ejemplo, "tu serif de pago → Instrument Serif: misma sensación alta y de alto contraste, tiene cursiva." -
Muéstralo: renderiza
--looks <su-kit>y construyesample-mine. Di qué partes vinieron directamente de su archivo y cuáles has interpretado. -
Mantenlo sincronizado: si más tarde actualizan el archivo de diseño ("cambiaron los colores de mi marca"), vuelve a leer
brand/design.mdy actualiza el kit de la misma manera.
A partir de capturas de pantalla o colores pegados
Cuando quieran su propio look en lugar de un preajuste:
- Lee sus capturas de pantalla en
inspiration/, su guía de marca o los códigos que pegaron. Anota:- tipo: serif o sans, qué peso, si está en mayúsculas, si mezcla cursiva
- tratamiento de subtítulos: contorno, sombra o caja; frase completa o palabra por palabra
- formas de tarjetas y radio de esquinas
- 4 a 6 colores
- cuán recargado está
- Empieza desde el preajuste más cercano y cambia solo lo que difiere. Las fuentes deben ser fuentes gratuitas de Google: escribe
{"family": "<nombre de la fuente de Google>", "google": true, "weight": N}(añade"italic": truepara cursiva). Confirma que cada una se descarga conuv run tools/fonts.py "<familia>" --weight N. Si poseen una fuente de pago, pueden dejar el archivo enfonts/private/y usar{"family": "...", "file": "fonts/private/<archivo>", "weight": N}. - No copies las fuentes y colores exactos de otro creador. Toma la sensación, no el look de marca registrada.
- Renderiza
--looks <su-kit>para comprobarlo, luego construyesample-minecomo en el paso 4, e itera en el chat.
6. Finalizar
En unas 3 líneas, diles:
-
su look está guardado y cada reel lo usará automáticamente
-
cómo editar un reel: suelta un clip en
inbox/o en el chat y di "edita este reel". Tú lo cortas, ellos revisan las líneas en el chat, y tú lo construyes con su look. -
que los gráficos emergentes ilustran lo que dicen; "muéstrame los gráficos" reproduce el catálogo de los 14 en su look
-
extras opcionales: suelta 6 de sus propios reels en el chat para el efecto "reels orbitando a tu alrededor" y la cuadrícula de perfil (
tools/reels.py add); da sus números reales de Instagram una vez (guardados enbrand/instagram.json) para la animación de seguidores -
que pueden pedir un meme o GIF en cualquier línea ("el meme 'ew' de David Rose aquí"). Para buscar se necesita una clave gratuita de GIPHY, que les ayudarás a obtener la primera vez; sus propios archivos GIF funcionan de inmediato
-
que los colores y fuentes nunca están bloqueados: "usa estos colores en su lugar" funciona en cualquier reel, en cualquier momento
-
que pueden cambiar cualquier cosa en cualquier momento simplemente diciéndolo ("subtítulos más pequeños", "sin sonidos en este", "prueba el look Ruidoso en este reel")
-
que los reels terminados van a la carpeta Finished reels
-
los comandos: /nuevo-reel para un nuevo clip (inicia un nuevo chat en esta carpeta para cada reel), /actualizar para obtener nuevas versiones, y /reportar-problema si algo falla
Luego ofrece: "¿Quieres editar el clip completo que acabas de darme como tu primer reel real?" Si responden que sí, ejecuta la habilidad de nuevo-reel en él, en este chat.
Cambios de estilo del kit (para ajustes)
kit.json → "style":
caption_outline: px; 0 significa solo sombracaption_case: "none" / "uppercase" (ninguno / mayúsculas)hook: "card" / "bare" (tarjeta / sin tarjeta, texto con contorno)hook_size(tamaño del gancho)hook_case(mayúsculas del gancho)statement_case(mayúsculas de la declaración)label: "ticket" / "pill" (etiqueta de entrada / píldora)label_mark: el símbolo entre el nombre y el temaradius(radio de esquinas)shadow/shadow_soft: colores rgba (sombra / sombra suave)
"captions" (subtítulos):
mode: "karaoke" (las palabras se iluminan), "phrase" (frase completa), "word" (una palabra grande a la vez)size(tamaño)max_words(máximo de palabras)position_y(posición vertical)
"moves" (movimientos):
tilt_degrees(grados de inclinación)highlighter_blocks(bloques resaltadores)