Ayuda / Instalación y solución de problemas
Solución de problemas
¿Funcionará en mi Mac? Memoria, chip, disco y tiempos de render de cada Mac con Apple Silicon, en una sola página.
Cuando Phosphene rechaza un render, te dice por qué y qué hacer. Estos son los mensajes que la gente ve de verdad. Para problemas durante la Instalación o la Actualización (una línea FATAL error: en Pinokio, falta de espacio en disco), consulta Instalación, actualización y espacio en disco.
Memoria y el nivel de este Mac
El indicador de estado del encabezado muestra la memoria de un vistazo; haz clic en él para ver las filas Nivel, Memoria, Helper, Modelos, Cola y Render. Haz clic en Nivel para ver qué puede ejecutar este Mac.
- “Helper killed by the OS - out of memory”: macOS detuvo el render. Cierra las apps que consumen mucha memoria (navegadores, Slack, el simulador de iOS) e inténtalo de nuevo, o cambia la Calidad a Rápida, que usa más o menos la mitad de la memoria.
- “Image pre-flight: … needs a N GB Mac”: ese motor de imágenes no cabe en este Mac. En Mac con 16 GB o menos, Automático usa FLUX.2 [klein] 4B cuando el motor de Configuración necesita un Mac más grande, sin cambiar la Configuración. Esto exige un render sin imágenes de referencia; quita las referencias para que Automático use Klein, o elige un motor más ligero en Configuración. ”… needs ~N GB free” significa que el motor cabe, pero ahora mismo la memoria está en uso; esta comprobación ya tiene en cuenta la memoria que macOS puede liberar y las necesidades reales de memoria de Automático.
- “Training needs at least 24 GB of memory”: el entrenamiento de personajes no puede ejecutarse en este Mac.
Hailuo H3 en un Mac de 16 a 60 GB
El motor completo de H3 necesita 60 GB. Desde 16 GB se ejecuta con su motor compacto Q8, que se crea una vez en tu Mac (por debajo de 36 GB lee el modelo desde tu disco mientras renderiza):
- H3 aún no instalado: en Pinokio, abre Phosphene en la barra lateral y haz clic en Install Hailuo H3 (second video engine, ~75 GB). La instalación crea el motor compacto al final por sí sola (unos 5 minutos más).
- H3 instalado, falta el motor compacto - “Hailuo H3 runs on this Mac - on its reduced-RAM lane … it is not built here yet”: haz clic en Build Hailuo H3 compact engine en la misma barra lateral (~5 minutos, sin descarga).
Ambas entradas están en la barra lateral mientras el panel se está ejecutando.
Haz esto y luego elige en Configuración → Modelo Hailuo H3 → Automático o Compacto. Por debajo de 16 GB, H3 no está disponible: renderiza con LTX, que cubre todos los modos.
Falta descargar un modelo o complemento
- “Enhance needs its language model, Gemma 3 (8.1 GB)” y lo mismo para los adaptadores: en una instalación nueva se descargan en segundo plano tras el primer Start. El mensaje indica si se está descargando, está en cola o espera espacio en disco; Download now lo descarga de inmediato.
- “Extend needs the LTX-2.5 High add-on (the Q8 model), which isn’t downloaded on this Mac yet”: lo mismo para Fotogramas clave y la calidad Alta. Instálalo desde la ventana Modelos (haz clic en el indicador de estado y luego en Modelos).
- “Upscale & Face Fix needs the LTX-2.5 Pixel Spatial Upscaler adapter”: descárgalo desde la ventana Modelos y vuelve a renderizar.
- “Stopped before rendering - the model weights are incomplete”: se interrumpió una descarga. Abre la ventana Modelos y reanúdala. En Configuración, Verificar archivos del modelo revisa cada archivo y ofrece volver a descargar los que estén dañados.
La actualización se detiene enseguida
En algunos Mac, la Actualización de Pinokio en versiones anteriores a la 4.19.7 se detenía en el primer segundo: el terminal de Pinokio leía las palabras “error:” del propio texto de comandos de la actualización como un fallo (#114). Pinokio ejecuta el script de actualización de la versión que ya tienes, así que la corrección solo puede aplicarse después de una actualización.
Actualiza una vez desde dentro de Phosphene: haz clic en Actualizar ahora en su aviso de actualización (o en la etiqueta de versión del encabezado), espera a que indique que la actualización ha terminado y reinicia. O abre un terminal en la carpeta de Phosphene (~/pinokio/api/<your Phosphene folder>), ejecuta git pull y pulsa Update en Pinokio otra vez: entonces ejecuta el script nuevo y corregido. Después de eso, el botón funciona.
“Click Update”: un motor más antiguo que el panel
“This install’s vendored engine predates LTX-2.5’s text encoder … Click Update - and if the first click only moves the panel, click it once more.”
El panel se actualizó, pero el motor que tiene debajo no. Haz clic en Update en la barra lateral de Phosphene en Pinokio. Si parece que no pasa nada, haz clic una segunda vez: una actualización iniciada por una versión antigua se actualiza primero a sí misma. En el caso de H3, “the installed Hailuo H3 runner is behind this panel” significa: vuelve a ejecutar Install Hailuo H3; se conservan todos los modelos que ya están en el disco.
Si actualizaste y el panel sigue comportándose como la versión anterior, es que todavía ejecuta el código antiguo. Entonces la etiqueta de versión del encabezado dice Restart Phosphene: haz clic en ella, o haz clic en Stop y luego en Start en Pinokio.
El vigilante de la GPU
“the macOS GPU watchdog killed a Metal command buffer”: el propio macOS detuvo una tarea de la GPU que duraba demasiado. Es una interrupción a nivel de controlador, no un error de Phosphene, y es más frecuente en los Mac M1 y M2. Phosphene renderiza el mismo trabajo otra vez, una sola vez y enseguida, en pasos cortos de GPU (piezas más pequeñas de trabajo de GPU, algo más lentas), y recuerda el tamaño: su siguiente render en este Mac empieza ya en pasos cortos, y la fila Cola lo indica. Si macOS lo detiene incluso en pasos cortos, ese tamaño queda en pausa en este Mac durante 24 horas (o hasta la siguiente actualización) y la tarjeta ofrece Reintentar más pequeño. Si sigue ocurriendo, el mensaje enlaza al issue de GitHub donde más ayudan el chip, la versión de macOS y el registro del fallo.
Falló un entrenamiento de personaje
“training exited with code 1”: el entrenador se detuvo antes de terminar. Mira la pestaña Registro para ver el motivo real: un cierre por falta de memoria (cambia a un Mac con más RAM, o a un ajuste más pequeño si existe), una descarga de entrenamiento de LTX-2.3 que falta (la propia tarjeta de comprobación previa de la pestaña Entrenar la ofrece) o un tiempo de espera al codificar una descripción muy larga. El entrenamiento con menos de 24 GB siempre falla: ese Mac no puede ejecutarlo.
El panel dice que está sin conexión
“Phosphene offline”, y al pulsar Generar no pasa nada: el proceso del panel no responde. No pierdes nada de lo que estabas escribiendo: el prompt se queda como lo dejaste, y la página se reconecta y retoma la cola por sí sola en cuanto el panel vuelve a funcionar. Si no vuelve en unos segundos, inicia el panel desde la barra lateral de Phosphene en Pinokio.
La cola se pausó sola
“Queue paused: the last N renders failed the same way”: cuando fallan tres renders seguidos por el mismo problema, Phosphene deja de gastar el resto de la cola en algo que un reintento no puede arreglar. Corrige la causa que indica el mensaje y pulsa Reanudar; o Vaciar cola para descartar el resto y empezar de nuevo.
La cola tras un reinicio
Al reiniciar el panel se retoma la cola: una cola que estaba en pausa cuando el panel se detuvo vuelve a arrancar por sí sola, y el registro lo indica.
Leer el registro
La pestaña Registro del panel inferior muestra el registro del render. Cuando un render se interrumpe, la última línea que empieza por step: indica la etapa a la que llegó; esa línea es lo más útil que puedes incluir en un reporte. El Terminal de Pinokio muestra la misma salida.
Reportar un problema
El botón del bicho en el encabezado abre Reportar un error. Escribe una o dos frases en ¿Qué pasó? (necesita al menos 10 caracteres: el registro no puede decir lo que viste); se rellenan la versión, los datos de tu Mac y el registro reciente, con las líneas de error por delante de las rutinarias, y se abre un issue de GitHub en una pestaña nueva para que lo termines: no se envía nada hasta que lo envíes allí. Los issues están en github.com/mrbizarro/phosphene/issues.
Fuente: webapp/docs/troubleshooting.md en el repositorio público. Revisado para este sitio web antes de publicarse. Traducido del original en inglés. Sugerir un cambio.