pipeline-de-renderizado-remotion
Convierte la composición en un MP4 entregado.
Disparadores
remotion-composition-builderinformaready: true.- El usuario dice "renderízalo" / "entrégalo" con un trabajo conocido.
Entradas
jobIdcomposition— ID que coincide consrc/Root.tsx(p.ej.Explainer)outputPath— relativo aremotion-studio/output/props— props de entrada completas (marca + storyboard + ...) como JSONlinear—{teamId, projectId}para el enrutamiento del ticket
Método
- Verificación de tipos previa —
cd remotion-studio && npx tsc --noEmit. En rojo, devuelve aremotion-composition-buildercon el error. - Síntesis de voz en off —
render/voiceover.tsescribe MP3 por escena enpublic/audio/{jobId}/scene-N.mp3(dentro depublic/para questaticFile()los resuelva). Usa clave de cachésha1(voiceId|style|text). Se omite si faltaELEVENLABS_API_KEY— la composición debe renderizarse igualmente solo con texto en pantalla. - Renderizado —
npx tsx render/render.ts --comp={composition} --out={outputPath} --props='{...}' --jobId={jobId}. Se envuelve en un timeout de 600s; un reintento en caso de bloqueo/fallo. - Validación — el archivo existe, duración ±0.5s de la esperada, códec
h264, resolución coincide con la composición, tamaño <100MB. - Entrega:
- Subir a bucket de Supabase
remotion-renders— URL firmada, retención de 90 días. - Telegram vía
app.server.telegram_video.send_telegram_video()(el util compartido). Si el archivo >45MB, enviar el enlace de la URL firmada en lugar de subida inline (el límite de Telegram es 50MB). - Abrir ticket en Linear en
{teamId}/{projectId}con: URL del renderizado, resumen de la fuente, versión de BrandConfig (git sha desrc/brands/{slug}.ts), ruta del archivo de composición.
- Subir a bucket de Supabase
- Estado — escribir resumen en
.research/renders/{jobId}.json.
Salida
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"mp4Path": "remotion-studio/output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"supabaseUrl": "https://<project>.supabase.co/storage/v1/object/sign/remotion-renders/...",
"telegramSent": true,
"linearIssue": "RA-2049",
"validation": { "durationSec": 60.0, "codec": "h264", "resolution": "1920x1080", "sizeMB": 12.4 }
}
Límites
- Nunca ejecutar el renderizado con
tsc --noEmitfallando — desperdicia 2-5 minutos para una salida garantizadamente mala. - Nunca fusionar automáticamente el PR fuente (cambios de composición + marca) antes de que la verificación del renderizado pase.
- Nunca subir renderizados con
[DRAFT]horneado al bucket de la marca — los borradores van aremotion-drafts.
Escalado de fallos
- Timeout / bloqueo → matar, reintentar una vez → si segundo fallo, abrir Linear con
priority: 2, adjuntar stderr. - Fallo de validación (duración/códec incorrectos) → Linear
priority: 3con diff vs esperado. - Fallo de Telegram → recurrir a
send_telegram_document()con.mp4como adjunto.
Reutilizados
render/render.tsrender/voiceover.tsapp/server/telegram_video.py(util compartido)config/harness/projects.jsonpara resolución de equipo/proyecto de Linear
Claves de API por proyecto
Este skill se invoca desde dentro del proyecto llamante (Synthex, Pi-SEO, RestoreAssist, cualquier lugar). Cada proyecto suministra sus propias claves a través de su propio .env / .env.local. El skill nunca lee claves de Pi-Dev-Ops.
Variables de entorno requeridas o advertidas en tiempo de renderizado:
ELEVENLABS_API_KEY— síntesis de voz en off. Si falta = renderizado silencioso solo con texto en pantalla (se registra advertencia, el renderizado continúa).TELEGRAM_BOT_TOKEN,TELEGRAM_CHAT_ID— entrega por Telegram. Si faltan = saltar paso de Telegram (el MP4 sigue llegando al disco y a Supabase si está configurado).SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY— subida con URL firmada. Si faltan = saltar paso de Supabase.LINEAR_API_KEY— creación de ticket. Si falta = saltar paso de Linear.REMOTION_LICENSE_KEY— requerida para cualquier renderizado comercial bajo la licencia fair-source de Remotion.
Patrón de invocación desde un shell de proyecto:
cd ~/Pi-CEO/Synthex
source .env.local # claves del proyecto
cd ~/Pi-Dev-Ops/remotion-studio
npx tsx render/render.ts \
--comp=Explainer \
--out=$OLDPWD/.remotion-renders/synthex-launch.mp4 \
--jobId=synthex-launch-$(date +%s) \
--props='{"brand":"synthex","hookSec":8,"ctaSec":8,"storyboard":[...]}'
O invocar a través de la API del orquestador de Pi-Dev-Ops que hereda el entorno del proyecto llamante en el momento de crear la sesión.
Convención de salida: escribir el MP4 en <proyecto-llamante>/.remotion-renders/ (gitignorado) por defecto — mantiene los artefactos de cada proyecto en su propio árbol. Sobrescribir con --out=....