huggingface-hub 0.13.3__py3-none-any.whl → 0.14.0.dev0__py3-none-any.whl

huggingface_hub/hf_api.py

@@ -27,7 +27,13 @@ from urllib.parse import quote
 import requests
 from requests.exceptions import HTTPError
 
-from huggingface_hub.utils import EntryNotFoundError, RepositoryNotFoundError
+from huggingface_hub.utils import (
+    IGNORE_GIT_FOLDER_PATTERNS,
+    EntryNotFoundError,
+    RepositoryNotFoundError,
+    experimental,
+    get_session,
+)
 
 from ._commit_api import (
     CommitOperation,
@@ -38,6 +44,19 @@ from ._commit_api import (
     upload_lfs_files,
     warn_on_overwriting_operations,
 )
+from ._multi_commits import (
+    MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_BAD_REQUEST_TEMPLATE,
+    MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_NO_CHANGES_TEMPLATE,
+    MULTI_COMMIT_PR_CLOSING_COMMENT_TEMPLATE,
+    MULTI_COMMIT_PR_COMPLETION_COMMENT_TEMPLATE,
+    MultiCommitException,
+    MultiCommitStep,
+    MultiCommitStrategy,
+    multi_commit_create_pull_request,
+    multi_commit_generate_comment,
+    multi_commit_parse_pr_description,
+    plan_multi_commits,
+)
 from ._space_api import SpaceHardware, SpaceRuntime
 from .community import (
     Discussion,
@@ -58,24 +77,21 @@ from .constants import (
     SPACES_SDK_TYPES,
 )
 from .utils import (  # noqa: F401 # imported for backward compatibility
+    BadRequestError,
     HfFolder,
     HfHubHTTPError,
     build_hf_headers,
-    erase_from_credential_store,
     filter_repo_objects,
     hf_raise_for_status,
     logging,
+    paginate,
     parse_datetime,
-    read_from_credential_store,
     validate_hf_hub_args,
-    write_to_credential_store,
 )
 from .utils._deprecation import (
     _deprecate_arguments,
     _deprecate_list_output,
-    _deprecate_method,
 )
-from .utils._pagination import paginate
 from .utils._typing import Literal, TypedDict
 from .utils.endpoint_helpers import (
     AttributeDictionary,
@@ -90,6 +106,7 @@ from .utils.endpoint_helpers import (
 USERNAME_PLACEHOLDER = "hf_user"
 _REGEX_DISCUSSION_URL = re.compile(r".*/discussions/(\d+)$")
 
+
 logger = logging.get_logger(__name__)
 
 
@@ -192,6 +209,7 @@ def repo_type_and_id_from_hf_id(hf_id: str, hub_url: Optional[str] = None) -> Tu
 class BlobLfsInfo(TypedDict, total=False):
     size: int
     sha256: str
+    pointer_size: int
 
 
 @dataclass
@@ -312,23 +330,21 @@ class RepoUrl(str):
 
 class RepoFile(ReprMixin):
     """
-    Data structure that represents a public file inside a repo, accessible from
-    huggingface.co
+    Data structure that represents a public file inside a repo, accessible from huggingface.co
 
     Args:
         rfilename (str):
-            file name, relative to the repo root. This is the only attribute
-            that's guaranteed to be here, but under certain conditions there can
-            certain other stuff.
+            file name, relative to the repo root. This is the only attribute that's guaranteed to be here, but under
+            certain conditions there can certain other stuff.
         size (`int`, *optional*):
-            The file's size, in bytes. This attribute is present when `files_metadata` argument
-            of [`repo_info`] is set to `True`. It's `None` otherwise.
+            The file's size, in bytes. This attribute is present when `files_metadata` argument of [`repo_info`] is set
+            to `True`. It's `None` otherwise.
         blob_id (`str`, *optional*):
-            The file's git OID. This attribute is present when `files_metadata` argument
-            of [`repo_info`] is set to `True`. It's `None` otherwise.
+            The file's git OID. This attribute is present when `files_metadata` argument of [`repo_info`] is set to
+            `True`. It's `None` otherwise.
         lfs (`BlobLfsInfo`, *optional*):
-            The file's LFS metadata. This attribute is present when`files_metadata` argument
-            of [`repo_info`] is set to `True` and the file is stored with Git LFS. It's `None` otherwise.
+            The file's LFS metadata. This attribute is present when`files_metadata` argument of [`repo_info`] is set to
+            `True` and the file is stored with Git LFS. It's `None` otherwise.
     """
 
     def __init__(
@@ -822,7 +838,7 @@ class HfApi:
                 Hugging Face token. Will default to the locally saved token if
                 not provided.
         """
-        r = requests.get(
+        r = get_session().get(
             f"{self.endpoint}/api/whoami-v2",
             headers=self._build_hf_headers(
                 # If `token` is provided and not `None`, it will be used by default.
@@ -857,43 +873,10 @@ class HfApi:
         except HTTPError:
             return False
 
-    @staticmethod
-    @_deprecate_method(
-        version="0.14",
-        message=(
-            "`HfApi.set_access_token` is deprecated as it is very ambiguous. Use"
-            " `login` or `set_git_credential` instead."
-        ),
-    )
-    def set_access_token(access_token: str):
-        """
-        Saves the passed access token so git can correctly authenticate the
-        user.
-
-        Args:
-            access_token (`str`):
-                The access token to save.
-        """
-        write_to_credential_store(USERNAME_PLACEHOLDER, access_token)
-
-    @staticmethod
-    @_deprecate_method(
-        version="0.14",
-        message=(
-            "`HfApi.unset_access_token` is deprecated as it is very ambiguous. Use"
-            " `login` or `unset_git_credential` instead."
-        ),
-    )
-    def unset_access_token():
-        """
-        Resets the user's access token.
-        """
-        erase_from_credential_store(USERNAME_PLACEHOLDER)
-
     def get_model_tags(self) -> ModelTags:
         "Gets all valid model tags as a nested namespace object"
         path = f"{self.endpoint}/api/models-tags-by-type"
-        r = requests.get(path)
+        r = get_session().get(path)
         hf_raise_for_status(r)
         d = r.json()
         return ModelTags(d)
@@ -903,7 +886,7 @@ class HfApi:
         Gets all valid dataset tags as a nested namespace object.
         """
         path = f"{self.endpoint}/api/datasets-tags-by-type"
-        r = requests.get(path)
+        r = get_session().get(path)
         hf_raise_for_status(r)
         d = r.json()
         return DatasetTags(d)
@@ -936,8 +919,7 @@ class HfApi:
                 A string which identify the author (user or organization) of the
                 returned models
             search (`str`, *optional*):
-                A string that will be contained in the returned models Example
-                usage:
+                A string that will be contained in the returned model ids.
             emissions_thresholds (`Tuple`, *optional*):
                 A tuple of two ints or floats representing a minimum and maximum
                 carbon footprint to filter the resulting models with in grams.
@@ -1293,7 +1275,7 @@ class HfApi:
             `List[MetricInfo]`: a list of [`MetricInfo`] objects which.
         """
         path = f"{self.endpoint}/api/metrics"
-        r = requests.get(path)
+        r = get_session().get(path)
         hf_raise_for_status(r)
         d = r.json()
         return [MetricInfo(**x) for x in d]
@@ -1427,7 +1409,7 @@ class HfApi:
         """
         if repo_type is None:
             repo_type = REPO_TYPE_MODEL
-        response = requests.post(
+        response = get_session().post(
             url=f"{self.endpoint}/api/{repo_type}s/{repo_id}/like",
             headers=self._build_hf_headers(token=token),
         )
@@ -1475,10 +1457,8 @@ class HfApi:
         """
         if repo_type is None:
             repo_type = REPO_TYPE_MODEL
-        # TODO: use requests.delete(".../like") instead when https://github.com/huggingface/moon-landing/pull/4813 is merged
-        response = requests.delete(
-            url=f"{self.endpoint}/api/{repo_type}s/{repo_id}/like",
-            headers=self._build_hf_headers(token=token),
+        response = get_session().delete(
+            url=f"{self.endpoint}/api/{repo_type}s/{repo_id}/like", headers=self._build_hf_headers(token=token)
         )
         hf_raise_for_status(response)
 
@@ -1620,7 +1600,7 @@ class HfApi:
             params["securityStatus"] = True
         if files_metadata:
             params["blobs"] = True
-        r = requests.get(path, headers=headers, timeout=timeout, params=params)
+        r = get_session().get(path, headers=headers, timeout=timeout, params=params)
         hf_raise_for_status(r)
         d = r.json()
         return ModelInfo(**d)
@@ -1683,7 +1663,7 @@ class HfApi:
         if files_metadata:
             params["blobs"] = True
 
-        r = requests.get(path, headers=headers, timeout=timeout, params=params)
+        r = get_session().get(path, headers=headers, timeout=timeout, params=params)
         hf_raise_for_status(r)
         d = r.json()
         return DatasetInfo(**d)
@@ -1746,7 +1726,7 @@ class HfApi:
         if files_metadata:
             params["blobs"] = True
 
-        r = requests.get(path, headers=headers, timeout=timeout, params=params)
+        r = get_session().get(path, headers=headers, timeout=timeout, params=params)
         hf_raise_for_status(r)
         d = r.json()
         return SpaceInfo(**d)
@@ -1819,6 +1799,141 @@ class HfApi:
             files_metadata=files_metadata,
         )
 
+    @validate_hf_hub_args
+    def list_files_info(
+        self,
+        repo_id: str,
+        paths: Union[List[str], str, None] = None,
+        *,
+        revision: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        token: Optional[Union[bool, str]] = None,
+    ) -> Iterable[RepoFile]:
+        """
+        List files on a repo and get information about them.
+
+        Takes as input a list of paths. Those paths can be either files or folders. Two server endpoints are called:
+        1. POST "/paths-info" to get information about the provided paths. Called once.
+        2. GET  "/tree?recursive=True" to paginate over the input folders. Called only if a folder path is provided as
+           input. Will be called multiple times to follow pagination.
+        If no path is provided as input, step 1. is ignored and all files from the repo are listed.
+
+        Args:
+            repo_id (`str`):
+                A namespace (user or an organization) and a repo name separated by a `/`.
+            paths (`Union[List[str], str, None]`, *optional*):
+                The paths to get information about. Paths to files are directly resolved. Paths to folders are resolved
+                recursively which means that information is returned about all files in the folder and its subfolders.
+                If `None`, all files are returned (the default). If a path do not exist, it is ignored without raising
+                an exception.
+            revision (`str`, *optional*):
+                The revision of the repository from which to get the information. Defaults to `"main"` branch.
+            repo_type (`str`, *optional*):
+                The type of the repository from which to get the information (`"model"`, `"dataset"` or `"space"`.
+                Defaults to `"model"`.
+            token (`bool` or `str`, *optional*):
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
+
+        Returns:
+            `Iterable[RepoFile]`:
+                The information about the files, as an iterable of [`RepoFile`] objects. The order of the files is
+                not guaranteed.
+
+        Raises:
+            [`~utils.RepositoryNotFoundError`]:
+                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
+                does not exist.
+            [`~utils.RevisionNotFoundError`]:
+                If revision is not found (error 404) on the repo.
+
+        Examples:
+
+            Get information about files on a repo.
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> files_info = list_files_info("lysandre/arxiv-nlp", ["README.md", "config.json"])
+            >>> files_info
+            <generator object HfApi.list_files_info at 0x7f93b848e730>
+            >>> list(files_info)
+            [
+                RepoFile: {"blob_id": "43bd404b159de6fba7c2f4d3264347668d43af25", "lfs": None, "rfilename": "README.md", "size": 391},
+                RepoFile: {"blob_id": "2f9618c3a19b9a61add74f70bfb121335aeef666", "lfs": None, "rfilename": "config.json", "size": 554},
+            ]
+            ```
+
+            List LFS files from the "vae/" folder in "stabilityai/stable-diffusion-2" repository.
+
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> [info.rfilename for info in list_files_info("stabilityai/stable-diffusion-2", "vae") if info.lfs is not None]
+            ['vae/diffusion_pytorch_model.bin', 'vae/diffusion_pytorch_model.safetensors']
+            ```
+
+            List all files on a repo.
+            ```py
+            >>> from huggingface_hub import list_files_info
+            >>> [info.rfilename for info in list_files_info("glue", repo_type="dataset")]
+            ['.gitattributes', 'README.md', 'dataset_infos.json', 'glue.py']
+            ```
+        """
+        repo_type = repo_type or REPO_TYPE_MODEL
+        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
+        headers = self._build_hf_headers(token=token)
+
+        def _format_as_repo_file(info: Dict) -> RepoFile:
+            # Quick alias very specific to the server return type of /paths-info and /tree endpoints. Let's keep this
+            # logic here.
+            rfilename = info.pop("path")
+            size = info.pop("size")
+            blobId = info.pop("oid")
+            lfs = info.pop("lfs", None)
+            info.pop("type", None)  # "file" or "folder" -> not needed in practice since we know it's a file
+            # "lastCommit": behavior might change server-side in the near future (it might become optional)
+            # In the meantime, let's remove it so that users don't expect it
+            # TODO: set it back when https://github.com/huggingface/moon-landing/issues/5993 is settled
+            info.pop("lastCommit", None)
+            if lfs is not None:
+                lfs = BlobLfsInfo(size=lfs["size"], sha256=lfs["oid"], pointer_size=lfs["pointerSize"])
+            return RepoFile(rfilename=rfilename, size=size, blobId=blobId, lfs=lfs, **info)
+
+        folder_paths = []
+        if paths is None:
+            # `paths` is not provided => list all files from the repo
+            folder_paths.append("")
+        elif paths == []:
+            # corner case: server would return a 400 error if `paths` is an empty list. Let's return early.
+            return
+        else:
+            # `paths` is provided => get info about those
+            response = get_session().post(
+                f"{self.endpoint}/api/{repo_type}s/{repo_id}/paths-info/{revision}",
+                data={
+                    "paths": paths if isinstance(paths, list) else [paths],
+                    # "expand": True, # TODO: related to "lastCommit" (see above). Do not return it for now.
+                },
+                headers=headers,
+            )
+            hf_raise_for_status(response)
+            paths_info = response.json()
+
+            # List top-level files first
+            for path_info in paths_info:
+                if path_info["type"] == "file":
+                    yield _format_as_repo_file(path_info)
+                else:
+                    folder_paths.append(path_info["path"])
+
+        # List files in subdirectories
+        for path in folder_paths:
+            encoded_path = "/" + quote(path, safe="") if path else ""
+            tree_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/tree/{revision}{encoded_path}"
+            for subpath_info in paginate(path=tree_url, headers=headers, params={"recursive": True}):
+                if subpath_info["type"] == "file":
+                    yield _format_as_repo_file(subpath_info)
+
+    @_deprecate_arguments(version="0.17", deprecated_args=["timeout"], custom_message="timeout is not used anymore.")
     @validate_hf_hub_args
     def list_repo_files(
         self,
@@ -1834,35 +1949,26 @@ class HfApi:
 
         Args:
             repo_id (`str`):
-                A namespace (user or an organization) and a repo name separated
-                by a `/`.
+                A namespace (user or an organization) and a repo name separated by a `/`.
             revision (`str`, *optional*):
-                The revision of the model repository from which to get the
-                information.
+                The revision of the model repository from which to get the information.
             repo_type (`str`, *optional*):
-                Set to `"dataset"` or `"space"` if uploading to a dataset or
-                space, `None` or `"model"` if uploading to a model. Default is
-                `None`.
-            timeout (`float`, *optional*):
-                Whether to set a timeout for the request to the Hub.
+                Set to `"dataset"` or `"space"` if uploading to a dataset or space, `None` or `"model"` if uploading to
+                a model. Default is `None`.
             token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
+                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
+                retrieved from the cache. If `False`, token is not sent in the request header.
 
         Returns:
             `List[str]`: the list of files in a given repository.
         """
-        # TODO: use https://huggingface.co/api/{repo_type}/{repo_id}/tree/{revision}/{subfolder}
-        repo_info = self.repo_info(
-            repo_id,
-            revision=revision,
-            repo_type=repo_type,
-            token=token,
-            timeout=timeout,
-        )
-        return [f.rfilename for f in repo_info.siblings]
+        return [
+            f.rfilename
+            for f in self.list_files_info(
+                repo_id=repo_id, paths=None, revision=revision, repo_type=repo_type, token=token
+            )
+        ]
 
     @validate_hf_hub_args
     def list_repo_refs(
@@ -1913,9 +2019,8 @@ class HfApi:
             repo on the Hub.
         """
         repo_type = repo_type or REPO_TYPE_MODEL
-        response = requests.get(
-            f"{self.endpoint}/api/{repo_type}s/{repo_id}/refs",
-            headers=self._build_hf_headers(token=token),
+        response = get_session().get(
+            f"{self.endpoint}/api/{repo_type}s/{repo_id}/refs", headers=self._build_hf_headers(token=token)
         )
         hf_raise_for_status(response)
         data = response.json()
@@ -2074,7 +2179,7 @@ class HfApi:
             # See https://github.com/huggingface/huggingface_hub/pull/733/files#r820604472
             json["lfsmultipartthresh"] = self._lfsmultipartthresh  # type: ignore
         headers = self._build_hf_headers(token=token, is_write_action=True)
-        r = requests.post(path, headers=headers, json=json)
+        r = get_session().post(path, headers=headers, json=json)
 
         try:
             hf_raise_for_status(r)
@@ -2140,7 +2245,7 @@ class HfApi:
             json["type"] = repo_type
 
         headers = self._build_hf_headers(token=token, is_write_action=True)
-        r = requests.delete(path, headers=headers, json=json)
+        r = get_session().delete(path, headers=headers, json=json)
         hf_raise_for_status(r)
 
     @validate_hf_hub_args
@@ -2195,7 +2300,7 @@ class HfApi:
         if repo_type is None:
             repo_type = REPO_TYPE_MODEL  # default repo type
 
-        r = requests.put(
+        r = get_session().put(
             url=f"{self.endpoint}/api/{repo_type}s/{namespace}/{name}/settings",
             headers=self._build_hf_headers(token=token, is_write_action=True),
             json={"private": private},
@@ -2255,7 +2360,7 @@ class HfApi:
 
         path = f"{self.endpoint}/api/repos/move"
         headers = self._build_hf_headers(token=token, is_write_action=True)
-        r = requests.post(path, headers=headers, json=json)
+        r = get_session().post(path, headers=headers, json=json)
         try:
             hf_raise_for_status(r)
         except HfHubHTTPError as e:
@@ -2439,7 +2544,7 @@ class HfApi:
         params = {"create_pr": "1"} if create_pr else None
 
         try:
-            commit_resp = requests.post(url=commit_url, headers=headers, data=data, params=params)
+            commit_resp = get_session().post(url=commit_url, headers=headers, data=data, params=params)
             hf_raise_for_status(commit_resp, endpoint_name="commit")
         except RepositoryNotFoundError as e:
             e.append_to_message(_CREATE_COMMIT_NO_REPO_ERROR_MESSAGE)
@@ -2461,6 +2566,306 @@ class HfApi:
             pr_url=commit_data["pullRequestUrl"] if create_pr else None,
         )
 
+    @experimental
+    @validate_hf_hub_args
+    def create_commits_on_pr(
+        self,
+        *,
+        repo_id: str,
+        addition_commits: List[List[CommitOperationAdd]],
+        deletion_commits: List[List[CommitOperationDelete]],
+        commit_message: str,
+        commit_description: Optional[str] = None,
+        token: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        merge_pr: bool = True,
+        num_threads: int = 5,  # TODO: use to multithread uploads
+        verbose: bool = False,
+    ) -> str:
+        """Push changes to the Hub in multiple commits.
+
+        Commits are pushed to a draft PR branch. If the upload fails or gets interrupted, it can be resumed. Progress
+        is tracked in the PR description. At the end of the process, the PR is set as open and the title is updated to
+        match the initial commit message. If `merge_pr=True` is passed, the PR is merged automatically.
+
+        All deletion commits are pushed first, followed by the addition commits. The order of the commits is not
+        guaranteed as we might implement parallel commits in the future. Be sure that your are not updating several
+        times the same file.
+
+        <Tip warning={true}>
+
+        `create_commits_on_pr` is experimental.  Its API and behavior is subject to change in the future without prior notice.
+
+        </Tip>
+
+        Args:
+            repo_id (`str`):
+                The repository in which the commits will be pushed. Example: `"username/my-cool-model"`.
+
+            addition_commits (`List` of `List` of [`~hf_api.CommitOperationAdd`]):
+                A list containing lists of [`~hf_api.CommitOperationAdd`]. Each sublist will result in a commit on the
+                PR.
+
+            deletion_commits
+                A list containing lists of [`~hf_api.CommitOperationDelete`]. Each sublist will result in a commit on
+                the PR. Deletion commits are pushed before addition commits.
+
+            commit_message (`str`):
+                The summary (first line) of the commit that will be created. Will also be the title of the PR.
+
+            commit_description (`str`, *optional*):
+                The description of the commit that will be created. The description will be added to the PR.
+
+            token (`str`, *optional*):
+                Authentication token, obtained with `HfApi.login` method. Will default to the stored token.
+
+            repo_type (`str`, *optional*):
+                Set to `"dataset"` or `"space"` if uploading to a dataset or space, `None` or `"model"` if uploading to
+                a model. Default is `None`.
+
+            merge_pr (`bool`):
+                If set to `True`, the Pull Request is merged at the end of the process. Defaults to `True`.
+
+            num_threads (`int`, *optional*):
+                Number of concurrent threads for uploading files. Defaults to 5.
+
+            verbose (`bool`):
+                If set to `True`, process will run on verbose mode i.e. print information about the ongoing tasks.
+                Defaults to `False`.
+
+        Returns:
+            `str`: URL to the created PR.
+
+        Example:
+        ```python
+        >>> from huggingface_hub import HfApi, plan_multi_commits
+        >>> addition_commits, deletion_commits = plan_multi_commits(
+        ...     operations=[
+        ...          CommitOperationAdd(...),
+        ...          CommitOperationAdd(...),
+        ...          CommitOperationDelete(...),
+        ...          CommitOperationDelete(...),
+        ...          CommitOperationAdd(...),
+        ...     ],
+        ... )
+        >>> HfApi().create_commits_on_pr(
+        ...     repo_id="my-cool-model",
+        ...     addition_commits=addition_commits,
+        ...     deletion_commits=deletion_commits,
+        ...     (...)
+        ...     verbose=True,
+        ... )
+        ```
+
+        Raises:
+            [`MultiCommitException`]:
+                If an unexpected issue occur in the process: empty commits, unexpected commits in a PR, unexpected PR
+                description, etc.
+
+        <Tip warning={true}>
+
+        `create_commits_on_pr` assumes that the repo already exists on the Hub. If you get a Client error 404, please
+        make sure you are authenticated and that `repo_id` and `repo_type` are set correctly. If repo does not exist,
+        create it first using [`~hf_api.create_repo`].
+
+        </Tip>
+        """
+        logger = logging.get_logger(__name__ + ".create_commits_on_pr")
+        if verbose:
+            logger.setLevel("INFO")
+
+        # 1. Get strategy ID
+        logger.info(
+            f"Will create {len(deletion_commits)} deletion commit(s) and {len(addition_commits)} addition commit(s),"
+            f" totalling {sum(len(ops) for ops in addition_commits+deletion_commits)} atomic operations."
+        )
+        strategy = MultiCommitStrategy(
+            addition_commits=[MultiCommitStep(operations=operations) for operations in addition_commits],  # type: ignore
+            deletion_commits=[MultiCommitStep(operations=operations) for operations in deletion_commits],  # type: ignore
+        )
+        logger.info(f"Multi-commits strategy with ID {strategy.id}.")
+
+        # 2. Get or create a PR with this strategy ID
+        for discussion in self.get_repo_discussions(repo_id=repo_id, repo_type=repo_type, token=token):
+            # search for a draft PR with strategy ID
+            if discussion.is_pull_request and discussion.status == "draft" and strategy.id in discussion.title:
+                pr = self.get_discussion_details(
+                    repo_id=repo_id, discussion_num=discussion.num, repo_type=repo_type, token=token
+                )
+                logger.info(f"PR already exists: {pr.url}. Will resume process where it stopped.")
+                break
+        else:
+            # did not find a PR matching the strategy ID
+            pr = multi_commit_create_pull_request(
+                self,
+                repo_id=repo_id,
+                commit_message=commit_message,
+                commit_description=commit_description,
+                strategy=strategy,
+                token=token,
+                repo_type=repo_type,
+            )
+            logger.info(f"New PR created: {pr.url}")
+
+        # 3. Parse PR description to check consistency with strategy (e.g. same commits are scheduled)
+        for event in pr.events:
+            if isinstance(event, DiscussionComment):
+                pr_comment = event
+                break
+        else:
+            raise MultiCommitException(f"PR #{pr.num} must have at least 1 comment")
+
+        description_commits = multi_commit_parse_pr_description(pr_comment.content)
+        if len(description_commits) != len(strategy.all_steps):
+            raise MultiCommitException(
+                f"Corrupted multi-commit PR #{pr.num}: got {len(description_commits)} steps in"
+                f" description but {len(strategy.all_steps)} in strategy."
+            )
+        for step_id in strategy.all_steps:
+            if step_id not in description_commits:
+                raise MultiCommitException(
+                    f"Corrupted multi-commit PR #{pr.num}: expected step {step_id} but didn't find"
+                    f" it (have {', '.join(description_commits)})."
+                )
+
+        # 4. Retrieve commit history (and check consistency)
+        commits_on_main_branch = {
+            commit.commit_id
+            for commit in self.list_repo_commits(
+                repo_id=repo_id, repo_type=repo_type, token=token, revision=DEFAULT_REVISION
+            )
+        }
+        pr_commits = [
+            commit
+            for commit in self.list_repo_commits(
+                repo_id=repo_id, repo_type=repo_type, token=token, revision=pr.git_reference
+            )
+            if commit.commit_id not in commits_on_main_branch
+        ]
+        if len(pr_commits) > 0:
+            logger.info(f"Found {len(pr_commits)} existing commits on the PR.")
+
+        # At this point `pr_commits` is a list of commits pushed to the PR. We expect all of these commits (if any) to have
+        # a step_id as title. We raise exception if an unexpected commit has been pushed.
+        if len(pr_commits) > len(strategy.all_steps):
+            raise MultiCommitException(
+                f"Corrupted multi-commit PR #{pr.num}: scheduled {len(strategy.all_steps)} steps but"
+                f" {len(pr_commits)} commits have already been pushed to the PR."
+            )
+
+        # Check which steps are already completed
+        remaining_additions = {step.id: step for step in strategy.addition_commits}
+        remaining_deletions = {step.id: step for step in strategy.deletion_commits}
+        for commit in pr_commits:
+            if commit.title in remaining_additions:
+                step = remaining_additions.pop(commit.title)
+                step.completed = True
+            elif commit.title in remaining_deletions:
+                step = remaining_deletions.pop(commit.title)
+                step.completed = True
+
+        if len(remaining_deletions) > 0 and len(remaining_additions) < len(strategy.addition_commits):
+            raise MultiCommitException(
+                f"Corrupted multi-commit PR #{pr.num}: some addition commits have already been pushed to the PR but"
+                " deletion commits are not all completed yet."
+            )
+        nb_remaining = len(remaining_deletions) + len(remaining_additions)
+        if len(pr_commits) > 0:
+            logger.info(
+                f"{nb_remaining} commits remaining ({len(remaining_deletions)} deletion commits and"
+                f" {len(remaining_additions)} addition commits)"
+            )
+
+        # 5. Push remaining commits to the PR + update description
+        # TODO: multi-thread this
+        for step in list(remaining_deletions.values()) + list(remaining_additions.values()):
+            # Push new commit
+            self.create_commit(
+                repo_id=repo_id,
+                repo_type=repo_type,
+                token=token,
+                commit_message=step.id,
+                revision=pr.git_reference,
+                num_threads=num_threads,
+                operations=step.operations,
+                create_pr=False,
+            )
+            step.completed = True
+            nb_remaining -= 1
+            logger.info(f"  step {step.id} completed (still {nb_remaining} to go).")
+
+            # Update PR description
+            self.edit_discussion_comment(
+                repo_id=repo_id,
+                repo_type=repo_type,
+                token=token,
+                discussion_num=pr.num,
+                comment_id=pr_comment.id,
+                new_content=multi_commit_generate_comment(
+                    commit_message=commit_message, commit_description=commit_description, strategy=strategy
+                ),
+            )
+        logger.info("All commits have been pushed.")
+
+        # 6. Update PR (and merge)
+        self.rename_discussion(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            token=token,
+            discussion_num=pr.num,
+            new_title=commit_message,
+        )
+        self.change_discussion_status(
+            repo_id=repo_id,
+            repo_type=repo_type,
+            token=token,
+            discussion_num=pr.num,
+            new_status="open",
+            comment=MULTI_COMMIT_PR_COMPLETION_COMMENT_TEMPLATE,
+        )
+        logger.info("PR is now open for reviews.")
+
+        if merge_pr:  # User don't want a PR => merge it
+            try:
+                self.merge_pull_request(
+                    repo_id=repo_id,
+                    repo_type=repo_type,
+                    token=token,
+                    discussion_num=pr.num,
+                    comment=MULTI_COMMIT_PR_CLOSING_COMMENT_TEMPLATE,
+                )
+                logger.info("PR has been automatically merged (`merge_pr=True` was passed).")
+            except BadRequestError as error:
+                if error.server_message is not None and "no associated changes" in error.server_message:
+                    # PR cannot be merged as no changes are associated. We close the PR without merging with a comment to
+                    # explain.
+                    self.change_discussion_status(
+                        repo_id=repo_id,
+                        repo_type=repo_type,
+                        token=token,
+                        discussion_num=pr.num,
+                        comment=MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_NO_CHANGES_TEMPLATE,
+                        new_status="closed",
+                    )
+                    logger.warning("Couldn't merge the PR: no associated changes.")
+                else:
+                    # PR cannot be merged for another reason (conflicting files for example). We comment the PR to explain
+                    # and re-raise the exception.
+                    self.comment_discussion(
+                        repo_id=repo_id,
+                        repo_type=repo_type,
+                        token=token,
+                        discussion_num=pr.num,
+                        comment=MULTI_COMMIT_PR_CLOSE_COMMENT_FAILURE_BAD_REQUEST_TEMPLATE.format(
+                            error_message=error.server_message
+                        ),
+                    )
+                    raise MultiCommitException(
+                        f"Couldn't merge Pull Request in multi-commit: {error.server_message}"
+                    ) from error
+
+        return pr.url
+
     @validate_hf_hub_args
     def upload_file(
         self,
@@ -2627,9 +3032,11 @@ class HfApi:
         allow_patterns: Optional[Union[List[str], str]] = None,
         ignore_patterns: Optional[Union[List[str], str]] = None,
         delete_patterns: Optional[Union[List[str], str]] = None,
+        multi_commits: bool = False,
+        multi_commits_verbose: bool = False,
     ):
         """
-        Upload a local folder to the given repo. The upload is done through a HTTP request and doesn't require git or
+        Upload a local folder to the given repo. The upload is done through a HTTP requests, and doesn't require git or
         git-lfs to be installed.
 
         The structure of the folder will be preserved. Files with the same name already present in the repository will
@@ -2643,9 +3050,12 @@ class HfApi:
         Use the `delete_patterns` argument to specify remote files you want to delete. Input type is the same as for
         `allow_patterns` (see above). If `path_in_repo` is also provided, the patterns are matched against paths
         relative to this folder. For example, `upload_folder(..., path_in_repo="experiment", delete_patterns="logs/*")`
-        will delete any remote file under `experiment/logs/`. Note that the `.gitattributes` file will not be deleted
+        will delete any remote file under `./experiment/logs/`. Note that the `.gitattributes` file will not be deleted
         even if it matches the patterns.
 
+        Any `.git/` folder present in any subdirectory will be ignored. However, please be aware that the `.gitignore`
+        file is not taken into account.
+
         Uses `HfApi.create_commit` under the hood.
 
         Args:
@@ -2672,11 +3082,11 @@ class HfApi:
             commit_description (`str` *optional*):
                 The description of the generated commit
             create_pr (`boolean`, *optional*):
-                Whether or not to create a Pull Request with that commit. Defaults to `False`.
-                If `revision` is not set, PR is opened against the `"main"` branch. If
-                `revision` is set and is a branch, PR is opened against this branch. If
-                `revision` is set and is not a branch name (example: a commit oid), an
-                `RevisionNotFoundError` is returned by the server.
+                Whether or not to create a Pull Request with that commit. Defaults to `False`. If `revision` is not
+                set, PR is opened against the `"main"` branch. If `revision` is set and is a branch, PR is opened
+                against this branch. If `revision` is set and is not a branch name (example: a commit oid), an
+                `RevisionNotFoundError` is returned by the server. If both `multi_commits` and `create_pr` are True,
+                the PR created in the multi-commit process is kept opened.
             parent_commit (`str`, *optional*):
                 The OID / SHA of the parent commit, as a hexadecimal string. Shorthands (7 first characters) are also supported.
                 If specified and `create_pr` is `False`, the commit will fail if `revision` does not point to `parent_commit`.
@@ -2691,6 +3101,10 @@ class HfApi:
                 If provided, remote files matching any of the patterns will be deleted from the repo while committing
                 new files. This is useful if you don't know which files have already been uploaded.
                 Note: to avoid discrepancies the `.gitattributes` file is not deleted even if it matches the pattern.
+            multi_commits (`bool`):
+                If True, changes are pushed to a PR using a multi-commit process. Defaults to `False`.
+            multi_commits_verbose (`bool`):
+                If True and `multi_commits` is used, more information will be displayed to the user.
 
         Returns:
             `str`: A URL to visualize the uploaded folder on the hub
@@ -2714,6 +3128,12 @@ class HfApi:
 
         </Tip>
 
+        <Tip warning={true}>
+
+        `multi_commits` is experimental. Its API and behavior is subject to change in the future without prior notice.
+
+        </Tip>
+
         Example:
 
         ```python
@@ -2749,20 +3169,27 @@ class HfApi:
         ...     token="my_token",
         ...     create_pr=True,
         ... )
-        # "https://huggingface.co/datasets/username/my-dataset/tree/refs%2Fpr%2F1/remote/experiment/checkpoints"
+        "https://huggingface.co/datasets/username/my-dataset/tree/refs%2Fpr%2F1/remote/experiment/checkpoints"
 
         ```
         """
         if repo_type not in REPO_TYPES:
             raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
 
+        if multi_commits:
+            if revision is not None and revision != DEFAULT_REVISION:
+                raise ValueError("Cannot use `multi_commit` to commit changes other than the main branch.")
+
         # By default, upload folder to the root directory in repo.
         if path_in_repo is None:
             path_in_repo = ""
 
-        commit_message = (
-            commit_message if commit_message is not None else f"Upload {path_in_repo} with huggingface_hub"
-        )
+        # Do not upload .git folder
+        if ignore_patterns is None:
+            ignore_patterns = []
+        elif isinstance(ignore_patterns, str):
+            ignore_patterns = [ignore_patterns]
+        ignore_patterns += IGNORE_GIT_FOLDER_PATTERNS
 
         delete_operations = self._prepare_upload_folder_deletions(
             repo_id=repo_id,
@@ -2787,20 +3214,37 @@ class HfApi:
             ]
         commit_operations = delete_operations + add_operations
 
-        commit_info = self.create_commit(
-            repo_type=repo_type,
-            repo_id=repo_id,
-            operations=commit_operations,
-            commit_message=commit_message,
-            commit_description=commit_description,
-            token=token,
-            revision=revision,
-            create_pr=create_pr,
-            parent_commit=parent_commit,
-        )
+        pr_url: Optional[str]
+        commit_message = commit_message or "Upload folder using huggingface_hub"
+        if multi_commits:
+            addition_commits, deletion_commits = plan_multi_commits(operations=commit_operations)
+            pr_url = self.create_commits_on_pr(
+                repo_id=repo_id,
+                repo_type=repo_type,
+                addition_commits=addition_commits,
+                deletion_commits=deletion_commits,
+                commit_message=commit_message,
+                commit_description=commit_description,
+                token=token,
+                merge_pr=not create_pr,
+                verbose=multi_commits_verbose,
+            )
+        else:
+            commit_info = self.create_commit(
+                repo_type=repo_type,
+                repo_id=repo_id,
+                operations=commit_operations,
+                commit_message=commit_message,
+                commit_description=commit_description,
+                token=token,
+                revision=revision,
+                create_pr=create_pr,
+                parent_commit=parent_commit,
+            )
+            pr_url = commit_info.pr_url
 
-        if commit_info.pr_url is not None:
-            revision = quote(_parse_revision_from_pr_url(commit_info.pr_url), safe="")
+        if create_pr and pr_url is not None:
+            revision = quote(_parse_revision_from_pr_url(pr_url), safe="")
         if repo_type in REPO_TYPES_URL_PREFIXES:
             repo_id = REPO_TYPES_URL_PREFIXES[repo_type] + repo_id
         revision = revision if revision is not None else DEFAULT_REVISION
@@ -3020,7 +3464,7 @@ class HfApi:
             payload["startingPoint"] = revision
 
         # Create branch
-        response = requests.post(url=branch_url, headers=headers, json=payload)
+        response = get_session().post(url=branch_url, headers=headers, json=payload)
         try:
             hf_raise_for_status(response)
         except HfHubHTTPError as e:
@@ -3073,7 +3517,7 @@ class HfApi:
         headers = self._build_hf_headers(token=token, is_write_action=True)
 
         # Delete branch
-        response = requests.delete(url=branch_url, headers=headers)
+        response = get_session().delete(url=branch_url, headers=headers)
         hf_raise_for_status(response)
 
     @validate_hf_hub_args
@@ -3140,7 +3584,7 @@ class HfApi:
             payload["message"] = tag_message
 
         # Tag
-        response = requests.post(url=tag_url, headers=headers, json=payload)
+        response = get_session().post(url=tag_url, headers=headers, json=payload)
         try:
             hf_raise_for_status(response)
         except HfHubHTTPError as e:
@@ -3190,7 +3634,7 @@ class HfApi:
         headers = self._build_hf_headers(token=token, is_write_action=True)
 
         # Un-tag
-        response = requests.delete(url=tag_url, headers=headers)
+        response = get_session().delete(url=tag_url, headers=headers)
         hf_raise_for_status(response)
 
     @validate_hf_hub_args
@@ -3281,7 +3725,7 @@ class HfApi:
 
         def _fetch_discussion_page(page_index: int):
             path = f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions?p={page_index}"
-            resp = requests.get(path, headers=headers)
+            resp = get_session().get(path, headers=headers)
             hf_raise_for_status(resp)
             paginated_discussions = resp.json()
             total = paginated_discussions["count"]
@@ -3304,6 +3748,7 @@ class HfApi:
                     repo_id=discussion["repo"]["name"],
                     repo_type=discussion["repo"]["type"],
                     is_pull_request=discussion["isPullRequest"],
+                    endpoint=self.endpoint,
                 )
             page_index = page_index + 1
 
@@ -3356,7 +3801,7 @@ class HfApi:
 
         path = f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions/{discussion_num}"
         headers = self._build_hf_headers(token=token)
-        resp = requests.get(path, params={"diff": "1"}, headers=headers)
+        resp = get_session().get(path, params={"diff": "1"}, headers=headers)
         hf_raise_for_status(resp)
 
         discussion_details = resp.json()
@@ -3380,6 +3825,7 @@ class HfApi:
             target_branch=target_branch,
             merge_commit_oid=merge_commit_oid,
             diff=discussion_details.get("diff"),
+            endpoint=self.endpoint,
         )
 
     @validate_hf_hub_args
@@ -3453,7 +3899,7 @@ class HfApi:
         )
 
         headers = self._build_hf_headers(token=token, is_write_action=True)
-        resp = requests.post(
+        resp = get_session().post(
             f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions",
             json={
                 "title": title.strip(),
@@ -3961,7 +4407,7 @@ class HfApi:
             token (`str`, *optional*):
                 Hugging Face token. Will default to the locally saved token if not provided.
         """
-        r = requests.post(
+        r = get_session().post(
             f"{self.endpoint}/api/spaces/{repo_id}/secrets",
             headers=self._build_hf_headers(token=token),
             json={"key": key, "value": value},
@@ -3983,7 +4429,7 @@ class HfApi:
             token (`str`, *optional*):
                 Hugging Face token. Will default to the locally saved token if not provided.
         """
-        r = requests.delete(
+        r = get_session().delete(
             f"{self.endpoint}/api/spaces/{repo_id}/secrets",
             headers=self._build_hf_headers(token=token),
             json={"key": key},
@@ -4003,12 +4449,21 @@ class HfApi:
         Returns:
             [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
         """
-        r = requests.get(f"{self.endpoint}/api/spaces/{repo_id}/runtime", headers=self._build_hf_headers(token=token))
+        r = get_session().get(
+            f"{self.endpoint}/api/spaces/{repo_id}/runtime", headers=self._build_hf_headers(token=token)
+        )
         hf_raise_for_status(r)
         return SpaceRuntime(r.json())
 
     @validate_hf_hub_args
-    def request_space_hardware(self, repo_id: str, hardware: SpaceHardware, *, token: Optional[str] = None) -> None:
+    def request_space_hardware(
+        self,
+        repo_id: str,
+        hardware: SpaceHardware,
+        *,
+        token: Optional[str] = None,
+        sleep_time: Optional[int] = None,
+    ) -> SpaceRuntime:
         """Request new hardware for a Space.
 
         Args:
@@ -4018,6 +4473,13 @@ class HfApi:
                 Hardware on which to run the Space. Example: `"t4-medium"`.
             token (`str`, *optional*):
                 Hugging Face token. Will default to the locally saved token if not provided.
+            sleep_time (`int`, *optional*):
+                Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
+                your Space to sleep (default behavior for upgraded hardware). For free hardware, you can't configure
+                the sleep time (value is fixed to 48 hours of inactivity).
+                See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
 
         <Tip>
 
@@ -4025,19 +4487,80 @@ class HfApi:
 
         </Tip>
         """
-        r = requests.post(
+        if sleep_time is not None and hardware == SpaceHardware.CPU_BASIC:
+            warnings.warn(
+                (
+                    "If your Space runs on the default 'cpu-basic' hardware, it will go to sleep if inactive for more"
+                    " than 48 hours. This value is not configurable. If you don't want your Space to deactivate or if"
+                    " you want to set a custom sleep time, you need to upgrade to a paid Hardware."
+                ),
+                UserWarning,
+            )
+        payload: Dict[str, Any] = {"flavor": hardware}
+        if sleep_time is not None:
+            payload["sleepTimeSeconds"] = sleep_time
+        r = get_session().post(
             f"{self.endpoint}/api/spaces/{repo_id}/hardware",
             headers=self._build_hf_headers(token=token),
-            json={"flavor": hardware},
+            json=payload,
+        )
+        hf_raise_for_status(r)
+        return SpaceRuntime(r.json())
+
+    @validate_hf_hub_args
+    def set_space_sleep_time(self, repo_id: str, sleep_time: int, *, token: Optional[str] = None) -> SpaceRuntime:
+        """Set a custom sleep time for a Space running on upgraded hardware..
+
+        Your Space will go to sleep after X seconds of inactivity. You are not billed when your Space is in "sleep"
+        mode. If a new visitor lands on your Space, it will "wake it up". Only upgraded hardware can have a
+        configurable sleep time. To know more about the sleep stage, please refer to
+        https://huggingface.co/docs/hub/spaces-gpus#sleep-time.
+
+        Args:
+            repo_id (`str`):
+                ID of the repo to update. Example: `"bigcode/in-the-stack"`.
+            sleep_time (`int`, *optional*):
+                Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
+                your Space to pause (default behavior for upgraded hardware). For free hardware, you can't configure
+                the sleep time (value is fixed to 48 hours of inactivity).
+                See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
+            token (`str`, *optional*):
+                Hugging Face token. Will default to the locally saved token if not provided.
+        Returns:
+            [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
+
+        <Tip>
+
+        It is also possible to set a custom sleep time when requesting hardware with [`request_space_hardware`].
+
+        </Tip>
+        """
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/sleeptime",
+            headers=self._build_hf_headers(token=token),
+            json={"seconds": sleep_time},
         )
         hf_raise_for_status(r)
+        runtime = SpaceRuntime(r.json())
+
+        hardware = runtime.requested_hardware or runtime.hardware
+        if hardware == SpaceHardware.CPU_BASIC:
+            warnings.warn(
+                (
+                    "If your Space runs on the default 'cpu-basic' hardware, it will go to sleep if inactive for more"
+                    " than 48 hours. This value is not configurable. If you don't want your Space to deactivate or if"
+                    " you want to set a custom sleep time, you need to upgrade to a paid Hardware."
+                ),
+                UserWarning,
+            )
+        return runtime
 
     @validate_hf_hub_args
     def pause_space(self, repo_id: str, *, token: Optional[str] = None) -> SpaceRuntime:
         """Pause your Space.
 
         A paused Space stops executing until manually restarted by its owner. This is different from the sleeping
-        state in which free Spaces go after 72h of inactivity. Paused time is not billed to your account, no matter the
+        state in which free Spaces go after 48h of inactivity. Paused time is not billed to your account, no matter the
         hardware you've selected. To restart your Space, use [`restart_space`] and go to your Space settings page.
 
         For more details, please visit [the docs](https://huggingface.co/docs/hub/spaces-gpus#pause).
@@ -4062,7 +4585,9 @@ class HfApi:
                 If your Space is a static Space. Static Spaces are always running and never billed. If you want to hide
                 a static Space, you can set it to private.
         """
-        r = requests.post(f"{self.endpoint}/api/spaces/{repo_id}/pause", headers=self._build_hf_headers(token=token))
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/pause", headers=self._build_hf_headers(token=token)
+        )
         hf_raise_for_status(r)
         return SpaceRuntime(r.json())
 
@@ -4096,7 +4621,9 @@ class HfApi:
                 If your Space is a static Space. Static Spaces are always running and never billed. If you want to hide
                 a static Space, you can set it to private.
         """
-        r = requests.post(f"{self.endpoint}/api/spaces/{repo_id}/restart", headers=self._build_hf_headers(token=token))
+        r = get_session().post(
+            f"{self.endpoint}/api/spaces/{repo_id}/restart", headers=self._build_hf_headers(token=token)
+        )
         hf_raise_for_status(r)
         return SpaceRuntime(r.json())
 
@@ -4109,7 +4636,7 @@ class HfApi:
         private: Optional[bool] = None,
         token: Optional[str] = None,
         exist_ok: bool = False,
-    ) -> str:
+    ) -> RepoUrl:
         """Duplicate a Space.
 
         Programmatically duplicate a Space. The new Space will be created in your account and will be in the same state
@@ -4170,7 +4697,7 @@ class HfApi:
         if private is not None:
             payload["private"] = private
 
-        r = requests.post(
+        r = get_session().post(
             f"{self.endpoint}/api/spaces/{from_id}/duplicate",
             headers=self._build_hf_headers(token=token, is_write_action=True),
             json=payload,
@@ -4304,9 +4831,6 @@ def _parse_revision_from_pr_url(pr_url: str) -> str:
 
 api = HfApi()
 
-set_access_token = api.set_access_token
-unset_access_token = api.unset_access_token
-
 whoami = api.whoami
 
 list_models = api.list_models
@@ -4322,6 +4846,7 @@ repo_info = api.repo_info
 list_repo_files = api.list_repo_files
 list_repo_refs = api.list_repo_refs
 list_repo_commits = api.list_repo_commits
+list_files_info = api.list_files_info
 
 list_metrics = api.list_metrics
 
@@ -4337,6 +4862,7 @@ upload_file = api.upload_file
 upload_folder = api.upload_folder
 delete_file = api.delete_file
 delete_folder = api.delete_folder
+create_commits_on_pr = api.create_commits_on_pr
 create_branch = api.create_branch
 delete_branch = api.delete_branch
 create_tag = api.create_tag
@@ -4364,6 +4890,7 @@ add_space_secret = api.add_space_secret
 delete_space_secret = api.delete_space_secret
 get_space_runtime = api.get_space_runtime
 request_space_hardware = api.request_space_hardware
+set_space_sleep_time = api.set_space_sleep_time
 pause_space = api.pause_space
 restart_space = api.restart_space
 duplicate_space = api.duplicate_space