Pro
ES
Iniciar sesiónCuenta Descargar para Mac
Descargar para Mac

Ayuda / Instalación y solución de problemas

Instalación, actualización y espacio en disco

¿Funcionará en mi Mac? Memoria, chip, disco y tiempos de render de cada Mac con Apple Silicon, en una sola página.

Phosphene funciona en Mac con Apple Silicon (M1 o posterior) a través de Pinokio. Esta página explica cómo instalarlo y actualizarlo, cuánto espacio en disco necesitas y qué hacer si falla un paso.

Instalar con Pinokio

  1. Instala Pinokio.
  2. En Pinokio, abre Discover, elige Download from URL y pega https://github.com/mrbizarro/phosphene.
  3. Haz clic en Install. El instalador comprueba primero tu espacio libre en disco. Si no hay suficiente, se detiene y muestra cuánto necesitas y cuánto tienes.
  4. Cuando termine la instalación, haz clic en Start y luego en Open Panel. El panel se abre en http://127.0.0.1:8198.

La app se abre cuando su entorno de Python y los paquetes del motor están listos, normalmente en unos minutos. No se descarga ningún modelo antes de pulsar Start ni automáticamente en la primera apertura. Elige lo que quieres crear y descarga después su modelo.

Nota Pinokio no puede instalar Phosphene en un Mac Intel ni en Windows. El soporte para Linux en Apple Silicon es un proyecto comunitario aparte que Pinokio no instala. Consulta Linux (comunidad).

Qué se descarga y cuánto espacio necesitas

ParteDescargaCuándo
Entorno de la app: Python y paquetes del motorUnos 0.5 GB; las versiones de los paquetes pueden cambiarloAntes de Start. Reserva 18 GB libres, incluidos 15 GB que se mantienen libres
Modelos de video LTX-2.5 Q4, incluido el codificador de promptsUnos 27.5 GBHaz clic en Descargar modelos de video dentro de la app. Recomendado para tu primer video
Extras de funciones: Gemma 3 para Mejorar y el planificador de Storyboard, más adaptadores para Aumentar resolución y corregir rostro, Control de movimiento, Ingredientes y Colorear10.7 GB si eliges todosDescarga solo los que uses, desde la propia función o desde Modelos
Modelos de imagenSe muestra junto al modelo seleccionadoEn el primer Generar. FLUX.2 [klein] 4B es un punto de partida compacto, de unos 4.3 GB
Pesos LTX-2.5 Q8, para personajes entrenados y voces30.02 GBopcional, desde Configuración → Modelos o la barra lateral de Pinokio
Complemento Alta, para la calidad Alta, Fotogramas clave y Extender en LTX29.50 GBOpcional, desde la ventana Modelos (haz clic en el indicador de estado y luego en Modelos)
Hailuo H3, el segundo motor de videounos 75 GBopcional, desde la barra lateral de Pinokio. Consulta Hailuo H3
Motor de música (YuE2)unos 11 GBopcional, desde la pestaña Audio o la barra lateral de Pinokio. Consulta Estudio de música
LTX-2.3, necesario solo para entrenar un personajeunos 20 GB, más unos 21 GB del entrenadorse ofrece al abrir Entrenar personaje

Con una conexión de 100 Mbps, los modelos de video tardan unos 37 minutos en descargarse. Con 300 Mbps, unos 12 minutos; con 1 Gbps, unos 4 minutos. La app puede seguir abierta mientras se descargan los modelos. La tarjeta del modelo muestra los bytes recibidos, el archivo actual y los paquetes que faltan. Detener descarga detiene toda la descarga de video; haz clic en Descargar modelos de video otra vez para reanudarla. Los archivos descargados se quedan en el disco. Las descargas desde Modelos mantienen 15 GB libres y esperan si el espacio escasea.

Si una función necesita un extra que aún no ha terminado de descargarse, muestra un mensaje de descarga u ofrece Descargar ahora. Nunca falla sin avisar.

Consejo Puedes añadir un token de acceso de Hugging Face en Configuración para descargar unas diez veces más rápido. HDR es el único complemento que requiere este token. Todo lo demás funciona sin él.

Guarda los modelos en un disco externo

Los modelos ocupan la mayor parte del espacio. En la app para Mac (5.0.20 o posterior) puedes guardarlos en un disco externo y liberar tu Mac.

  • Elige dónde viven los modelos durante la configuración: la línea Los modelos van en … tiene un botón Cambiar y después Otro disco o carpeta…. También puedes elegirlo más tarde en Configuración > Modelos.
  • Muévelos más tarde. En Configuración > Modelos, Mover a otro disco… copia los modelos al disco y comprueba cada archivo. Solo entonces elimina la copia de tu Mac. Volver a este Mac los copia de vuelta y conserva la copia del disco; bórrala en Finder si quieres el espacio. El traslado muestra su progreso y tiene un botón Detener, y un traslado detenido se reanuda cuando lo inicias de nuevo. El estudio se cierra mientras los modelos se mueven y se abre otra vez cuando están en su sitio.
  • Solo se mueven los modelos. La app y su motor se quedan en tu Mac, así que Phosphene siempre se abre.
  • Si el disco está desconectado, la app muestra “(nombre del disco) no está conectado”. Conéctalo y elige Comprobar de nuevo, elige Descargar en su lugar para obtener en este Mac los modelos de borrador (unos 27.5 GB), o elige Abrir sin ellos.
  • Formato del disco. Los discos APFS y exFAT funcionan. FAT32 no admite archivos de más de 4 GB y algunos archivos de modelo son mayores, así que Phosphene rechaza un disco FAT32. Si algunos de tus modelos se comparten con una instalación de Pinokio, usa un disco APFS o Mac OS Extended.

Mantén el disco conectado siempre que Phosphene esté en marcha.

Comprueba la memoria de tu Mac

La memoria de tu Mac determina qué ajustes de calidad y qué motores puedes usar. Phosphene lo comprueba automáticamente. Para ver qué puede ejecutar tu Mac, haz clic en el indicador de estado del encabezado y luego en Nivel.

FunciónMemoria que necesita
Video LTX e ImágenesCualquier Mac con Apple Silicon. Por debajo de 48 GB, obtienes tamaños de video más pequeños. La calidad Alta de LTX, Fotograma inicial y final y Extender se ocultan. Los Mac con 24 GB o menos usan automáticamente una ruta de video de poca memoria: en un Mac de 16 GB un clip llega a un pico de unos 5.7 GB de memoria, unos 6.7 GB con LoRAs.
Estudio de música16 GB o más. Se recomiendan 24 GB o más para canciones largas con otras apps abiertas
Entrenar un personaje24 GB o más
Hailuo H316 GB o más (Borrador y Estándar desde 16 GB, Alta desde 18 GB). Con 60 GB o más, también puedes elegir el motor completo
LTX Alta · 720pUn Mac de 64 GB; el uso de memoria llega a un pico cercano a 50 GB

Antes de un render largo, cierra las apps que usan mucha memoria, como navegadores con muchas pestañas, Slack o el Simulador de iOS. Un render es el proceso de crear tu video o audio. Si tu Mac se queda sin memoria, detiene el render. Consulta Solución de problemas.

La barra lateral de Pinokio

Selecciona Phosphene en Pinokio para ver estas acciones en la barra lateral izquierda. Las acciones disponibles dependen de lo que esté instalado y de si el panel está en marcha.

  • Install / Resume Install: instala los archivos necesarios. Resume Install aparece si el último intento no terminó. Los archivos que terminaron de descargarse se conservan.
  • Start, Open Panel, Terminal: haz clic en Start para ejecutar Phosphene y luego en Open Panel para usarlo. Terminal muestra su registro de actividad.
  • Update: consulta Actualizar.
  • Outputs, Models, Uploads: abren esas carpetas en Finder.
  • Install Hailuo H3 (second video engine, ~75 GB): después de la instalación pasa a ser Repair Hailuo H3 o Update Hailuo H3 runner. Ambas conservan los archivos de modelo descargados.
  • Build Hailuo H3 compact engine: aparece en un Mac de 16 a 59 GB cuando los archivos del modelo están descargados pero el motor compacto no está listo. Tarda unos 5 minutos y no descarga nada.
  • Install the music engine (YuE2, ~11 GB): después de la instalación pasa a ser Repair the music engine, que conserva los archivos de modelo descargados.
  • Reset engine (keeps models & outputs): reconstruye el motor LTX y el software que necesita. Conserva tus modelos y tu trabajo terminado. No afecta a Hailuo H3; para reparar H3, usa Repair Hailuo H3.

Actualizar Phosphene

  • La etiqueta de versión del encabezado muestra Al día o Actualizar a seguido de una versión más reciente. Cuando hay una actualización disponible, haz clic en Actualizar ahora en el aviso para instalarla, o en Más tarde para esperar.
  • Haz clic en Update en la barra lateral de Pinokio para actualizarlo todo, incluido el software de apoyo. Tu cola, tus ajustes, tus modelos y tu trabajo terminado se conservan.
  • Después de una actualización desde la app, el aviso dice “Updated to … restart to finish”. Haz clic en Stop y luego en Start, en Pinokio.
  • Si actualizas desde una versión muy antigua y parece que solo cambia el panel, haz clic en Update una vez más. La primera actualización reemplaza al propio actualizador.
  • Si el Update de Pinokio se detiene en el primer segundo (las versiones 4.19.6 y anteriores pueden hacerlo), haz clic en Actualizar ahora en el aviso o en la etiqueta de versión de Phosphene y luego reinicia. Consulta La actualización se detiene al instante.
  • Si el panel sigue comportándose como la versión antigua, necesita reiniciarse. La etiqueta de versión dirá entonces Restart Phosphene. Haz clic en ella, o haz clic en Stop y luego en Start en Pinokio.
  • Hailuo H3 y el motor de música tienen su propio software de apoyo. Si el panel dice que alguno necesita una actualización, haz clic en la entrada Update o Repair de ese motor en la barra lateral de Pinokio. Tus archivos de modelo descargados se conservan.

Actualizar a mano (si una actualización no llega)

Phosphene busca actualizaciones por su cuenta, pero una conexión lenta o bloqueada puede impedir que llegue alguna. Siempre puedes instalar tú mismo la versión más reciente. Tus modelos, tu trabajo terminado, tus ajustes y tu licencia de Pro se conservan.

App para Mac

  1. Cierra Phosphene (Phosphene → Salir, o Cmd+Q).
  2. Descarga el instalador más reciente desde phosphene.video/download (el mismo archivo también está adjunto a cada versión de GitHub).
  3. Abre el .dmg descargado y arrastra Phosphene a Aplicaciones. Cuando el Mac te lo pida, elige Reemplazar.
  4. Abre Phosphene desde Aplicaciones. La etiqueta de versión del encabezado muestra la versión nueva.

Conserva una sola copia, la que está en Aplicaciones. Las copias antiguas que queden en Descargas o en un disco instalador pueden abrirse en lugar de la nueva: muévelas a la Papelera y expulsa cualquier disco Phosphene en la barra lateral del Finder. Tu trabajo vive en ~/Library/Application Support/Phosphene, no dentro de la app, así que reemplazar o borrar la app no elimina nada de él.

Pinokio

  1. Haz clic en Stop en la barra lateral de Pinokio de Phosphene.
  2. Abre la app Terminal, ve a la carpeta de Phosphene (cd ~/pinokio/api/<your Phosphene folder>) y ejecuta git pull.
  3. Haz clic en Update en la barra lateral y luego en Start.

Si git pull dice que tienes cambios locales, ejecuta primero git stash y luego git pull de nuevo.

Si una instalación o actualización se detiene con un error

Si falla un paso obligatorio, Pinokio se detiene y muestra una línea que empieza por FATAL error:. Sube por el registro que Pinokio muestra para esa instalación o actualización para encontrarla. La línea explica el problema y en qué hacer clic a continuación. Casi siempre, no se borró nada. Después de resolver el problema, haz clic otra vez en Install o Update para continuar.

Usa la tabla siguiente para relacionar el texto que sigue a FATAL error::

La línea diceQué hacer
not enough disk space to install PhospheneLibera el espacio que indica y haz clic en Install otra vez
could not download the video engine version Phosphene needs … (a VPN, proxy or blocked GitHub is the usual cause)Comprueba tu conexión, desactiva la VPN o el proxy y haz clic en Install o Update otra vez
the engine environment did not install after 3 attemptsComprueba tu conexión a internet y el espacio libre en disco y haz clic en Install o Update otra vez. Si se repite, informa de la línea siguiendo las instrucciones de abajo
the video engine is on the wrong versionHaz clic en Install o Update otra vez. Si se repite, informa de la línea
Hailuo H3 needs a Mac with at least 16 GB of memoryTu Mac no puede ejecutar H3. Sigue usando LTX, que tiene todos los modos salvo Añadir sonido
Hailuo H3 needs about N GB of free disk spaceNecesitas unos 97 GB para una instalación nueva (la descarga de 75 GB más el motor compacto de 22 GB), o unos 25 GB si los archivos del modelo ya están descargados. Libera el espacio y haz clic en Install Hailuo H3 otra vez
the compact Hailuo H3 engine could not be builtEsto suele significar que el disco está lleno (la creación necesita unos 22 GB). Libera espacio y haz clic de nuevo en la entrada de H3 de la barra lateral de Pinokio. Se reconstruye a partir de los archivos del modelo descargados
a Phosphene render has been running for over 60 minutes, so the compact Hailuo H3 engine was not builtEspera a que Phosphene termine su render actual y haz clic de nuevo en la entrada de H3 de la barra lateral de Pinokio
the H3 venv has no working PythonHaz clic en Repair Hailuo H3 en la barra lateral de Pinokio. Tus archivos de modelo descargados se conservan
YuE2 (the music engine) needs a Mac with at least 16 GB of memoryEste Mac no puede ejecutar el motor de música. El resto de Phosphene no se ve afectado
YuE2 (the music engine) needs at least 14 GB freeLibera el espacio y haz clic en Install the music engine otra vez
could not download the YuE2 music engineComprueba tu conexión a internet y si una VPN o un proxy bloquea GitHub, y haz clic en Install the music engine otra vez
untracked/ignored paths obstruct Update. Move them; nothing deleted.Hay archivos que añadiste dentro de la carpeta de la app que estorban a la actualización. Las líneas justo encima los enumeran. Muévelos fuera de la carpeta de Phosphene y haz clic en Update de nuevo
fetch failed (offline?) - nothing changed, re-run UpdateVuelve a conectarte y haz clic en Update de nuevo
the Update safety check did not pass - not updatingNo se cambió nada. Haz clic en Update de nuevo. Si se repite, informa de la línea

Si tu error no aparece, sigue las instrucciones de su línea FATAL error:. Para informar de un error, copia esa línea y las pocas líneas anteriores en un informe de error. Consulta Informar de un problema.

Empezar de nuevo sin perder tu trabajo

  • Haz clic en Reset engine en Pinokio para reconstruir el motor LTX. Tus modelos, tu trabajo terminado y tus ajustes se conservan.
  • Para encontrar tu trabajo terminado, haz clic en Outputs en la barra lateral de Pinokio. Se abre mlx_outputs dentro de la carpeta de Phosphene.
  • Para encontrar tus modelos descargados, haz clic en Models en la barra lateral. Se abre mlx_models. No borres esta carpeta salvo que quieras descargarlo todo otra vez.

Si Phosphene se abre pero una tarea falla, faltan modelos o tu cola se pausa, consulta Solución de problemas.

Fuente: webapp/docs/install.md en el repositorio público. Revisado para este sitio web antes de publicarse. Traducido del original en inglés. Sugerir un cambio.