AskClean

Jak wyczyścić pamięć podręczną Hugging Face na Macu

Zespół AskClean · Zaktualizowano 2026-11-02

Aby odzyskać miejsce zajmowane przez pamięć podręczną Hugging Face na Macu, ustal, której pamięci podręcznej używa Twoja aplikacja, przejrzyj ją poleceniem hf cache ls, a usunięcie konkretnego repozytorium lub rewizji sprawdź najpierw przez hf cache rm --dry-run. Zachowaj modele potrzebne offline i własną pracę. Nie usuwaj w ciemno współdzielonych blobów ani całego folderu HF_HOME.

Ilustracja koncepcyjna: rewizje modeli połączone ze współdzielonymi blokami danych, a pliki projektu trzymane osobno
Kilka rewizji może współdzielić te same pliki. Własne checkpointy i pracę projektową przechowuj osobno. Ilustracja koncepcyjna.

Oddziel pobrane modele od własnej pracy

Zanim usuniesz model, sprawdź, która aplikacja lub które środowisko Pythona go używa, której rewizji potrzebuje projekt i czy korzystasz z niego offline. Zacznij od wpisu, którego już nie potrzebujesz i który umiesz odtworzyć. Duży lub nieznany folder może nadal zawierać pliki, od których zależy aplikacja.

Oddziel pobrania od tego, co powstało u Ciebie: dostrojonych checkpointów, adapterów, zmian tokenizera, wyników konwersji, prywatnych zbiorów danych, notatników, promptów i konfiguracji projektu. Bazowy model zwykle da się pobrać ponownie, ale lokalny adapter czy przepis konwersji może istnieć tylko na tym Macu — zrób jego kopię zapasową i sprawdź ją, zanim zaczniesz odzyskiwać miejsce. Niektóre narzędzia do kopii zapasowych pomijają katalogi oznaczone plikiem CACHEDIR.TAG, więc upewnij się, że kopia naprawdę zawiera potrzebne pliki. Jeśli nie wiesz, jak odtworzyć dany element i przywrócić działanie aplikacji, na razie go zostaw.

Znajdź pamięć podręczną, której naprawdę używa aplikacja

Typowa pamięć podręczna Hub to ~/.cache/huggingface/hub. Zmienna HF_HUB_CACHE wskazuje bezpośrednio pamięć repozytoriów Hub, HF_HOME zmienia szerszy katalog domowy Hugging Face, a gdy HF_HOME nie jest ustawiona, na domyślną lokalizację może wpływać XDG_CACHE_HOME. Inne miejsce może też wskazać argument cache_dir w aplikacji. Sprawdzaj środowisko, które uruchamia aplikację, zamiast zakładać, że każda aplikacja ma te same ustawienia co Twój terminal.

HF_HOME może zawierać dane uwierzytelniania, dlatego nie usuwaj całego katalogu tylko po to, żeby pozbyć się pobranych modeli. Aplikacje graficzne, jądra notatników i projekty uruchamiane z wiersza poleceń sprawdzaj osobno — mogą korzystać z różnych ustawień, a pusty domyślny katalog Hub nie znaczy, że na Macu nie ma modeli. Jeśli prosisz kogoś o pomoc, udostępniaj tylko potrzebne ustawienia bez wrażliwych wartości, a pliki uwierzytelniania i listy prywatnych repozytoriów trzymaj z dala od zgłoszeń.

Polecenia sprawdziliśmy 29 września 2026 r. z huggingface_hub 2.0.0. Najpierw uruchom hf cache --help w swoim środowisku; jeśli Twoja wersja ma inne polecenia lub opcje, kieruj się jej dokumentacją.

Przejrzyj repozytoria i rewizje, zanim wybierzesz cel

Zacznij od hf cache ls --no-truncate, aby zobaczyć pełne identyfikatory repozytoriów, a potem uruchom hf cache ls --revisions --no-truncate --show-warnings, aby sprawdzić pełne skróty rewizji i ewentualne problemy z pamięcią podręczną — w sprawdzonej wersji szczegółowe ostrzeżenia są domyślnie ukryte. Przy niestandardowej pamięci podręcznej podawaj tę samą wartość --cache-dir w każdym poleceniu. Nie udostępniaj wyników, jeśli zdradzają poufne projekty.

Rozmiar wyświetlany przy rewizji może być większy niż miejsce, które zwolni jej usunięcie: migawki (snapshots) mogą współdzielić dane, a w niektórych układach bloby są współdzielone nawet między repozytoriami, więc sumowanie rozmiarów może policzyć te same pliki kilka razy. Przed usunięciem zbadaj ostrzeżenia o nieczytelnych lub niespójnych wpisach. Wybierz konkretny cel — porzucony eksperyment albo rewizję, której projekt już nie używa — i sprawdź w kodzie i konfiguracji przypięte rewizje. Sam wiek modelu nie jest powodem do usunięcia.

  1. Zamknij aplikacje i zadania, które korzystają z wybranej pamięci podręcznej.
  2. Uruchom hf cache ls --no-truncate, a potem hf cache ls --revisions --no-truncate --show-warnings dla potwierdzonej ścieżki pamięci podręcznej.
  3. Sprawdź, czy któraś aplikacja lub projekt nadal potrzebuje wybranego repozytorium i rewizji.
  4. Zanim cokolwiek zmienisz, zapisz bieżący rozmiar katalogu i ilość wolnego miejsca.

Zrób podgląd usuwania przed zatwierdzeniem

Użyj hf cache rm z jednym pełnym identyfikatorem repozytorium lub skrótem rewizji z inwentaryzacji i najpierw dodaj --dry-run. Przy repozytorium modelu zachowaj prefiks model/ wyświetlany przez CLI — nazwa folderu na dysku zaczynająca się od models-- to nie ten sam identyfikator. Dla pojedynczej rewizji podaj pełny skrót i sprawdź, do którego repozytorium należy.

Podgląd pokazuje podsumowanie celów i szacowaną oszczędność miejsca, a nie listę wszystkich plików. Wybranie repozytorium obejmuje wszystkie jego zapisane rewizje, więc jeśli chcesz usunąć tylko jedną, wskaż rewizję. Po sprawdzeniu zakresu powtórz to samo polecenie bez --dry-run, z tym samym celem i katalogiem, i zostaw włączone pytanie o potwierdzenie. Jeśli lista nieoczekiwanie się zmieni albo podgląd się nie powiedzie, przerwij i ustal przyczynę. Współdzielonymi blobami i odwołaniami migawek niech zarządza menedżer pamięci podręcznej Hugging Face — usuwanie pojedynczych plików w Finderze może uszkodzić inne rewizje.

Usuwanie z pamięci podręcznej kasuje pliki bezpośrednio, bez przenoszenia do Kosza. Aby przywrócić usuniętą rewizję, potrzebujesz działającej kopii zapasowej albo ponownego pobrania. Zachowaj kopię do czasu, aż testy się powiodą — zwłaszcza w przypadku modeli prywatnych, z ograniczonym dostępem (gated), wycofanych z publikacji, zmodyfikowanych lokalnie lub potrzebnych offline.

Cel wybieraj na podstawie własnej inwentaryzacji pamięci podręcznej. Przed uruchomieniem usuwania dokładnie sprawdź zarówno repozytorium, jak i rewizję.

Ostrożnie z prune i z pozostałymi pamięciami podręcznymi

W sprawdzonej wersji CLI 2.0.0 hf cache prune --dry-run pokazuje odłączone (detached) rewizje i niedokończone pobrania. Odłączona rewizja nie ma w pamięci podręcznej nazwanego odwołania, ale projekt może nadal żądać dokładnie tej rewizji — CLI nie wie, których modeli zamierzasz użyć. Przy pierwszym czyszczeniu jedno jawne usunięcie łatwiej ocenić niż szerokie porządki; jeśli potem użyjesz prune, sprawdź każdego kandydata i najpierw zatrzymaj aktywne pobieranie, bo niedokończony plik może należeć do trwającego transferu.

Hugging Face Datasets może przechowywać przetworzone dane we własnej pamięci podręcznej: HF_DATASETS_CACHE i HF_HUB_CACHE mają różny zakres, a usunięcie pobrań Hub nie usuwa danych Arrow ani wyników przetwarzania. Pobrania z jawnie podanym local_dir trafiają do wskazanego katalogu razem z metadanymi — traktuj go oddzielnie i zachowaj lokalne zmiany, bo ponowne pobranie ich nie przywróci. Osobno sprawdź też pamięć transferów Xet. Jeśli zajętość dysku nadal jest wysoka, przeglądaj każdą z tych kategorii oddzielnie.

Sprawdź, czy pozostałe modele nadal działają

Powtórz inwentaryzację i pomiary dysku, a potem wczytaj model i rewizję, które miały zostać, i wykonaj małe zadanie ze znanym wynikiem — sam import biblioteki Pythona nie sprawdza plików modelu. Jeśli potrzebujesz pracy offline, przetestuj ją przy odłączonej sieci. Gdy następne uruchomienie ponownie pobiera ten sam model, czyszczenie mogło usunąć dane, których zadanie nadal potrzebuje — wróć do wyboru celów, pojemności dysku lub lokalizacji pamięci podręcznej, zamiast w kółko usuwać i pobierać ten sam model.

Jeśli regularnie potrzebne modele przekraczają pojemność Maca, pomóc może dysk zewnętrzny. Sprawdź wolne miejsce, uprawnienia i obsługę dowiązań symbolicznych, które łączą migawki ze współdzielonymi blobami; przy kopiowaniu zachowaj dowiązania i pliki, na które wskazują. Skonfiguruj każdą aplikację do nowej lokalizacji i przetestuj jej modele przed usunięciem oryginału, a dysk trzymaj podłączony, gdy aplikacje go potrzebują. Jeśli test się nie powiedzie, wstrzymaj czyszczenie, zapisz lokalnie model, rewizję, ścieżkę i błąd, przywróć kopię lub pobierz rewizję ponownie i rozwiąż problem, zanim usuniesz kolejny wpis.

Jak sprawdziliśmy te polecenia

29 września 2026 r. utworzyliśmy offline tymczasową pamięć podręczną w układzie Hub z dwiema syntetycznymi rewizjami, jednym współdzielonym blobem i osobnym blobem dla każdej rewizji. Z huggingface_hub 2.0.0 listowanie rewizji się powiodło, podglądy rm i prune nie zmieniły danych testowych, a usunięcie starej rewizji zachowało bieżącą rewizję i jej współdzielone dane, kasując tylko blob należący wyłącznie do starej rewizji. Drugi test offline potwierdził, że --show-warnings ujawnia celowo uszkodzony wpis, --no-truncate zachowuje pełny identyfikator rewizji, a podglądy przyjmują zarówno identyfikator repozytorium z prefiksem typu, jak i pełny skrót rewizji.

Testy dotyczyły syntetycznych plików w folderach tymczasowych. Nie obejmowały prawdziwych pobrań modeli, inferencji, pamięci podręcznej użytkownika, migracji na inny dysk ani czyszczenia blobów współdzielonych między repozytoriami, nie przewidują więc, ile gigabajtów zwolnisz, i nie potwierdzają każdego formatu pamięci podręcznej. AskClean pomoże Ci zobaczyć, co zajmuje miejsce na Macu: skanowanie i podgląd są bezpłatne, a analiza AI i czyszczenie wymagają wersji Pro. Czyszczenie dysku trwale usuwa zatwierdzone elementy — rewizjami i współdzielonymi plikami zarządzaj przez CLI Hugging Face, a własną pracę trzymaj poza zaznaczeniem.

Co da się odtworzyć, a co trzeba zachować

Każdą kategorię sprawdzaj osobno. Tabela pokazuje, co trzeba zachować lub przywrócić; nie wskazuje plików do automatycznego usunięcia.

ElementGdzie sprawdzićCo sprawdzić przed usunięciem
Repozytorium lub rewizja Hubhf cache ls --revisionsSprawdź dokładny wybór. Przywrócenie może wymagać ponownego pobrania i dostępu do tego samego repozytorium.
Współdzielone bloby i migawkiPotwierdzona pamięć podręczna HubUżywaj menedżera pamięci podręcznej; rewizje, a w niektórych układach także repozytoria, mogą współdzielić te same pliki.
Odłączone (detached) rewizjehf cache prune --dry-runProjekt może nadal potrzebować dokładnie tej rewizji, nawet jeśli pamięć podręczna nie ma do niej nazwanego odwołania.
Pamięć podręczna wygenerowanych zbiorów danychHF_DATASETS_CACHE / ustawienia pamięci podręcznej DatasetsOddzielna od pobrań Hub; odtworzenie może wymagać czasu przetwarzania i danych źródłowych.
Własne checkpointy, adaptery i źródłaTwój projekt i lokalizacje kopii zapasowychZachowaj własną pracę. Sprawdź, czy kopie zapasowe ją obejmują, zwłaszcza gdy leży w katalogu pamięci podręcznej.
Katalog domowy Hugging Face i dane uwierzytelnianiaHF_HOMENie usuwaj całego katalogu domowego, żeby pozbyć się wpisów pamięci podręcznej modeli.

Test regresyjny używał małej, syntetycznej pamięci podręcznej. Jej rozmiar nie jest benchmarkiem ani szacunkiem rzeczywistej oszczędności miejsca.

FAQ

Czy mogę usunąć ~/.cache/huggingface na Macu?

Nie traktuj całego katalogu jako zbędnego. Znajdź aktywną pamięć podręczną Hub, zachowaj dane uwierzytelniania i własną pracę, a potem zrób podgląd usunięcia konkretnych repozytoriów lub rewizji za pomocą zainstalowanego interfejsu hf cache.

Dlaczego usunięcie jednej rewizji zwalnia mniej miejsca, niż pokazuje jej rozmiar?

Rewizje mogą współdzielić pliki, a w niektórych układach pamięci podręcznej — także repozytoria. Sprawdź szacunek z podglądu i porównaj zajętość dysku oraz wolne miejsce przed usunięciem i po nim. Sumowanie wyświetlanych rozmiarów rewizji może policzyć te same pliki kilka razy.

Czy odłączona (detached) rewizja oznacza, że żadna aplikacja jej nie używa?

Nie. Projekt może przypinać dokładną rewizję, nawet jeśli w pamięci podręcznej nie ma do niej nazwanego odwołania. Przed użyciem prune sprawdź wymagania projektu.

Czy po czyszczeniu modele będą dostępne offline?

Zadania, które potrzebują modeli offline, obsłużą tylko zachowane, kompletne pliki w pamięci podręcznej. Sprawdź reprezentatywne wczytanie modelu bez sieci, zanim usuniesz kopię zapasową albo zaczniesz pracować bez połączenia.

Czy hf cache rm usunie mój dostrojony model?

Może, jeśli Twoje własne pliki leżą w wybranym wpisie pamięci podręcznej. Trzymaj checkpointy, adaptery i zmodyfikowane pliki poza wpisami, które planujesz usunąć, i sprawdź ich kopie zapasowe. Folder o nazwie cache może zawierać jedyną kopię ważnej pracy.

Źródła

Więcej poradników o modelach i danych deweloperskich