Instalar tu fábrica

Al acabar: Instalar el plugin de la fábrica, dejar que /fabrica:instalar ponga todas las piezas y terminar con el doctor sin nada en rojo.
Duración: 3:30
Ahora tú: 60 min

La Fábrica · turno de noche@tarritoai

El vídeo del loteEn Hotmart · enlace pendiente

Pasos por sistema

Esta página tiene pasos distintos para Mac, Windows y Linux. Elige tu sistema arriba y verás solo los tuyos.

Antes de empezar

Lotes 1·1 y 1·3 hechos: la carpeta fabrica (vacía) y Claude Code con tu suscripción. 15 GB libres recomendados (el instalador para con menos de 8 GB y avisa por debajo de 15): la instalación ocupa unos 3,4 GB y descarga unos 1,5 GB. La computadora enchufada. Tarda entre 30 y 60 minutos, casi todo esperando descargas.

Pasos

Paso 1
Actualiza Claude Code.
El plugin necesita una versión reciente. En la terminal (fuera de Claude Code):
En la terminal
```
claude update
```
Lo que verás
Un mensaje de que ya estás al día o de que se actualizó. Si se actualizó, cierra la terminal y abre una nueva.
Paso 2
Abre Claude Code dentro de tu carpeta.
En Mac
En la terminal
```
cd ~/fabrica && claude
```
En Windows
En la terminal
```
cd $HOME\fabrica; claude
```
En Linux
En la terminal
```
cd ~/fabrica && claude
```
Lo que verás
El recuadro de Claude Code con la ruta de tu carpeta fabrica.
Paso 3
Instala el plugin de la fábrica.
Dentro de Claude Code, pega esta línea entera, con la barra del principio, y Enter. La barra importa: sin ella, Claude cree que le estás hablando.
Dentro de Claude Code
```
/plugin install fabrica --marketplace tarritoai/fabrica
```
Lo que verás
La primera vez te pide confirmar que añades el marketplace tarritoai/fabrica: elige que sí. Después, un aviso de que el plugin está instalado. Si te pide /reload-plugins, escríbelo.
Paso 4
Plan B para las actualizaciones automáticas.
El propio /fabrica:instalar te lo pregunta al final («¿Quieres que tu fábrica reciba los arreglos del curso sola?»): contesta que sí. Solo si falla, o no te lo preguntó, hazlo a mano. Los plugins de fuera de Anthropic vienen con las actualizaciones apagadas. Escribe /plugin, ve a la pestaña Marketplaces con las flechas, elige tarritoai/fabrica y pulsa Enable auto-update. Así recibes los arreglos sin hacer nada.
Dentro de Claude Code
```
/plugin
```
Lo que verás
Un panel con pestañas en inglés. «Marketplaces» es la lista de tiendas; «Enable auto-update», activar actualizaciones automáticas.
Paso 5
Lanza el instalador.
Cuando pregunte dónde instalar, contesta «Aquí, en esta carpeta». La carpeta tiene que estar vacía; si no, sale carpeta-no-vacia (mueve fuera lo que haya, o elige la que te propone).

En Mac

Si no tienes Homebrew, te propondrá instalarlo y te pedirá la contraseña de tu Mac (al escribirla no se ven las letras: es normal). También puede pedirte instalar Rosetta para Rhubarb.

En Windows

Instala con winget. Después de cada programa, Windows necesita una terminal nueva para verlo: si algo «no se reconoce», cierra, abre otra terminal, cd $HOME\fabrica; claude y escribe «sigue con la instalación». El antivirus puede hacerlo ir lento: es normal.

En Linux

No pide contraseña de administrador (sudo). Todo se instala dentro de tu carpeta personal. Guiado en Ubuntu 22.04+, Debian 12+ y Mint 21+.
Dentro de Claude Code
```
/fabrica:instalar
```
Lo que verás
Claude mira tu sistema y va pieza por pieza: Blender (el 3D), ffmpeg (el vídeo), uv (Python), Node (el montaje), whisper (comprobar las voces) y Rhubarb (los labios). Copia la plantilla de la fábrica en tu carpeta y descarga un modelo de unos 470 MB. Antes de cada orden te pide permiso: 1. Yes. Al final te pregunta si quieres las actualizaciones automáticas: sí.
Paso 6
Pasa el doctor.
Cuando el instalador acabe, sal con /exit y vuelve a entrar con claude (así carga todo lo nuevo). Pídele la revisión: puedes escribir «pasa el doctor» en Claude Code o, fuera de Claude Code, esto en la terminal:
En la terminal
```
uv run reels doctor
```
Lo que verás
Una línea por pieza: ✔ en verde si está bien, ! en amarillo si es un aviso, ✘ en rojo si falta. Al final: «✔ Todo listo. Siguiente paso: uv run reels humo». Lo normal la primera vez es un aviso amarillo de .env (tus claves): todavía no hace falta.
Paso 7
Deja que decida tu horno.
Dentro de Claude Code, pide: «Pasa la prueba de horno: uv run reels doctor --prueba-render». También vale la orden en la terminal, fuera de Claude Code. Tarda unos minutos (cuece 5 fotogramas a calidad final); si pasa de 2 minutos, Claude Code la deja en segundo plano y avisa. El resultado queda en episodes/humo/benchmark.json y lo reutiliza el lote 3·3.
En la terminal
```
uv run reels doctor --prueba-render
```
Lo que verás
Cuece unos fotogramas de prueba y te dice cuánto tardaría un reel de 30 s en tu máquina. Por ejemplo, en una laptop sin gráfica dedicada medimos ~22 s por fotograma: «un reel de 30 s tardaría ~330 min». Con ese dato te recomienda horno local o alquilado.
Paso 8
Comprueba.
Dentro de Claude Code
```
/tarrito comprobar 1·4
```
Lo que verás
APROBADO: «Taller montado. Todas las piezas en su sitio.» Es el primer sello del curso. Mira que exista .fabrica/plantilla.json y que uv run reels doctor --skip-api --json no tenga ninguna pieza en «falta». Si falla, repite /fabrica:instalar (lo que ya está hecho no se repite).

Si te sale esto

Unknown command: /plugin

Qué significa. Tu Claude Code es antiguo.

Qué hacer. Sal con /exit, ejecuta claude update, abre una terminal nueva y vuelve al paso 2.
✘ … (en rojo en el doctor)

Qué significa. Falta esa pieza o no se encuentra.

Qué hacer. No pegues a mano las órdenes de la flecha del doctor (son para quien instala a mano). Repite el paso de /fabrica:instalar que toca esa pieza, o pregunta a /fabrica:tarrito con el error entero (lote 1·2).
Mac pide las herramientas de Apple (`xcode-select`)Mac

Qué significa. Falta una herramienta de Apple que necesita el instalador.

Qué hacer. Pega esta orden en Terminal (puede pedir la contraseña del Mac: no se ve al escribirla, es normal) y repite el paso del instalador.
En la terminal
```
xcode-select --install
```
Executable not found in $PATH: "git" (plugin-sin-git)

Qué significa. Falta git.

Qué hacer. Instálalo como en el lote 1·3 y repite el paso 3.
unknown option '--marketplace' (plugin-version-vieja)

Qué significa. Tu Claude Code es antiguo.

Qué hacer. Sal con /exit, ejecuta claude update y repite.
Unknown skill: fabrica:instalar (skill-no-existe)

Qué significa. Claude Code aún no cargó el plugin recién instalado.

Qué hacer. Escribe /reload-plugins y repite.
carpeta-no-vacia

Qué significa. La carpeta fabrica ya tiene otros archivos: la fábrica necesita una carpeta para ella sola.

Qué hacer. Mueve fuera lo que haya o elige la carpeta que te propone el instalador.
sin-conexion

Qué significa. Se cortó la descarga.

Qué hacer. Repite el paso; sigue donde se quedó.
Bad CPU type in executableMac

Qué significa. Rhubarb (los labios) está hecho para Mac Intel y tu Mac con chip Apple necesita Rosetta para usarlo.

Qué hacer. Instala Rosetta (puede pedir la contraseña del Mac) y vuelve a pasar el doctor.
En la terminal
```
softwareupdate --install-rosetta --agree-to-license
```
«rhubarb» no se puede abrir porque no se puede verificar el desarrolladorMac

Qué significa. El Mac bloquea un programa descargado que no está firmado.

Qué hacer. Pulsa «Hecho» (no «Mover a la papelera»), quítale la cuarentena a la carpeta de herramientas de tu fábrica y vuelve a pasar el doctor.
En la terminal
```
xattr -dr com.apple.quarantine ~/fabrica/tools
```
winget : The term 'winget' is not recognized…Windows

Qué significa. A tu Windows le falta el «Instalador de aplicación» (App Installer).

Qué hacer. Abre Microsoft Store, busca «Instalador de aplicación» (App Installer), instálalo o actualízalo, y abre una terminal nueva.
ffmpeg 6.1 (necesita 7 o más)Linux

Qué significa. Ubuntu 24.04 trae un ffmpeg antiguo al que le falta un filtro de audio que usa la fábrica.

Qué hacer. Deja que el instalador ponga su ffmpeg propio dentro de tu carpeta personal (no toca el del sistema). El doctor te da la orden.
! ANTHROPIC_API_KEY está definida

Qué significa. La trampa del lote 1·3. Claude Code cobraría por uso.

Qué hacer. Vuelve al lote 1·3, error «sk-ant-», y quítala.

¿No está tu error? Mira Me he atascado y copia el error entero (lote 1·2).

Qué es cada pieza (para que no asuste la lista)

Pieza	Qué hace en tu fábrica
Blender	Monta y cuece la escena 3D. Nunca lo abres tú: lo maneja la fábrica por código.
ffmpeg	Junta audio y vídeo, corta y convierte.
uv	Pone Python y las piezas de la fábrica, cada una en su versión.
Node	Hace funcionar Remotion, que monta el vídeo final con subtítulos.
whisper	Escucha cada voz generada y comprueba que dice lo que pone el guion.
Rhubarb	Lee la voz y mueve la boca de tus personajes.

Todo esto es gratis. Lo único que cuesta dinero en la fábrica son las voces (ElevenLabs) y, si lo eliges, el horno alquilado. Y la suscripción de Claude, que ya tienes.

Si tu computadora no tiene gráfica dedicada

Funciona igual. Lo que cambia es el render final: en tu máquina puede tardar horas. Para eso está el horno alquilado (sala 9), que cuesta céntimos por reel. Mientras aprendes, las pruebas en calidad baja van bien en local.

Orden

01·4

Aprobado

Tiempo60min

Ahora tú

Entregable: La fábrica instalada con /fabrica:instalar y reels doctor sin nada en rojo (y su prueba de render, que decide tu horno).
Lo que mira /tarrito comprobar: Que uv run reels doctor --skip-api salga bien.