Pro
DE
AnmeldenKonto Für Mac herunterladen
Für Mac herunterladen

Doku / Installation und Fehlerbehebung

Fehlerbehebung

Läuft es auf meinem Mac? Arbeitsspeicher, Chip, Speicherplatz und Renderzeiten für jeden Mac mit Apple Silicon auf einer Seite.

Wenn Phosphene ein Rendering ablehnt, sagt es, warum und was zu tun ist. Das sind die Meldungen, die Leute tatsächlich sehen. Für Probleme bei der Installation oder beim Update (eine Zeile FATAL error: in Pinokio, zu wenig Speicherplatz) siehe Installation, Updates und Speicherplatz.

Speicher und die Stufe dieses Macs

Der Health-Chip in der Kopfzeile zeigt den Speicher auf einen Blick; klicke darauf für die Zeilen Stufe, Speicher, Helper, Modelle, Warteschlange und Rendern. Klicke auf Stufe, um zu sehen, was dieser Mac ausführen kann.

  • “Helper killed by the OS - out of memory”: macOS hat das Rendering gestoppt. Schließe speicherhungrige Apps (Browser, Slack, den iOS-Simulator) und versuche es erneut, oder stelle die Qualität auf Schnell, das etwa halb so viel Speicher braucht.
  • “Image pre-flight: … needs a N GB Mac”: Diese Bild-Engine passt nicht auf diesen Mac. Auf Macs mit 16 GB oder weniger nutzt Auto FLUX.2 [klein] 4B, wenn die Engine in den Einstellungen einen größeren Mac braucht, ohne die Einstellungen zu ändern. Das setzt ein Rendering ohne Referenzbilder voraus; entferne die Referenzen, damit Auto Klein nutzen kann, oder wähle in den Einstellungen eine leichtere Engine. ”… needs ~N GB free” heißt, dass die Engine passt, der Speicher aber gerade belegt ist; diese Prüfung berücksichtigt jetzt den Speicher, den macOS freigeben kann, und den tatsächlichen Speicherbedarf von Auto.
  • “Training needs at least 24 GB of memory”: Das Training von Charakteren kann auf diesem Mac nicht laufen.

Hailuo H3 auf einem Mac mit 16 bis 60 GB

Die volle H3-Engine braucht 60 GB. Ab 16 GB läuft H3 auf seiner kompakten Q8-Engine, die einmalig auf deinem Mac gebaut wird (unter 36 GB liest sie das Modell beim Rendern von deiner Festplatte):

  • H3 noch nicht installiert: Öffne in Pinokio Phosphene in der Seitenleiste und klicke auf Install Hailuo H3 (second video engine, ~75 GB). Die Installation baut am Ende die kompakte Engine von selbst (etwa 5 weitere Minuten).
  • H3 installiert, kompakte Engine fehlt (“Hailuo H3 runs on this Mac - on its reduced-RAM lane … it is not built here yet”): Klicke in derselben Seitenleiste auf Build Hailuo H3 compact engine (~5 Minuten, kein Download).

Beide Einträge stehen in der Seitenleiste, solange das Panel läuft.

Mach das und wähle dann Einstellungen → Hailuo-H3-Modell → Automatisch oder Kompakt. Unter 16 GB ist H3 nicht verfügbar: Rendere mit LTX, das jeden Modus bedient.

Ein Modell oder Add-on ist nicht heruntergeladen

  • “Enhance needs its language model, Gemma 3 (8.1 GB)” und dasselbe für die Adapter: Bei einer neuen Installation werden sie nach dem ersten Start im Hintergrund heruntergeladen. Die Meldung sagt, ob gerade heruntergeladen wird, ob es in der Warteschlange ist oder auf Speicherplatz wartet; Jetzt herunterladen holt es sofort.
  • “Extend needs the LTX-2.5 High add-on (the Q8 model), which isn’t downloaded on this Mac yet”: dasselbe gilt für Keyframes und die Qualität Hoch. Installiere es im Fenster Modelle (klicke auf den Health-Chip, dann auf Modelle).
  • “Upscale & Face Fix needs the LTX-2.5 Pixel Spatial Upscaler adapter”: Lade ihn im Fenster Modelle herunter und rendere dann erneut.
  • “Stopped before rendering - the model weights are incomplete”: Ein Download wurde unterbrochen. Öffne das Fenster Modelle und setze ihn fort. Einstellungen → Modelldateien prüfen kontrolliert jede Datei und bietet an, beschädigte noch einmal herunterzuladen.

Das Update bricht sofort ab

Auf manchen Macs brach das Update von Pinokio in Versionen vor 4.19.7 in der ersten Sekunde ab: Das Terminal von Pinokio las das Wort „error:“ im eigenen Befehlstext des Updates als Fehler (#114). Pinokio führt das Update-Skript der Version aus, die du schon hast, daher kann die Korrektur erst nach einem Update greifen.

Aktualisiere stattdessen einmal aus Phosphene heraus: Klicke im Update-Banner (oder auf die Versionsanzeige in der Kopfzeile) auf Jetzt updaten, warte, bis dort steht, dass das Update fertig ist, und starte dann neu. Oder öffne ein Terminal im Phosphene-Ordner (~/pinokio/api/<your Phosphene folder>), führe git pull aus und drücke in Pinokio erneut auf Update: Dann läuft das neue, korrigierte Skript. Danach funktioniert die Schaltfläche.

“Click Update”: eine Engine, die älter ist als das 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.”

Das Panel wurde aktualisiert, die Engine darunter aber nicht. Klicke in der Phosphene-Seitenleiste von Pinokio auf Update. Wenn sich scheinbar nichts ändert, klicke ein zweites Mal: Ein von einer alten Version gestartetes Update aktualisiert zuerst sich selbst. Bei H3 bedeutet “the installed Hailuo H3 runner is behind this panel”: Führe Install Hailuo H3 erneut aus; alle Gewichte, die schon auf der Festplatte liegen, bleiben erhalten.

Wenn du aktualisiert hast und das Panel sich immer noch wie die alte Version verhält, läuft noch der alte Code. Die Versionsanzeige in der Kopfzeile zeigt dann Phosphene neu starten: Klicke darauf, oder klicke in Pinokio auf Stop und dann auf Start.

Der GPU-Watchdog

“the macOS GPU watchdog killed a Metal command buffer”: macOS selbst hat eine GPU-Aufgabe gestoppt, die zu lange lief. Das ist ein Abbruch auf Treiberebene und kein Phosphene-Fehlerbericht, und er kommt am häufigsten auf M1- und M2-Macs vor. Phosphene rendert denselben Auftrag sofort noch einmal in kurzen GPU-Schritten (kleinere Stücke GPU-Arbeit, etwas langsamer) und merkt sich die Größe: Das nächste Rendering auf diesem Mac startet in kurzen Schritten, und die Zeile Warteschlange sagt das. Wenn macOS es auch in kurzen Schritten stoppt, wird diese Größe auf diesem Mac 24 Stunden lang (oder bis zum nächsten Update) pausiert, und die Karte bietet Kleiner erneut versuchen an. Wenn es immer wieder passiert, verlinkt die Meldung das GitHub-Issue, in dem Chip, macOS-Version und Absturzprotokoll am meisten helfen.

Ein Charakter-Training ist fehlgeschlagen

“training exited with code 1”: Der Trainer hat vor dem Ende gestoppt. Den eigentlichen Grund findest du im Tab Protokoll: ein Abbruch wegen zu wenig Speicher (wechsle zu einem Mac mit mehr RAM oder, falls vorhanden, zu einem kleineren Preset), ein fehlender Download für das LTX-2.3-Training (die Prüfkarte im Tab Training bietet ihn an) oder eine Zeitüberschreitung beim Kodieren einer sehr langen Beschreibung. Ein Training unter 24 GB schlägt immer fehl: Dieser Mac kann es nicht ausführen.

Das Panel meldet, dass es offline ist

“Phosphene offline”, und ein Druck auf Generieren bewirkt nichts: Der Panel-Prozess antwortet nicht. Nichts von dem, was du getippt hast, geht verloren: Der Prompt bleibt, wie du ihn verlassen hast, und die Seite verbindet sich wieder und nimmt die Warteschlange von selbst auf, sobald das Panel wieder läuft. Starte es über die Phosphene-Seitenleiste von Pinokio, falls es nicht innerhalb weniger Sekunden zurückkommt.

Die Warteschlange hat sich selbst pausiert

“Queue paused: the last N renders failed the same way”: Wenn drei Renderings hintereinander am selben Problem scheitern, hört Phosphene auf, den Rest der Warteschlange an etwas zu verbrennen, das ein erneuter Versuch nicht beheben kann. Behebe die Ursache, die die Meldung nennt, und drücke dann Fortsetzen; oder Warteschlange leeren, um den Rest zu verwerfen und neu anzufangen.

Die Warteschlange nach einem Neustart

Ein Neustart des Panels setzt die Warteschlange fort: Eine Warteschlange, die beim Stoppen des Panels pausiert war, startet von selbst wieder, und das Protokoll sagt das.

Das Protokoll lesen

Der Tab Protokoll im unteren Bereich zeigt das Render-Protokoll. Wenn ein Rendering abbricht, nennt die letzte Zeile, die mit step: beginnt, die Phase, die es erreicht hat: Diese Zeile ist das Nützlichste für einen Bericht. Das Terminal von Pinokio zeigt dieselbe Ausgabe.

Ein Problem melden

Die Käfer-Schaltfläche in der Kopfzeile öffnet Fehler melden. Schreibe ein oder zwei Sätze unter Was ist passiert? (mindestens 10 Zeichen, denn das Protokoll kann nicht sagen, was du gesehen hast); es füllt Version, die Daten deines Macs und das jüngste Protokoll aus, wobei Fehlerzeilen vor Routinezeilen stehen, und öffnet in einem neuen Tab ein GitHub-Issue, das du abschließt: Nichts wird gesendet, bevor du es dort abschickst. Die Issues findest du unter github.com/mrbizarro/phosphene/issues.

Quelle: webapp/docs/troubleshooting.md im öffentlichen Repo. Für diese Website vor der Veröffentlichung geprüft. Aus dem englischen Original übersetzt. Änderung vorschlagen.