Pro
PT
EntrarConta Baixar para Mac
Baixar para Mac

Docs / Instalação e solução de problemas

Instalar, atualizar e espaço em disco

Meu Mac vai rodar isso? Memória, chip, disco e tempos de renderização de cada Mac Apple Silicon, em uma só página.

O Phosphene roda em Macs com Apple Silicon (M1 ou mais novo) através do Pinokio. Esta página explica como instalar e atualizar, quanto espaço em disco você precisa e o que fazer quando uma etapa falha.

Instalar com o Pinokio

  1. Instale o Pinokio.
  2. No Pinokio, abra Discover, escolha Download from URL e cole https://github.com/mrbizarro/phosphene.
  3. Clique em Install. O instalador confere primeiro o seu espaço livre em disco. Se não houver o suficiente, ele para e mostra quanto você precisa e quanto tem.
  4. Quando a instalação terminar, clique em Start e depois em Open Panel. O painel abre em http://127.0.0.1:8198.

O app abre depois que o ambiente Python e os pacotes do motor estão prontos, em geral em alguns minutos. Nenhum modelo é baixado antes do Start nem automaticamente na primeira abertura. Escolha o que quer criar e então baixe o modelo correspondente.

Observação O Pinokio não consegue instalar o Phosphene em um Mac Intel nem no Windows. O suporte a Linux em Apple Silicon é um projeto separado da comunidade, que o Pinokio não instala. Veja Linux (comunidade).

O que é baixado e quanto espaço você precisa

ParteDownloadQuando
Ambiente do app: Python e pacotes do motorCerca de 0,5 GB; as versões dos pacotes podem mudar issoAntes do Start. Reserve 18 GB livres, incluindo 15 GB mantidos livres
Modelos de vídeo LTX-2.5 Q4, com o codificador de promptCerca de 27,5 GBClique em Baixar modelos de vídeo dentro do app. Recomendado para o seu primeiro vídeo
Extras dos recursos: o Gemma 3 para o Aprimorar e o planejador do Storyboard, mais adaptadores para Aumentar resolução e Corrigir rosto, Controle de movimento, Ingredientes e Colorir10,7 GB se você escolher todosBaixe só os que você usa, pelo próprio recurso ou em Modelos
Modelos de imagemMostrado ao lado do modelo selecionadoNo primeiro Gerar. O FLUX.2 [klein] 4B é um ponto de partida compacto, com cerca de 4,3 GB
Pesos LTX-2.5 Q8, para personagens treinados e vozes30,02 GBopcional, em Ajustes → Modelos ou na barra lateral do Pinokio
Complemento Alta, para qualidade Alta, Quadros-chave e Estender no LTX29,50 GBOpcional, pela janela Modelos (clique no indicador de saúde e depois em Modelos)
Hailuo H3, o segundo motor de vídeocerca de 75 GBopcional, pela barra lateral do Pinokio. Veja Hailuo H3
Motor de música (YuE2)cerca de 11 GBopcional, pela aba Áudio ou pela barra lateral do Pinokio. Veja Estúdio de música
LTX-2.3, necessário só para treinar um personagemcerca de 20 GB, mais cerca de 21 GB para o treinadoroferecido quando você abre Treinar personagem

Com uma conexão de 100 Mbps, os modelos de vídeo levam cerca de 37 minutos para baixar. Com 300 Mbps, cerca de 12 minutos; com 1 Gbps, cerca de 4 minutos. O app pode ficar aberto durante o download dos modelos. O card do modelo mostra os bytes recebidos, o arquivo atual e os pacotes que faltam. Parar download interrompe todo o download do vídeo; clique em Baixar modelos de vídeo de novo para retomar. Os arquivos baixados ficam no disco. Os downloads feitos em Modelos mantêm 15 GB livres e esperam se o espaço ficar curto.

Se um recurso precisa de um extra que ainda não terminou de baixar, ele mostra uma mensagem de download ou oferece Baixar agora. Ele não falha sem avisar.

Dica Você pode adicionar um token de acesso do Hugging Face em Ajustes para downloads cerca de dez vezes mais rápidos. O HDR é o único complemento que exige esse token. Todo o resto funciona sem ele.

Manter os modelos em um disco externo

Os modelos ocupam a maior parte do espaço. No app para Mac (5.0.20 ou mais novo) você pode mantê-los em um disco externo e liberar espaço no Mac.

  • Escolha onde os modelos ficam na configuração: a linha Os modelos ficam em … tem um botão Alterar e depois Outro disco ou pasta…. Você também pode escolher depois em Ajustes > Modelos.
  • Mova-os depois. Em Ajustes > Modelos, Mover para outro disco… copia os modelos para o disco e confere cada arquivo. Só então remove a cópia do seu Mac. Mover de volta para este Mac os copia de volta e mantém a cópia no disco; apague-a no Finder se quiser o espaço. A mudança mostra o progresso e tem um botão Parar, e uma mudança interrompida continua de onde parou quando você a inicia de novo. O Studio fecha enquanto os modelos são movidos e abre de novo quando eles estão no lugar.
  • Só os modelos se movem. O app e o motor dele ficam no seu Mac, então o Phosphene sempre abre.
  • Se o disco for desconectado, o app mostra “(nome do disco) não está conectado”. Conecte-o e escolha Verificar de novo, escolha Baixar em vez disso para baixar os modelos de rascunho (cerca de 27,5 GB) neste Mac, ou escolha Abrir sem eles.
  • Formato do disco. Discos APFS e exFAT funcionam. O FAT32 não comporta arquivos acima de 4 GB, e alguns arquivos de modelo são maiores, então o Phosphene recusa um disco FAT32. Se alguns dos seus modelos são compartilhados com uma instalação do Pinokio, use um disco APFS ou Mac OS Estendido.

Mantenha o disco conectado sempre que o Phosphene estiver rodando.

Confira a memória do seu Mac

A memória do seu Mac determina quais ajustes de qualidade e quais motores você pode usar. O Phosphene confere isso automaticamente. Para ver o que o seu Mac consegue rodar, clique no indicador de saúde no cabeçalho e depois em Nível.

RecursoMemória necessária
Vídeo e Imagens do LTXQualquer Mac com Apple Silicon. Abaixo de 48 GB, você recebe tamanhos de vídeo menores. A qualidade Alta, o Primeiro e último quadro e o Estender do LTX ficam ocultos. Macs com 24 GB ou menos usam automaticamente um caminho de vídeo de pouca memória: em um Mac de 16 GB, um clipe chega a cerca de 5,7 GB de memória, e a cerca de 6,7 GB com LoRAs.
Estúdio de música16 GB ou mais. Recomendados 24 GB ou mais para músicas longas com outros apps abertos
Treinar um personagem24 GB ou mais
Hailuo H316 GB ou mais (Rascunho e Padrão a partir de 16 GB, Alta a partir de 18 GB). Com 60 GB ou mais, você também pode escolher o motor completo
LTX Alta · 720pUm Mac de 64 GB; o uso de memória chega perto de 50 GB

Antes de uma renderização longa, feche os apps que usam muita memória, como navegadores com muitas abas, o Slack ou o Simulador do iOS. Renderizar é o processo de criar o seu vídeo ou áudio. Se o seu Mac ficar sem memória, ele interrompe a renderização. Veja Solução de problemas.

A barra lateral do Pinokio

Selecione o Phosphene no Pinokio para ver estas ações na barra lateral esquerda. As ações disponíveis dependem do que está instalado e de o painel estar rodando.

  • Install / Resume Install: instalam os arquivos necessários. Resume Install aparece se a última tentativa não terminou. Os arquivos que terminaram de baixar são mantidos.
  • Start, Open Panel, Terminal: clique em Start para rodar o Phosphene e depois em Open Panel para usá-lo. O Terminal mostra o registro de atividade.
  • Update: veja Atualizar.
  • Outputs, Models, Uploads: abrem essas pastas no Finder.
  • Install Hailuo H3 (second video engine, ~75 GB): depois da instalação, vira Repair Hailuo H3 ou Update Hailuo H3 runner. Os dois mantêm os arquivos de modelo baixados.
  • Build Hailuo H3 compact engine: aparece em um Mac de 16 a 59 GB quando os arquivos do modelo estão baixados, mas o motor compacto não está pronto. Leva cerca de 5 minutos e não baixa nada.
  • Install the music engine (YuE2, ~11 GB): depois da instalação, vira Repair the music engine, que mantém os arquivos de modelo baixados.
  • Reset engine (keeps models & outputs): reconstrói o motor LTX e o software de que ele precisa. Mantém os seus modelos e o trabalho pronto. Não afeta o Hailuo H3; para reparar o H3, use Repair Hailuo H3.

Atualizar o Phosphene

  • A etiqueta de versão no cabeçalho mostra Atualizado, ou Atualizar para seguido de uma versão mais nova. Quando há uma atualização, clique em Atualizar agora no banner para instalá-la, ou em Depois para esperar.
  • Clique em Update na barra lateral do Pinokio para atualizar tudo, inclusive o software de apoio. A sua fila, os ajustes, os modelos e o trabalho pronto são mantidos.
  • Depois de uma atualização dentro do app, o banner diz “Atualizado para …, reinicie para concluir”. Clique em Stop e depois em Start no Pinokio.
  • Se você atualiza a partir de uma versão muito antiga e parece que só o painel mudou, clique em Update mais uma vez. A primeira atualização substitui o próprio atualizador.
  • Se o Update do Pinokio para no primeiro segundo (as versões 4.19.6 e anteriores podem fazer isso), clique em Atualizar agora no banner do próprio Phosphene ou na etiqueta de versão e depois reinicie. Veja A atualização para na hora.
  • Se o painel ainda se comporta como a versão antiga, ele precisa ser reiniciado. A etiqueta de versão passa então a dizer Reiniciar o Phosphene. Clique nela, ou clique em Stop e depois em Start no Pinokio.
  • O Hailuo H3 e o motor de música têm software de apoio separado. Se o painel disser que um dos dois precisa de atualização, clique na entrada Update ou Repair desse motor na barra lateral do Pinokio. Os seus arquivos de modelo baixados são mantidos.

Atualizar manualmente (se uma atualização não chega)

O Phosphene procura atualizações sozinho, mas uma conexão lenta ou bloqueada pode impedir que uma chegue. Você sempre pode instalar a versão mais nova por conta própria. Os seus modelos, o trabalho pronto, os ajustes e a licença Pro são mantidos.

App para Mac

  1. Feche o Phosphene (Phosphene → Encerrar, ou Cmd+Q).
  2. Baixe o instalador mais novo em phosphene.video/download (o mesmo arquivo também está anexado a cada release no GitHub).
  3. Abra o .dmg baixado e arraste o Phosphene para Aplicativos. Quando o Mac perguntar, escolha Substituir.
  4. Abra o Phosphene em Aplicativos. A etiqueta de versão no cabeçalho mostra a versão nova.

Mantenha uma única cópia, a que está em Aplicativos. Cópias antigas deixadas em Downloads ou em um disco de instalação podem abrir no lugar da nova: mova-as para o Lixo e ejete qualquer disco Phosphene na barra lateral do Finder. O seu trabalho fica em ~/Library/Application Support/Phosphene, não dentro do app, então substituir ou apagar o app não remove nada dele.

Pinokio

  1. Clique em Stop na barra lateral do Phosphene no Pinokio.
  2. Abra o app Terminal, vá até a pasta do Phosphene (cd ~/pinokio/api/<your Phosphene folder>) e rode git pull.
  3. Clique em Update na barra lateral e depois em Start.

Se o git pull disser que você tem alterações locais, rode git stash primeiro e depois git pull de novo.

Quando uma instalação ou atualização para com um erro

Se uma etapa necessária falha, o Pinokio para e mostra uma linha que começa com FATAL error:. Role para cima no registro que o Pinokio mostra para essa instalação ou atualização para encontrá-la. A linha explica o problema e o que clicar em seguida. Em quase todos os casos, nada foi apagado. Depois de resolver o problema, clique em Install ou Update de novo para continuar.

Use a tabela abaixo para encontrar o texto depois de FATAL error::

A linha dizO que fazer
not enough disk space to install PhospheneLibere o espaço que ela indica e clique em Install de novo
could not download the video engine version Phosphene needs … (a VPN, proxy or blocked GitHub is the usual cause)Confira a conexão, desligue a VPN ou o proxy e clique em Install ou Update de novo
the engine environment did not install after 3 attemptsConfira a conexão com a internet e o espaço livre em disco e clique em Install ou Update de novo. Se se repetir, relate a linha seguindo as instruções abaixo
the video engine is on the wrong versionClique em Install ou Update de novo. Se se repetir, relate a linha
Hailuo H3 needs a Mac with at least 16 GB of memoryO seu Mac não consegue rodar o H3. Continue usando o LTX, que tem todos os modos, menos Adicionar som
Hailuo H3 needs about N GB of free disk spaceVocê precisa de cerca de 97 GB para uma instalação nova (o download de 75 GB mais o motor compacto de 22 GB), ou cerca de 25 GB se os arquivos do modelo já estão baixados. Libere o espaço e clique em Install Hailuo H3 de novo
the compact Hailuo H3 engine could not be builtEm geral, isso significa que o disco está cheio (a montagem precisa de cerca de 22 GB). Libere espaço e clique de novo na entrada do H3 na barra lateral do Pinokio. Ele remonta a partir dos arquivos de modelo baixados
a Phosphene render has been running for over 60 minutes, so the compact Hailuo H3 engine was not builtEspere o Phosphene terminar a renderização atual e clique de novo na entrada do H3 na barra lateral do Pinokio
the H3 venv has no working PythonClique em Repair Hailuo H3 na barra lateral do Pinokio. Os seus arquivos de modelo baixados são mantidos
YuE2 (the music engine) needs a Mac with at least 16 GB of memoryEste Mac não consegue rodar o motor de música. O resto do Phosphene não é afetado
YuE2 (the music engine) needs at least 14 GB freeLibere o espaço e clique em Install the music engine de novo
could not download the YuE2 music engineConfira a conexão com a internet e se uma VPN ou um proxy está bloqueando o GitHub, e clique em Install the music engine de novo
untracked/ignored paths obstruct Update. Move them; nothing deleted.Arquivos que você colocou dentro da pasta do app estão atrapalhando a atualização. As linhas logo acima os listam. Mova-os para fora da pasta do Phosphene e clique em Update de novo
fetch failed (offline?) - nothing changed, re-run UpdateReconecte e clique em Update de novo
the Update safety check did not pass - not updatingNada foi alterado. Clique em Update de novo. Se se repetir, relate a linha

Se o seu erro não está na lista, siga as instruções da própria linha FATAL error:. Para relatar um erro, copie essa linha e as poucas linhas acima dela em um relatório de bug. Veja Relatar um problema.

Recomeçar sem perder o seu trabalho

  • Clique em Reset engine no Pinokio para reconstruir o motor LTX. Os seus modelos, o trabalho pronto e os ajustes são mantidos.
  • Para encontrar o seu trabalho pronto, clique em Outputs na barra lateral do Pinokio. Isso abre mlx_outputs dentro da pasta do Phosphene.
  • Para encontrar os modelos baixados, clique em Models na barra lateral. Isso abre mlx_models. Não apague essa pasta, a não ser que queira baixar tudo de novo.

Se o Phosphene abre, mas uma tarefa falha, faltam modelos ou a sua fila pausa, veja Solução de problemas.

Fonte: webapp/docs/install.md no repositório público. Revisado para este site antes da publicação. Traduzido do original em inglês. Sugerir uma edição.