+ Q\i,nRt^RIHt^RIHtHt^RIHtHt!RR] 4t !RR] 4t !RR ] 4t !R R ]4t!R R ]4t!RR]]4t!RR] 4t!RR]]4t!RR] 4t!RR] 4t!RR]4t!RR]4t!RR]4t!RR]4t!R R!]4t!R"R#]4t!R$R%]4t!R&R']4t !R(R)]4t!!R*R+]!4t"!R,R-]4t#!R.R/]4t$!R0R1]4t%!R2R3]%]&]4t'!R4R5]]4t(!R6R7] 4t)!R8R9])4t*!R:R;])4t+!R<R=]+4t,!R>R?] 4t-!R@RA]-4t.!RBRC]-4t/!RDRE]-4t0!RFRG] 4t1!RHRI]14t2!RJRK]14t3!RLRM] 4t4RN#)OzContains all custom errors.)Path)OptionalUnion) HTTPErrorResponsecNaa]tRt^ toRtV3RlV3RlltV3RltRtVtV;t #) CacheNotFoundz9Exception thrown when the Huggingface cache is not found.c<<V^8dQhRS[RS[S[S[3,/#)msg cache_dir)strrr)format __classdict__s"n/Users/agent/.cache/uv/archive-v0/6ZL4-8mCcRNgGE9wi6M6J/lib/python3.14/site-packages/huggingface_hub/errors.py __annotate__CacheNotFound.__annotate__s$##C#E#t),<#c<<\SV`!V.VO5/VBW nR#N)super__init__r )selfr r argskwargs __class__s&&&*,rrCacheNotFound.__init__s .t.v."rc<<V^8dQh/S[S[S[3,;R&#)r r )rr r)rrs"rrr sS$Yr)r ) __name__ __module__ __qualname____firstlineno____doc__r__annotate_func____static_attributes____classdictcell__ __classcell__rrs@@rrr sC## rrc]tRt^tRtRtR#)CorruptedCacheExceptionzGException for any unexpected structure in the Huggingface cache-system.Nrrr r!r"r$r*rrr)r)sQrr)c]tRt^tRtRtR#)LocalTokenNotFoundErrorz0Raised if local token is required but not found.r*Nr+r*rrr-r-:rr-c]tRt^$tRtRtR#)OfflineModeIsEnabledzTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.r*Nr+r*rrr0r0$s^rr0c`aa]tRt^(toRtR RR/V3RlV3RlllltV3RlRltRtVtV;t #) HfHubHTTPErroraA HTTPError to inherit from for any custom HTTP Error raised in HF Hub. Any HTTPError is converted at least into a `HfHubHTTPError`. If some information is sent back by the server, it will be added to the error message. Added details: - Request ID sourced from headers in order of precedence: "X-Request-Id", "X-Amzn-Trace-Id", "X-Amz-Cf-Id". - Server error message from the header "X-Error-Message". - Server error message if we can found one in the response body. Example: ```py import requests from huggingface_hub.utils import get_session, hf_raise_for_status, HfHubHTTPError response = get_session().post(...) try: hf_raise_for_status(response) except HfHubHTTPError as e: print(str(e)) # formatted message e.request_id, e.server_message # details returned by server # Complete the error message with additional information once it's raised e.append_to_message(" `create_commit` expects the repository to exist.") raise ``` Nserver_messagecL<V^8dQhRS[RS[S[,RS[S[,/#)r messageresponser3)r rr)rrs"rrHfHubHTTPError.__annotate__Fs.   x/A ]efi]j rc0<VebVPPR4;'g?VPPR4;'gVPPR4MRVnW0n\ST`TTVe VP MRR7R#)Nz x-request-idzX-Amzn-Trace-Idz x-amz-cf-id)r6request)headersget request_idr3rrr9)rr5r6r3rs&&&$rrHfHubHTTPError.__init__Fs #     0 3 3##$56 3 3##M2 -  (0(>> from huggingface_hub import model_info >>> model_info("") (...) huggingface_hub.utils._errors.RepositoryNotFoundError: 401 Client Error. (Request ID: PvMw_VjBMjVdMz53WKIzP) Repository Not Found for url: https://huggingface.co/api/models/%3Cnon_existent_repository%3E. Please make sure you specified the correct `repo_id` and `repo_type`. If the repo is private, make sure you are authenticated. Invalid username or password. ``` r*Nr+r*rrreresrrec]tRt^tRtRtR#)GatedRepoErrora Raised when trying to access a gated repository for which the user is not on the authorized list. Note: derives from `RepositoryNotFoundError` to ensure backward compatibility. Example: ```py >>> from huggingface_hub import model_info >>> model_info("") (...) huggingface_hub.utils._errors.GatedRepoError: 403 Client Error. (Request ID: ViT1Bf7O_026LGSQuVqfa) Cannot access gated repo for url https://huggingface.co/api/models/ardent-figment/gated-model. Access to model ardent-figment/gated-model is restricted and you are not in the authorized list. Visit https://huggingface.co/ardent-figment/gated-model to ask for access. ``` r*Nr+r*rrrgrgsrrgc]tRt^tRtRtR#)DisabledRepoErrora Raised when trying to access a repository that has been disabled by its author. Example: ```py >>> from huggingface_hub import dataset_info >>> dataset_info("laion/laion-art") (...) huggingface_hub.utils._errors.DisabledRepoError: 403 Client Error. (Request ID: Root=1-659fc3fa-3031673e0f92c71a2260dbe2;bc6f4dfb-b30a-4862-af0a-5cfe827610d8) Cannot access repository for url https://huggingface.co/api/datasets/laion/laion-art. Access to this resource is disabled. ``` r*Nr+r*rrririrric]tRt^tRtRtR#)RevisionNotFoundErrora Raised when trying to access a hf.co URL with a valid repository but an invalid revision. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', 'config.json', revision='') (...) huggingface_hub.utils._errors.RevisionNotFoundError: 404 Client Error. (Request ID: Mwhe_c3Kt650GcdKEFomX) Revision Not Found for url: https://huggingface.co/bert-base-cased/resolve/%3Cnon-existent-revision%3E/config.json. ``` r*Nr+r*rrrlrlrjrrlc]tRtRtRtRtR#)EntryNotFoundErroria Raised when trying to access a hf.co URL with a valid repository and revision but an invalid filename. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', '') (...) huggingface_hub.utils._errors.EntryNotFoundError: 404 Client Error. (Request ID: 53pNl6M0MxsnG5Sw8JA6x) Entry Not Found for url: https://huggingface.co/bert-base-cased/resolve/main/%3Cnon-existent-file%3E. ``` r*Nr+r*rrrnrnrjrrncBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)LocalEntryNotFoundErroria Raised when trying to access a file or snapshot that is not on the disk when network is disabled or unavailable (connection issue). The entry may exist on the Hub. Note: `ValueError` type is to ensure backward compatibility. Note: `LocalEntryNotFoundError` derives from `HTTPError` because of `EntryNotFoundError` even when it is not a network issue. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', '', local_files_only=True) (...) huggingface_hub.utils._errors.LocalEntryNotFoundError: Cannot find the requested files in the disk cache and outgoing traffic has been disabled. To enable hf.co look-ups and downloads online, set 'local_files_only' to False. ``` c <V^8dQhRS[/#)r r5rA)rrs"rr$LocalEntryNotFoundError.__annotate__(s111rc*<\SV`VRR7R#)N)r6)rr)rr5rs&&rr LocalEntryNotFoundError.__init__(s 40rr* rrr r!r"rr$r%r&r's@@rrprps$111rrpc]tRtRtRtRtR#)BadRequestErrori-a1 Raised by `hf_raise_for_status` when the server returns a HTTP 400 error. Example: ```py >>> resp = requests.post("hf.co/api/check", ...) >>> hf_raise_for_status(resp, endpoint_name="check") huggingface_hub.utils._errors.BadRequestError: Bad request for check endpoint: {details} (Request ID: XXX) ``` r*Nr+r*rrrwrw-s rrwc]tRtRtRtRtR#) DDUFErrori>z5Base exception for errors related to the DDUF format.r*Nr+r*rrryry>s?rryc]tRtRtRtRtR#)DDUFCorruptedFileErroriBz1Exception thrown when the DDUF file is corrupted.r*Nr+r*rrr{r{B;rr{c]tRtRtRtRtR#)DDUFExportErroriFz-Base exception for errors during DDUF export.r*Nr+r*rrr~r~Fs7rr~c]tRtRtRtRtR#)DDUFInvalidEntryNameErroriJz0Exception thrown when the entry name is invalid.r*Nr+r*rrrrJr.rrc]tRtRtRtRtR#)StrictDataclassErroriQz&Base exception for strict dataclasses.r*Nr+r*rrrrQs0rrc]tRtRtRtRtR#)StrictDataclassDefinitionErroriUz@Exception thrown when a strict dataclass is defined incorrectly.r*Nr+r*rrrrUsJrrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)#StrictDataclassFieldValidationErroriYzLException thrown when a strict dataclass fails validation for a given field.c&<V^8dQhRS[RS[/#)r fieldcauser Exception)rrs"rr0StrictDataclassFieldValidationError.__annotate__\s((c()(rcx<RV R2pVRVPP RV 2, p\SV` V4R#)zValidation error for field '': : Nrrrr)rrr error_messagers&&& rr,StrictDataclassFieldValidationError.__init__\s@6ugR@ 6%//":":!;2eWEE  'rr*rur's@@rrrYsV(((rrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)#StrictDataclassClassValidationErroribzOException thrown when a strict dataclass fails validation on a class validator.c&<V^8dQhRS[RS[/#)r validatorrr)rrs"rr0StrictDataclassClassValidationError.__annotate__es((#(i(rcx<RV R2pVRVPP RV 2, p\SV` V4R#)z&Class validation error for validator 'rrrNr)rrrrrs&&& rr,StrictDataclassClassValidationError.__init__es@@ 2N 6%//":":!;2eWEE  'rr*rur's@@rrrbsY(((rrc]tRtRtRtRtR#)XetErrorinz1Base exception for errors related to Xet Storage.r*Nr+r*rrrrnr|rrc]tRtRtRtRtR#)XetAuthorizationErrorirzXException thrown when the user does not have the right authorization to use Xet Storage.r*Nr+r*rrrrrsbrrc]tRtRtRtRtR#)XetRefreshTokenErrorivz3Exception thrown when the refresh token is invalid.r*Nr+r*rrrrvrSrrc]tRtRtRtRtR#)XetDownloadErrorizz:Exception thrown when the download from Xet Storage fails.r*Nr+r*rrrrzsDrrN)5r"pathlibrtypingrrrequestsrrrrr)EnvironmentErrorr-ConnectionErrorr0r2 TimeoutErrorrGrIrKrMrPrRrUrWr[r]r_ ValueErrorraOSErrorrcrergrirlrnFileNotFoundErrorrprwryr{r~rrrrrrrrrr*rrrs!"( #I#RiR;.;_?_0IY0IlMI|MCYCG$:LGiy>)> ()( )  )  3  &  n*,,*N&$102CZ10 nj "@ @((*>(8>EyEr