huggingface-hub 0.26.4__tar.gz → 0.27.0rc1__tar.gz

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: huggingface_hub
-Version: 0.26.4
+Version: 0.27.0rc1
 Summary: Client library to download and publish models, datasets and other repos on the huggingface.co hub
 Home-page: https://github.com/huggingface/huggingface_hub
 Author: Hugging Face, Inc.
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.8.0
 Description-Content-Type: text/markdown
@@ -38,10 +39,14 @@ Provides-Extra: dev
 License-File: LICENSE
 
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg">
+    <img alt="huggingface_hub library logo" src="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg" width="352" height="59" style="max-width: 100%;">
+  </picture>
   <br/>
-    <img alt="huggingface_hub library logo" src="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg" width="376" height="59" style="max-width: 100%;">
   <br/>
-</p>
+</p> 
 
 <p align="center">
     <i>The official Python client for the Huggingface Hub.</i>

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/README.md

@@ -1,8 +1,12 @@
 <p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg">
+    <img alt="huggingface_hub library logo" src="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg" width="352" height="59" style="max-width: 100%;">
+  </picture>
   <br/>
-    <img alt="huggingface_hub library logo" src="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg" width="376" height="59" style="max-width: 100%;">
   <br/>
-</p>
+</p> 
 
 <p align="center">
     <i>The official Python client for the Huggingface Hub.</i>

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/setup.py

@@ -134,6 +134,7 @@ setup(
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
         "Topic :: Scientific/Engineering :: Artificial Intelligence",
     ],
     include_package_data=True,

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/src/huggingface_hub/__init__.py

@@ -46,7 +46,7 @@ import sys
 from typing import TYPE_CHECKING
 
 
-__version__ = "0.26.4"
+__version__ = "0.27.0.rc1"
 
 # Alphabetical order of definitions is ensured in tests
 # WARNING: any comment added in this dictionary definition will be lost when
@@ -70,10 +70,6 @@ _SUBMOD_ATTRS = {
         "logout",
         "notebook_login",
     ],
-    "_multi_commits": [
-        "MultiCommitException",
-        "plan_multi_commits",
-    ],
     "_snapshot_download": [
         "snapshot_download",
     ],
@@ -167,7 +163,6 @@ _SUBMOD_ATTRS = {
         "create_branch",
         "create_collection",
         "create_commit",
-        "create_commits_on_pr",
         "create_discussion",
         "create_inference_endpoint",
         "create_pull_request",
@@ -213,7 +208,6 @@ _SUBMOD_ATTRS = {
         "list_datasets",
         "list_inference_endpoints",
         "list_liked_repos",
-        "list_metrics",
         "list_models",
         "list_organization_members",
         "list_papers",
@@ -297,10 +291,14 @@ _SUBMOD_ATTRS = {
         "ChatCompletionInputFunctionDefinition",
         "ChatCompletionInputFunctionName",
         "ChatCompletionInputGrammarType",
+        "ChatCompletionInputGrammarTypeType",
         "ChatCompletionInputMessage",
         "ChatCompletionInputMessageChunk",
+        "ChatCompletionInputMessageChunkType",
         "ChatCompletionInputStreamOptions",
-        "ChatCompletionInputToolType",
+        "ChatCompletionInputTool",
+        "ChatCompletionInputToolChoiceClass",
+        "ChatCompletionInputToolChoiceEnum",
         "ChatCompletionInputURL",
         "ChatCompletionOutput",
         "ChatCompletionOutputComplete",
@@ -327,6 +325,7 @@ _SUBMOD_ATTRS = {
         "DocumentQuestionAnsweringOutputElement",
         "DocumentQuestionAnsweringParameters",
         "FeatureExtractionInput",
+        "FeatureExtractionInputTruncationDirection",
         "FillMaskInput",
         "FillMaskOutputElement",
         "FillMaskParameters",
@@ -337,6 +336,7 @@ _SUBMOD_ATTRS = {
         "ImageSegmentationInput",
         "ImageSegmentationOutputElement",
         "ImageSegmentationParameters",
+        "ImageSegmentationSubtask",
         "ImageToImageInput",
         "ImageToImageOutput",
         "ImageToImageParameters",
@@ -350,6 +350,7 @@ _SUBMOD_ATTRS = {
         "ObjectDetectionInput",
         "ObjectDetectionOutputElement",
         "ObjectDetectionParameters",
+        "Padding",
         "QuestionAnsweringInput",
         "QuestionAnsweringInputData",
         "QuestionAnsweringOutputElement",
@@ -359,12 +360,15 @@ _SUBMOD_ATTRS = {
         "SummarizationInput",
         "SummarizationOutput",
         "SummarizationParameters",
+        "SummarizationTruncationStrategy",
         "TableQuestionAnsweringInput",
         "TableQuestionAnsweringInputData",
         "TableQuestionAnsweringOutputElement",
+        "TableQuestionAnsweringParameters",
         "Text2TextGenerationInput",
         "Text2TextGenerationOutput",
         "Text2TextGenerationParameters",
+        "Text2TextGenerationTruncationStrategy",
         "TextClassificationInput",
         "TextClassificationOutputElement",
         "TextClassificationOutputTransform",
@@ -375,6 +379,7 @@ _SUBMOD_ATTRS = {
         "TextGenerationOutput",
         "TextGenerationOutputBestOfSequence",
         "TextGenerationOutputDetails",
+        "TextGenerationOutputFinishReason",
         "TextGenerationOutputPrefillToken",
         "TextGenerationOutputToken",
         "TextGenerationStreamOutput",
@@ -394,13 +399,15 @@ _SUBMOD_ATTRS = {
         "TextToSpeechInput",
         "TextToSpeechOutput",
         "TextToSpeechParameters",
+        "TokenClassificationAggregationStrategy",
         "TokenClassificationInput",
         "TokenClassificationOutputElement",
         "TokenClassificationParameters",
-        "ToolElement",
         "TranslationInput",
         "TranslationOutput",
         "TranslationParameters",
+        "TranslationTruncationStrategy",
+        "TypeEnum",
         "VideoClassificationInput",
         "VideoClassificationOutputElement",
         "VideoClassificationOutputTransform",
@@ -410,17 +417,15 @@ _SUBMOD_ATTRS = {
         "VisualQuestionAnsweringOutputElement",
         "VisualQuestionAnsweringParameters",
         "ZeroShotClassificationInput",
-        "ZeroShotClassificationInputData",
         "ZeroShotClassificationOutputElement",
         "ZeroShotClassificationParameters",
         "ZeroShotImageClassificationInput",
-        "ZeroShotImageClassificationInputData",
         "ZeroShotImageClassificationOutputElement",
         "ZeroShotImageClassificationParameters",
         "ZeroShotObjectDetectionBoundingBox",
         "ZeroShotObjectDetectionInput",
-        "ZeroShotObjectDetectionInputData",
         "ZeroShotObjectDetectionOutputElement",
+        "ZeroShotObjectDetectionParameters",
     ],
     "inference_api": [
         "InferenceApi",
@@ -456,12 +461,20 @@ _SUBMOD_ATTRS = {
         "get_tf_storage_size",
         "get_torch_storage_id",
         "get_torch_storage_size",
+        "load_state_dict_from_file",
+        "load_torch_model",
         "save_torch_model",
         "save_torch_state_dict",
         "split_state_dict_into_shards_factory",
         "split_tf_state_dict_into_shards",
         "split_torch_state_dict_into_shards",
     ],
+    "serialization._dduf": [
+        "DDUFEntry",
+        "export_entries_as_dduf",
+        "export_folder_as_dduf",
+        "read_dduf_file",
+    ],
     "utils": [
         "CacheNotFound",
         "CachedFileInfo",
@@ -601,10 +614,6 @@ if TYPE_CHECKING:  # pragma: no cover
         logout,  # noqa: F401
         notebook_login,  # noqa: F401
     )
-    from ._multi_commits import (
-        MultiCommitException,  # noqa: F401
-        plan_multi_commits,  # noqa: F401
-    )
     from ._snapshot_download import snapshot_download  # noqa: F401
     from ._space_api import (
         SpaceHardware,  # noqa: F401
@@ -694,7 +703,6 @@ if TYPE_CHECKING:  # pragma: no cover
         create_branch,  # noqa: F401
         create_collection,  # noqa: F401
         create_commit,  # noqa: F401
-        create_commits_on_pr,  # noqa: F401
         create_discussion,  # noqa: F401
         create_inference_endpoint,  # noqa: F401
         create_pull_request,  # noqa: F401
@@ -740,7 +748,6 @@ if TYPE_CHECKING:  # pragma: no cover
         list_datasets,  # noqa: F401
         list_inference_endpoints,  # noqa: F401
         list_liked_repos,  # noqa: F401
-        list_metrics,  # noqa: F401
         list_models,  # noqa: F401
         list_organization_members,  # noqa: F401
         list_papers,  # noqa: F401
@@ -822,10 +829,14 @@ if TYPE_CHECKING:  # pragma: no cover
         ChatCompletionInputFunctionDefinition,  # noqa: F401
         ChatCompletionInputFunctionName,  # noqa: F401
         ChatCompletionInputGrammarType,  # noqa: F401
+        ChatCompletionInputGrammarTypeType,  # noqa: F401
         ChatCompletionInputMessage,  # noqa: F401
         ChatCompletionInputMessageChunk,  # noqa: F401
+        ChatCompletionInputMessageChunkType,  # noqa: F401
         ChatCompletionInputStreamOptions,  # noqa: F401
-        ChatCompletionInputToolType,  # noqa: F401
+        ChatCompletionInputTool,  # noqa: F401
+        ChatCompletionInputToolChoiceClass,  # noqa: F401
+        ChatCompletionInputToolChoiceEnum,  # noqa: F401
         ChatCompletionInputURL,  # noqa: F401
         ChatCompletionOutput,  # noqa: F401
         ChatCompletionOutputComplete,  # noqa: F401
@@ -852,6 +863,7 @@ if TYPE_CHECKING:  # pragma: no cover
         DocumentQuestionAnsweringOutputElement,  # noqa: F401
         DocumentQuestionAnsweringParameters,  # noqa: F401
         FeatureExtractionInput,  # noqa: F401
+        FeatureExtractionInputTruncationDirection,  # noqa: F401
         FillMaskInput,  # noqa: F401
         FillMaskOutputElement,  # noqa: F401
         FillMaskParameters,  # noqa: F401
@@ -862,6 +874,7 @@ if TYPE_CHECKING:  # pragma: no cover
         ImageSegmentationInput,  # noqa: F401
         ImageSegmentationOutputElement,  # noqa: F401
         ImageSegmentationParameters,  # noqa: F401
+        ImageSegmentationSubtask,  # noqa: F401
         ImageToImageInput,  # noqa: F401
         ImageToImageOutput,  # noqa: F401
         ImageToImageParameters,  # noqa: F401
@@ -875,6 +888,7 @@ if TYPE_CHECKING:  # pragma: no cover
         ObjectDetectionInput,  # noqa: F401
         ObjectDetectionOutputElement,  # noqa: F401
         ObjectDetectionParameters,  # noqa: F401
+        Padding,  # noqa: F401
         QuestionAnsweringInput,  # noqa: F401
         QuestionAnsweringInputData,  # noqa: F401
         QuestionAnsweringOutputElement,  # noqa: F401
@@ -884,12 +898,15 @@ if TYPE_CHECKING:  # pragma: no cover
         SummarizationInput,  # noqa: F401
         SummarizationOutput,  # noqa: F401
         SummarizationParameters,  # noqa: F401
+        SummarizationTruncationStrategy,  # noqa: F401
         TableQuestionAnsweringInput,  # noqa: F401
         TableQuestionAnsweringInputData,  # noqa: F401
         TableQuestionAnsweringOutputElement,  # noqa: F401
+        TableQuestionAnsweringParameters,  # noqa: F401
         Text2TextGenerationInput,  # noqa: F401
         Text2TextGenerationOutput,  # noqa: F401
         Text2TextGenerationParameters,  # noqa: F401
+        Text2TextGenerationTruncationStrategy,  # noqa: F401
         TextClassificationInput,  # noqa: F401
         TextClassificationOutputElement,  # noqa: F401
         TextClassificationOutputTransform,  # noqa: F401
@@ -900,6 +917,7 @@ if TYPE_CHECKING:  # pragma: no cover
         TextGenerationOutput,  # noqa: F401
         TextGenerationOutputBestOfSequence,  # noqa: F401
         TextGenerationOutputDetails,  # noqa: F401
+        TextGenerationOutputFinishReason,  # noqa: F401
         TextGenerationOutputPrefillToken,  # noqa: F401
         TextGenerationOutputToken,  # noqa: F401
         TextGenerationStreamOutput,  # noqa: F401
@@ -919,13 +937,15 @@ if TYPE_CHECKING:  # pragma: no cover
         TextToSpeechInput,  # noqa: F401
         TextToSpeechOutput,  # noqa: F401
         TextToSpeechParameters,  # noqa: F401
+        TokenClassificationAggregationStrategy,  # noqa: F401
         TokenClassificationInput,  # noqa: F401
         TokenClassificationOutputElement,  # noqa: F401
         TokenClassificationParameters,  # noqa: F401
-        ToolElement,  # noqa: F401
         TranslationInput,  # noqa: F401
         TranslationOutput,  # noqa: F401
         TranslationParameters,  # noqa: F401
+        TranslationTruncationStrategy,  # noqa: F401
+        TypeEnum,  # noqa: F401
         VideoClassificationInput,  # noqa: F401
         VideoClassificationOutputElement,  # noqa: F401
         VideoClassificationOutputTransform,  # noqa: F401
@@ -935,17 +955,15 @@ if TYPE_CHECKING:  # pragma: no cover
         VisualQuestionAnsweringOutputElement,  # noqa: F401
         VisualQuestionAnsweringParameters,  # noqa: F401
         ZeroShotClassificationInput,  # noqa: F401
-        ZeroShotClassificationInputData,  # noqa: F401
         ZeroShotClassificationOutputElement,  # noqa: F401
         ZeroShotClassificationParameters,  # noqa: F401
         ZeroShotImageClassificationInput,  # noqa: F401
-        ZeroShotImageClassificationInputData,  # noqa: F401
         ZeroShotImageClassificationOutputElement,  # noqa: F401
         ZeroShotImageClassificationParameters,  # noqa: F401
         ZeroShotObjectDetectionBoundingBox,  # noqa: F401
         ZeroShotObjectDetectionInput,  # noqa: F401
-        ZeroShotObjectDetectionInputData,  # noqa: F401
         ZeroShotObjectDetectionOutputElement,  # noqa: F401
+        ZeroShotObjectDetectionParameters,  # noqa: F401
     )
     from .inference_api import InferenceApi  # noqa: F401
     from .keras_mixin import (
@@ -977,12 +995,20 @@ if TYPE_CHECKING:  # pragma: no cover
         get_tf_storage_size,  # noqa: F401
         get_torch_storage_id,  # noqa: F401
         get_torch_storage_size,  # noqa: F401
+        load_state_dict_from_file,  # noqa: F401
+        load_torch_model,  # noqa: F401
         save_torch_model,  # noqa: F401
         save_torch_state_dict,  # noqa: F401
         split_state_dict_into_shards_factory,  # noqa: F401
         split_tf_state_dict_into_shards,  # noqa: F401
         split_torch_state_dict_into_shards,  # noqa: F401
     )
+    from .serialization._dduf import (
+        DDUFEntry,  # noqa: F401
+        export_entries_as_dduf,  # noqa: F401
+        export_folder_as_dduf,  # noqa: F401
+        read_dduf_file,  # noqa: F401
+    )
     from .utils import (
         CachedFileInfo,  # noqa: F401
         CachedRepoInfo,  # noqa: F401

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/src/huggingface_hub/_commit_scheduler.py

@@ -30,8 +30,9 @@ class CommitScheduler:
     """
     Scheduler to upload a local folder to the Hub at regular intervals (e.g. push to hub every 5 minutes).
 
-    The scheduler is started when instantiated and run indefinitely. At the end of your script, a last commit is
-    triggered. Checkout the [upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads)
+    The recommended way to use the scheduler is to use it as a context manager. This ensures that the scheduler is
+    properly stopped and the last commit is triggered when the script ends. The scheduler can also be stopped manually
+    with the `stop` method. Checkout the [upload guide](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads)
     to learn more about how to use it.
 
     Args:
@@ -49,7 +50,7 @@ class CommitScheduler:
         revision (`str`, *optional*):
             The revision of the repo to commit to. Defaults to `main`.
         private (`bool`, *optional*):
-            Whether to make the repo private. Defaults to `False`. This value is ignored if the repo already exist.
+            Whether to make the repo private. If `None` (default), the repo will be public unless the organization's default is private. This value is ignored if the repo already exists.
         token (`str`, *optional*):
             The token to use to commit to the repo. Defaults to the token saved on the machine.
         allow_patterns (`List[str]` or `str`, *optional*):
@@ -78,6 +79,22 @@ class CommitScheduler:
     >>> with csv_path.open("a") as f:
     ...     f.write("second line")
     ```
+
+    Example using a context manager:
+    ```py
+    >>> from pathlib import Path
+    >>> from huggingface_hub import CommitScheduler
+
+    >>> with CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path="watched_folder", every=10) as scheduler:
+    ...     csv_path = Path("watched_folder/data.csv")
+    ...     with csv_path.open("a") as f:
+    ...         f.write("first line")
+    ...     (...)
+    ...     with csv_path.open("a") as f:
+    ...         f.write("second line")
+
+    # Scheduler is now stopped and last commit have been triggered
+    ```
     """
 
     def __init__(
@@ -89,7 +106,7 @@ class CommitScheduler:
         path_in_repo: Optional[str] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
-        private: bool = False,
+        private: Optional[bool] = None,
         token: Optional[str] = None,
         allow_patterns: Optional[Union[List[str], str]] = None,
         ignore_patterns: Optional[Union[List[str], str]] = None,
@@ -144,6 +161,15 @@ class CommitScheduler:
         """
         self.__stopped = True
 
+    def __enter__(self) -> "CommitScheduler":
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback) -> None:
+        # Upload last changes before exiting
+        self.trigger().result()
+        self.stop()
+        return
+
     def _run_scheduler(self) -> None:
         """Dumb thread waiting between each scheduled push to Hub."""
         while True:

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/src/huggingface_hub/_local_folder.py

@@ -53,7 +53,6 @@ import logging
 import os
 import time
 from dataclasses import dataclass
-from functools import lru_cache
 from pathlib import Path
 from typing import Optional
 
@@ -179,7 +178,6 @@ class LocalUploadFileMetadata:
             self.timestamp = new_timestamp
 
 
-@lru_cache(maxsize=128)  # ensure singleton
 def get_local_download_paths(local_dir: Path, filename: str) -> LocalDownloadFilePaths:
     """Compute paths to the files related to a download process.
 
@@ -220,7 +218,6 @@ def get_local_download_paths(local_dir: Path, filename: str) -> LocalDownloadFil
     return LocalDownloadFilePaths(file_path=file_path, lock_path=lock_path, metadata_path=metadata_path)
 
 
-@lru_cache(maxsize=128)  # ensure singleton
 def get_local_upload_paths(local_dir: Path, filename: str) -> LocalUploadFilePaths:
     """Compute paths to the files related to an upload process.
 
@@ -404,7 +401,6 @@ def write_download_metadata(local_dir: Path, filename: str, commit_hash: str, et
             f.write(f"{commit_hash}\n{etag}\n{time.time()}\n")
 
 
-@lru_cache()
 def _huggingface_dir(local_dir: Path) -> Path:
     """Return the path to the `.cache/huggingface` directory in a local directory."""
     # Wrap in lru_cache to avoid overwriting the .gitignore file if called multiple times

{huggingface_hub-0.26.4 → huggingface_hub-0.27.0rc1}/src/huggingface_hub/_login.py

@@ -15,7 +15,6 @@
 
 import os
 import subprocess
-from functools import partial
 from getpass import getpass
 from pathlib import Path
 from typing import Optional
@@ -42,6 +41,7 @@ from .utils._auth import (
     _save_token,
     get_stored_tokens,
 )
+from .utils._deprecation import _deprecate_arguments, _deprecate_positional_args
 
 
 logger = logging.get_logger(__name__)
@@ -55,8 +55,15 @@ _HF_LOGO_ASCII = """
 """
 
 
+@_deprecate_arguments(
+    version="1.0",
+    deprecated_args="write_permission",
+    custom_message="Fine-grained tokens added complexity to the permissions, making it irrelevant to check if a token has 'write' access.",
+)
+@_deprecate_positional_args(version="1.0")
 def login(
     token: Optional[str] = None,
+    *,
     add_to_git_credential: bool = False,
     new_session: bool = True,
     write_permission: bool = False,
@@ -97,8 +104,8 @@ def login(
             to the end user.
         new_session (`bool`, defaults to `True`):
             If `True`, will request a token even if one is already saved on the machine.
-        write_permission (`bool`, defaults to `False`):
-            If `True`, requires a token with write permission.
+        write_permission (`bool`):
+            Ignored and deprecated argument.
     Raises:
         [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
             If an organization token is passed. Only personal account tokens are valid
@@ -116,11 +123,11 @@ def login(
                 "`--add-to-git-credential` if using via `huggingface-cli` if "
                 "you want to set the git credential as well."
             )
-        _login(token, add_to_git_credential=add_to_git_credential, write_permission=write_permission)
+        _login(token, add_to_git_credential=add_to_git_credential)
     elif is_notebook():
-        notebook_login(new_session=new_session, write_permission=write_permission)
+        notebook_login(new_session=new_session)
     else:
-        interpreter_login(new_session=new_session, write_permission=write_permission)
+        interpreter_login(new_session=new_session)
 
 
 def logout(token_name: Optional[str] = None) -> None:
@@ -235,7 +242,13 @@ def auth_list() -> None:
 ###
 
 
-def interpreter_login(new_session: bool = True, write_permission: bool = False) -> None:
+@_deprecate_arguments(
+    version="1.0",
+    deprecated_args="write_permission",
+    custom_message="Fine-grained tokens added complexity to the permissions, making it irrelevant to check if a token has 'write' access.",
+)
+@_deprecate_positional_args(version="1.0")
+def interpreter_login(*, new_session: bool = True, write_permission: bool = False) -> None:
     """
     Displays a prompt to log in to the HF website and store the token.
 
@@ -248,11 +261,10 @@ def interpreter_login(new_session: bool = True, write_permission: bool = False)
     Args:
         new_session (`bool`, defaults to `True`):
             If `True`, will request a token even if one is already saved on the machine.
-        write_permission (`bool`, defaults to `False`):
-            If `True`, requires a token with write permission.
-
+        write_permission (`bool`):
+            Ignored and deprecated argument.
     """
-    if not new_session and _current_token_okay(write_permission=write_permission):
+    if not new_session and get_token() is not None:
         logger.info("User is already logged in.")
         return
 
@@ -275,11 +287,7 @@ def interpreter_login(new_session: bool = True, write_permission: bool = False)
     token = getpass("Enter your token (input will not be visible): ")
     add_to_git_credential = _ask_for_confirmation_no_tui("Add token as git credential?")
 
-    _login(
-        token=token,
-        add_to_git_credential=add_to_git_credential,
-        write_permission=write_permission,
-    )
+    _login(token=token, add_to_git_credential=add_to_git_credential)
 
 
 ###
@@ -306,7 +314,13 @@ NOTEBOOK_LOGIN_TOKEN_HTML_END = """
 notebooks. </center>"""
 
 
-def notebook_login(new_session: bool = True, write_permission: bool = False) -> None:
+@_deprecate_arguments(
+    version="1.0",
+    deprecated_args="write_permission",
+    custom_message="Fine-grained tokens added complexity to the permissions, making it irrelevant to check if a token has 'write' access.",
+)
+@_deprecate_positional_args(version="1.0")
+def notebook_login(*, new_session: bool = True, write_permission: bool = False) -> None:
     """
     Displays a widget to log in to the HF website and store the token.
 
@@ -319,8 +333,8 @@ def notebook_login(new_session: bool = True, write_permission: bool = False) ->
     Args:
         new_session (`bool`, defaults to `True`):
             If `True`, will request a token even if one is already saved on the machine.
-        write_permission (`bool`, defaults to `False`):
-            If `True`, requires a token with write permission.
+        write_permission (`bool`):
+            Ignored and deprecated argument.
     """
     try:
         import ipywidgets.widgets as widgets  # type: ignore
@@ -330,7 +344,7 @@ def notebook_login(new_session: bool = True, write_permission: bool = False) ->
             "The `notebook_login` function can only be used in a notebook (Jupyter or"
             " Colab) and you need the `ipywidgets` module: `pip install ipywidgets`."
         )
-    if not new_session and _current_token_okay(write_permission=write_permission):
+    if not new_session and get_token() is not None:
         logger.info("User is already logged in.")
         return
 
@@ -353,14 +367,8 @@ def notebook_login(new_session: bool = True, write_permission: bool = False) ->
     display(login_token_widget)
 
     # On click events
-    def login_token_event(t, write_permission: bool = False):
-        """
-        Event handler for the login button.
-
-        Args:
-            write_permission (`bool`, defaults to `False`):
-                If `True`, requires a token with write permission.
-        """
+    def login_token_event(t):
+        """Event handler for the login button."""
         token = token_widget.value
         add_to_git_credential = git_checkbox_widget.value
         # Erase token and clear value to make sure it's not saved in the notebook.
@@ -369,14 +377,14 @@ def notebook_login(new_session: bool = True, write_permission: bool = False) ->
         login_token_widget.children = [widgets.Label("Connecting...")]
         try:
             with capture_output() as captured:
-                _login(token, add_to_git_credential=add_to_git_credential, write_permission=write_permission)
+                _login(token, add_to_git_credential=add_to_git_credential)
             message = captured.getvalue()
         except Exception as error:
             message = str(error)
         # Print result (success message or error)
         login_token_widget.children = [widgets.Label(line) for line in message.split("\n") if line.strip()]
 
-    token_finish_button.on_click(partial(login_token_event, write_permission=write_permission))
+    token_finish_button.on_click(login_token_event)
 
 
 ###
@@ -387,7 +395,6 @@ def notebook_login(new_session: bool = True, write_permission: bool = False) ->
 def _login(
     token: str,
     add_to_git_credential: bool,
-    write_permission: bool = False,
 ) -> None:
     from .hf_api import whoami  # avoid circular import
 
@@ -396,11 +403,6 @@ def _login(
 
     token_info = whoami(token)
     permission = token_info["auth"]["accessToken"]["role"]
-    if write_permission and permission != "write":
-        raise ValueError(
-            "Token is valid but is 'read-only' and a 'write' token is required.\nPlease provide a new token with"
-            " correct permission."
-        )
     logger.info(f"Token is valid (permission: {permission}).")
 
     token_name = token_info["auth"]["accessToken"]["displayName"]
@@ -469,24 +471,6 @@ def _set_active_token(
     logger.info(f"Your token has been saved to {constants.HF_TOKEN_PATH}")
 
 
-def _current_token_okay(write_permission: bool = False):
-    """Check if the current token is valid.
-
-    Args:
-        write_permission (`bool`, defaults to `False`):
-            If `True`, requires a token with write permission.
-
-    Returns:
-        `bool`: `True` if the current token is valid, `False` otherwise.
-    """
-    from .hf_api import get_token_permission  # avoid circular import
-
-    permission = get_token_permission()
-    if permission is None or (write_permission and permission != "write"):
-        return False
-    return True
-
-
 def _is_git_credential_helper_configured() -> bool:
     """Check if a git credential helper is configured.