Docs / Installation et dépannage
Dépannage
Mon Mac le fera-t-il tourner ? Mémoire, puce, disque et temps de rendu pour chaque Mac Apple Silicon, sur une seule page.
Quand Phosphene refuse un rendu, il dit pourquoi et ce qu’il faut faire. Voici les messages que les gens voient vraiment. Pour les problèmes pendant l’Install ou l’Update (une ligne FATAL error: dans Pinokio, pas assez d’espace disque), voir Installation, mises à jour et espace disque.
Mémoire et palier de ce Mac
La pastille d’état dans l’en-tête indique la mémoire d’un coup d’œil. Cliquez dessus pour voir les lignes Palier, Mémoire, Helper, Modèles, File d’attente et Rendu. Cliquez sur Palier pour voir ce que ce Mac peut faire tourner.
- « Helper killed by the OS: out of memory » : macOS a arrêté le rendu. Fermez les apps gourmandes en mémoire (navigateurs, Slack, le simulateur iOS) et réessayez, ou passez la Qualité sur Rapide, qui utilise environ moitié moins de mémoire.
- « Image pre-flight: … needs a N GB Mac » : ce moteur d’image ne tient pas sur ce Mac. Sur les Mac de 16 Go ou moins, Auto utilise FLUX.2 [klein] 4B quand le moteur choisi dans les Réglages demande un Mac plus puissant, sans modifier les Réglages. Cela exige un rendu sans images de référence : retirez les références pour laisser Auto utiliser Klein, ou choisissez un moteur plus léger dans les Réglages. « … needs ~N GB free » veut dire que le moteur convient, mais que la mémoire est actuellement occupée. Cette vérification tient désormais compte de la mémoire que macOS peut libérer et des besoins réels d’Auto.
- « Training needs at least 24 GB of memory » : l’entraînement de personnage ne peut pas tourner sur ce Mac.
Hailuo H3 sur un Mac de 16 à 60 Go
Le moteur complet de H3 demande 60 Go. À partir de 16 Go, H3 tourne sur son moteur compact Q8, construit une seule fois sur votre Mac (en dessous de 36 Go, il lit le modèle depuis votre disque pendant le rendu) :
- H3 pas encore installé : dans Pinokio, ouvrez Phosphene dans la barre latérale et cliquez sur Install Hailuo H3 (second video engine, ~75 GB). L’installation construit toute seule le moteur compact à la fin (environ 5 minutes de plus).
- H3 installé, moteur compact manquant : « Hailuo H3 runs on this Mac, on its reduced-RAM lane … it is not built here yet » : cliquez sur Build Hailuo H3 compact engine dans la même barre latérale (~5 minutes, sans téléchargement).
Les deux entrées se trouvent dans la barre latérale tant que le panneau tourne.
Faites cela, puis choisissez Réglages → Modèle Hailuo H3 → Automatique ou Compact. En dessous de 16 Go, H3 n’est pas disponible : faites vos rendus avec LTX, qui gère tous les modes.
Un modèle ou un module n’est pas téléchargé
- « Enhance needs its language model, Gemma 3 (8.1 GB) », et de même pour les adaptateurs : sur une nouvelle installation, ils se téléchargent en arrière-plan après le premier Start. Le message indique si le téléchargement est en cours, en attente ou bloqué faute d’espace disque. Download now le lance tout de suite.
- « Extend needs the LTX-2.5 High add-on (the Q8 model), which isn’t downloaded on this Mac yet » : idem pour Images clés et la qualité High. Installez-le depuis la fenêtre Modèles (cliquez sur la pastille d’état, puis sur Modèles).
- « Upscale & Face Fix needs the LTX-2.5 Pixel Spatial Upscaler adapter » : téléchargez-le depuis la fenêtre Modèles, puis relancez le rendu.
- « Arrêté avant le rendu : les poids du modèle sont incomplets. » : un téléchargement a été interrompu. Ouvrez la fenêtre Modèles et reprenez-le. Réglages → Vérifier les modèles (somme de contrôle) contrôle chaque fichier et propose de retélécharger ceux qui sont abîmés.
La mise à jour s’arrête tout de suite
Sur certains Mac, l’Update de Pinokio dans les versions antérieures à 4.19.7 s’arrêtait dès la première seconde : le terminal de Pinokio lisait les mots « error: » dans le texte de commande de l’Update lui-même comme un échec (#114). Pinokio exécute le script Update de la version que vous avez déjà, donc le correctif ne peut prendre effet qu’après une mise à jour.
Mettez plutôt à jour une fois depuis Phosphene : cliquez sur Mettre à jour dans son bandeau de mise à jour (ou sur la pastille de version dans l’en-tête), attendez qu’il indique que la mise à jour est terminée, puis redémarrez. Ou ouvrez un terminal dans le dossier Phosphene (~/pinokio/api/<your Phosphene folder>), lancez git pull, puis appuyez de nouveau sur Update dans Pinokio : il exécute alors le nouveau script, corrigé. Après cela, le bouton fonctionne.
« Click Update » : un moteur plus ancien que le panneau
« 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. »
Le panneau a été mis à jour, mais pas le moteur en dessous. Cliquez sur Update dans la barre latérale Phosphene de Pinokio. Si rien ne semble changer, cliquez une seconde fois : une mise à jour lancée par une ancienne version commence par se mettre à jour elle-même. Pour H3, « the installed Hailuo H3 runner is behind this panel » veut dire : relancez Install Hailuo H3. Tous les fichiers de modèle déjà sur le disque sont conservés.
Si vous avez mis à jour et que le panneau se comporte encore comme l’ancienne version, c’est qu’il exécute toujours l’ancien code. La pastille de version dans l’en-tête affiche alors Redémarrer Phosphene : cliquez dessus, ou cliquez sur Stop, puis sur Start, dans Pinokio.
Le chien de garde du GPU
« the macOS GPU watchdog killed a Metal command buffer » : macOS lui-même a arrêté une tâche GPU qui durait trop longtemps. C’est une interruption au niveau du pilote, pas un bug de Phosphene, et elle est plus fréquente sur les Mac M1 et M2. Phosphene relance une fois le même travail, tout de suite, en petites étapes GPU (des morceaux de travail GPU plus petits, un peu plus lents), et retient la taille : son prochain rendu sur ce Mac démarre en petites étapes, et la ligne File d’attente l’indique. Si macOS l’arrête même en petites étapes, cette taille est suspendue sur ce Mac pendant 24 heures (ou jusqu’à la prochaine mise à jour) et la carte propose Réessayer en plus petit. Si cela se répète, le message renvoie vers le ticket GitHub où la puce, la version de macOS et le journal de plantage sont les plus utiles.
Un entraînement de personnage a échoué
« training exited with code 1 » : l’entraîneur s’est arrêté avant la fin. Consultez l’onglet Journaux pour connaître la vraie raison : un arrêt par manque de mémoire (passez sur un Mac avec plus de RAM, ou sur un préréglage plus petit s’il en existe un), un téléchargement d’entraînement LTX-2.3 manquant (la carte de vérification préalable de l’onglet Entraîner le propose), ou un dépassement de délai à l’encodage d’une légende très longue. Un entraînement sous 24 Go échoue toujours : ce Mac ne peut pas le faire.
Le panneau indique qu’il est hors ligne
« Phosphene offline », et appuyer sur Générer ne fait rien : le processus du panneau ne répond pas. Rien de ce que vous étiez en train de saisir n’est perdu : le prompt reste tel que vous l’avez laissé, et la page se reconnecte et reprend la file d’attente toute seule dès que le panneau tourne de nouveau. Démarrez-le depuis la barre latérale Phosphene de Pinokio s’il ne revient pas en quelques secondes.
La file d’attente s’est mise en pause
« Queue paused: the last N renders failed the same way » : quand trois rendus de suite échouent pour la même raison, Phosphene cesse de dévorer le reste de la file pour un problème qu’une nouvelle tentative ne règle pas. Corrigez la cause indiquée par le message, puis appuyez sur Reprendre, ou sur Vider la file pour abandonner le reste et repartir de zéro.
La file d’attente après un redémarrage
Redémarrer le panneau reprend la file : une file qui était en pause à l’arrêt du panneau repart toute seule, et le journal l’indique.
Lire le journal
L’onglet Journaux du panneau du bas affiche le journal de rendu. Quand un rendu plante, la dernière ligne qui commence par step: nomme l’étape atteinte : c’est l’élément le plus utile à joindre à un signalement. Le Terminal de Pinokio affiche la même sortie.
Signaler un problème
Le bouton bug dans l’en-tête ouvre Signaler un bug. Écrivez une ou deux phrases sous Que s’est-il passé ? (10 caractères minimum, car le journal ne peut pas dire ce que vous avez vu). Le formulaire renseigne la version, les détails de votre Mac et le journal récent, avec les lignes d’erreur placées avant les lignes courantes, puis ouvre un ticket GitHub dans un nouvel onglet que vous terminez : rien n’est envoyé tant que vous ne le validez pas là-bas. Les tickets sont sur github.com/mrbizarro/phosphene/issues.
Source : webapp/docs/troubleshooting.md dans le dépôt public. Relu pour ce site avant publication. Traduit de l'original anglais. Suggérer une modification.