Wo befindet sich das Hugging Face-Cache-Verzeichnis?

Für Hugging Face Hub ist ~/.cache/huggingface/hub das dokumentierte Standard-Cache-Verzeichnis. Der aktive Speicherort kann jedoch überschrieben werden; prüfen Sie daher Konfiguration und Cache selbst, bevor Sie einen Ordner als entbehrlich einstufen.

Standardpfad und dokumentierte Überschreibungen

Der Hub-Cache speichert heruntergeladene Modell-, Datensatz- und Space-Repositorys unter seinem Cache-Stammverzeichnis. Das Standard-Stammverzeichnis lautet ~/.cache/huggingface/hub. Darin heißen Repositorys häufig wie models--organization--repository und enthalten Verzeichnisse für Blobs, Snapshots und Referenzen.

• HF_HUB_CACHE legt das Hub-Cache-Verzeichnis direkt fest und hat Vorrang.
• HF_HOME legt das Hugging Face-Stammverzeichnis fest; wenn es gesetzt ist, befindet sich der Hub-Cache unter HF_HOME/hub.
• Einzelne Bibliotheksaufrufe können ebenfalls ein Cache-Verzeichnis angeben; ein Projekt kann daher einen Pfad verwenden, der nicht dem globalen Standard entspricht.

Vor jeder Freigabe untersuchen

Verwenden Sie die Hugging Face-CLI, um zu sehen, was ihre Cache-Verwaltung über den aktiven Cache weiß. Der dokumentierte Befehl hf cache ls listet zwischengespeicherte Repositorys, Größe und Zugriffsinformationen auf. Wenn Sie den Cache verschoben haben, verwenden Sie Cache-Verwaltungsbefehle zusammen mit der entsprechenden Cache-Verzeichnisoption, statt den Standard anzunehmen.

# Anzeigen, welchen Speicherort diese Shell verwendet
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Zwischengespeicherte Repositorys vor dem Beschneiden erfassen
hf cache ls

Bestimmen Sie vor dem Entfernen eines Snapshots das Projekt, die Laufzeitumgebung und die Revision, die ihn verwenden. Ein Cache kann mehr als die vorgestellte Modelldatei enthalten, und ein Quellbaum oder lokaler Inferenzablauf kann von einer zwischengespeicherten Revision abhängen, die in einem Dateibrowser nicht offensichtlich ist.

Cache-Bereinigung im Vergleich zur langfristigen Aufbewahrung

Der Hugging Face-Cache ist darauf optimiert, unnötige Downloads zu vermeiden. Er ist nicht automatisch ein langfristiger Katalog der Modellversionen, die Sie bewahren möchten. Wenn eine Gruppe abgeschlossener Modellartefakte für Ihre Arbeit wichtig ist, entscheiden Sie zuerst, was Sie später wiederherstellen müssen, und bewahren Sie gegebenenfalls eine unabhängige Sicherung auf.

Nach dieser Entscheidung kommt Tensor Archive zum Einsatz: Es kann eine zusammengehörige lokale Familie bewahren, prüfen und als separate exakte Kopie wiederherstellen, bevor Sie manuell eine redundante Arbeitskopie entfernen. Es ersetzt weder die eigene Cache-Verwaltung von Hugging Face noch gibt es einer aktiven Bibliothek vor, wohin Modelle heruntergeladen werden.

Eine sichere Schrittfolge

1. Prüfen Sie, ob HF_HUB_CACHE oder HF_HOME den aktiven Speicherort ändert.
2. Listen Sie den Cache mit den Hugging Face-Werkzeugen auf und bestimmen Sie die Repositorys, die Sie nicht unmittelbar benötigen.
3. Bewahren oder sichern Sie unabhängig jede wichtige Modellversion.
4. Analysieren und archivieren Sie eine abgeschlossene zusammengehörige Familie, prüfen Sie sie und stellen Sie eine separate Kopie wieder her, bevor Sie manuell Speicherplatz freigeben.

Befindet sich der Cache auf der falschen Festplatte, ändern Sie das Hugging Face-Cache-Verzeichnis mit der richtigen Umgebungsvariable. Sind veraltete Revisionen das Problem, leeren Sie den Hugging Face-Cache sicher über die Cache-Verwaltung. Dateien einer anderen Laufzeitumgebung benötigen deren eigenen Speicherleitfaden.