class huggingface_hub.Repositoryhuggingface_hub.Repositoryhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L426[{"name": "local_dir", "val": ": typing.Union[str, pathlib.Path]"}, {"name": "clone_from", "val": ": typing.Optional[str] = None"}, {"name": "repo_type", "val": ": typing.Optional[str] = None"}, {"name": "token", "val": ": typing.Union[bool, str] = True"}, {"name": "git_user", "val": ": typing.Optional[str] = None"}, {"name": "git_email", "val": ": typing.Optional[str] = None"}, {"name": "revision", "val": ": typing.Optional[str] = None"}, {"name": "skip_lfs_files", "val": ": bool = False"}, {"name": "client", "val": ": typing.Optional[huggingface_hub.hf_api.HfApi] = None"}] Helper class to wrap the git and git-lfs commands. The aim is to facilitate interacting with huggingface.co hosted model or dataset repos, though not a lot here (if any) is actually specific to huggingface.co. > [!WARNING] > [Repository](/docs/huggingface_hub/main/en/package_reference/repository#huggingface_hub.Repository) is deprecated in favor of the http-based alternatives implemented in > [HfApi](/docs/huggingface_hub/main/en/package_reference/hf_api#huggingface_hub.HfApi). Given its large adoption in legacy code, the complete removal of > [Repository](/docs/huggingface_hub/main/en/package_reference/repository#huggingface_hub.Repository) will only happen in release `v1.0`. For more details, please read > https://huggingface.co/docs/huggingface_hub/concepts/git_vs_http.

__init__huggingface_hub.Repository.__init__https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L443[{"name": "local_dir", "val": ": typing.Union[str, pathlib.Path]"}, {"name": "clone_from", "val": ": typing.Optional[str] = None"}, {"name": "repo_type", "val": ": typing.Optional[str] = None"}, {"name": "token", "val": ": typing.Union[bool, str] = True"}, {"name": "git_user", "val": ": typing.Optional[str] = None"}, {"name": "git_email", "val": ": typing.Optional[str] = None"}, {"name": "revision", "val": ": typing.Optional[str] = None"}, {"name": "skip_lfs_files", "val": ": bool = False"}, {"name": "client", "val": ": typing.Optional[huggingface_hub.hf_api.HfApi] = None"}]- **local_dir** (`str` or `Path`) -- path (e.g. `'my_trained_model/'`) to the local directory, where the `Repository` will be initialized. - **clone_from** (`str`, *optional*) -- Either a repository url or `repo_id`. Example: - `"https://huggingface.co/philschmid/playground-tests"` - `"philschmid/playground-tests"` - **repo_type** (`str`, *optional*) -- To set when cloning a repo from a repo_id. Default is 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 `hf auth login` or [login()](/docs/huggingface_hub/main/en/package_reference/authentication#huggingface_hub.login)), token will be retrieved from the cache. If `False`, token is not sent in the request header. - **git_user** (`str`, *optional*) -- will override the `git config user.name` for committing and pushing files to the hub. - **git_email** (`str`, *optional*) -- will override the `git config user.email` for committing and pushing files to the hub. - **revision** (`str`, *optional*) -- Revision to checkout after initializing the repository. If the revision doesn't exist, a branch will be created with that revision name from the default branch's current HEAD. - **skip_lfs_files** (`bool`, *optional*, defaults to `False`) -- whether to skip git-LFS files or not. - **client** (`HfApi`, *optional*) -- Instance of [HfApi](/docs/huggingface_hub/main/en/package_reference/hf_api#huggingface_hub.HfApi) to use when calling the HF Hub API. A new instance will be created if this is left to `None`.0- [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- If the remote repository set in `clone_from` does not exist.``EnvironmentError`` Instantiate a local clone of a git repo. If `clone_from` is set, the repo will be cloned from an existing remote repository. If the remote repo does not exist, a `EnvironmentError` exception will be thrown. Please create the remote repo first using [create_repo()](/docs/huggingface_hub/main/en/package_reference/hf_api#huggingface_hub.HfApi.create_repo). `Repository` uses the local git credentials by default. If explicitly set, the `token` or the `git_user`/`git_email` pair will be used instead.

current_branchhuggingface_hub.Repository.current_branchhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L560[]`str`Current checked out branch. Returns the current checked out branch.

add_taghuggingface_hub.Repository.add_taghttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1241[{"name": "tag_name", "val": ": str"}, {"name": "message", "val": ": typing.Optional[str] = None"}, {"name": "remote", "val": ": typing.Optional[str] = None"}]- **tag_name** (`str`) -- The name of the tag to be added. - **message** (`str`, *optional*) -- The message that accompanies the tag. The tag will turn into an annotated tag if a message is passed. - **remote** (`str`, *optional*) -- The remote on which to add the tag.0 Add a tag at the current head and push it If remote is None, will just be updated locally If no message is provided, the tag will be lightweight. if a message is provided, the tag will be annotated.

auto_track_binary_fileshuggingface_hub.Repository.auto_track_binary_fileshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L883[{"name": "pattern", "val": ": str = '.'"}]- **pattern** (`str`, *optional*, defaults to ".") -- The pattern with which to track files that are binary.0`List[str]`List of filenames that are now tracked due to being binary files Automatically track binary files with git-lfs.

auto_track_large_fileshuggingface_hub.Repository.auto_track_large_fileshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L926[{"name": "pattern", "val": ": str = '.'"}]- **pattern** (`str`, *optional*, defaults to ".") -- The pattern with which to track files that are above 10MBs.0`List[str]`List of filenames that are now tracked due to their size. Automatically track large files (files that weigh more than 10MBs) with git-lfs.

check_git_versionshuggingface_hub.Repository.check_git_versionshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L575[]- [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- If `git` or `git-lfs` are not installed.``EnvironmentError`` Checks that `git` and `git-lfs` can be run.

clone_fromhuggingface_hub.Repository.clone_fromhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L598[{"name": "repo_url", "val": ": str"}, {"name": "token", "val": ": typing.Union[bool, str, NoneType] = None"}]- **repo_url** (`str`) -- The URL from which to clone the repository - **token** (`Union[str, bool]`, *optional*) -- Whether to use the authentication token. It can be: - a string which is the token itself - `False`, which would not use the authentication token - `True`, which would fetch the authentication token from the local folder and use it (you should be logged in for this to work). - `None`, which would retrieve the value of `self.huggingface_token`.0 Clone from a remote. If the folder already exists, will try to clone the repository within it. If this folder is a git repository with linked history, will try to update the repository. > [!TIP] > Raises the following error: > > - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) > if an organization token (starts with "api_org") is passed. Use must use > your own personal access token (see https://hf.co/settings/tokens). > > - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) > if you are trying to clone the repository in a non-empty folder, or if the > `git` operations raise errors.

commithuggingface_hub.Repository.commithttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1325[{"name": "commit_message", "val": ": str"}, {"name": "branch", "val": ": typing.Optional[str] = None"}, {"name": "track_large_files", "val": ": bool = True"}, {"name": "blocking", "val": ": bool = True"}, {"name": "auto_lfs_prune", "val": ": bool = False"}]- **commit_message** (`str`) -- Message to use for the commit. - **branch** (`str`, *optional*) -- The branch on which the commit will appear. This branch will be checked-out before any operation. - **track_large_files** (`bool`, *optional*, defaults to `True`) -- Whether to automatically track large files or not. Will do so by default. - **blocking** (`bool`, *optional*, defaults to `True`) -- Whether the function should return only when the `git push` has finished. - **auto_lfs_prune** (`bool`, defaults to `True`) -- Whether to automatically prune files once they have been pushed to the remote.0 Context manager utility to handle committing to a repository. This automatically tracks large files (>10Mb) with git-lfs. Set the `track_large_files` argument to `False` if you wish to ignore that behavior. Examples: ```python >>> with Repository( ... "text-files", ... clone_from="/text-files", ... token=True, >>> ).commit("My first file :)"): ... with open("file.txt", "w+") as f: ... f.write(json.dumps({"hey": 8})) >>> import torch >>> model = torch.nn.Transformer() >>> with Repository( ... "torch-model", ... clone_from="/torch-model", ... token=True, >>> ).commit("My cool model :)"): ... torch.save(model.state_dict(), "model.pt") ```

delete_taghuggingface_hub.Repository.delete_taghttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1204[{"name": "tag_name", "val": ": str"}, {"name": "remote", "val": ": typing.Optional[str] = None"}]- **tag_name** (`str`) -- The tag name to delete. - **remote** (`str`, *optional*) -- The remote on which to delete the tag.0`bool``True` if deleted, `False` if the tag didn't exist. If remote is not passed, will just be updated locally Delete a tag, both local and remote, if it exists

git_addhuggingface_hub.Repository.git_addhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1001[{"name": "pattern", "val": ": str = '.'"}, {"name": "auto_lfs_track", "val": ": bool = False"}]- **pattern** (`str`, *optional*, defaults to ".") -- The pattern with which to add files to staging. - **auto_lfs_track** (`bool`, *optional*, defaults to `False`) -- Whether to automatically track large and binary files with git-lfs. Any file over 10MB in size, or in binary format, will be automatically tracked.0 git add Setting the `auto_lfs_track` parameter to `True` will automatically track files that are larger than 10MB with `git-lfs`.

git_checkouthuggingface_hub.Repository.git_checkouthttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1142[{"name": "revision", "val": ": str"}, {"name": "create_branch_ok", "val": ": bool = False"}]- **revision** (`str`) -- The revision to checkout. - **create_branch_ok** (`str`, *optional*, defaults to `False`) -- Whether creating a branch named with the `revision` passed at the current checked-out reference if `revision` isn't an existing revision is allowed.0 git checkout a given revision Specifying `create_branch_ok` to `True` will create the branch to the given revision if that revision doesn't exist.

git_commithuggingface_hub.Repository.git_commithttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1035[{"name": "commit_message", "val": ": str = 'commit files to HF hub'"}]- **commit_message** (`str`, *optional*, defaults to "commit files to HF hub") -- The message attributed to the commit.0 git commit

git_config_username_and_emailhuggingface_hub.Repository.git_config_username_and_emailhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L723[{"name": "git_user", "val": ": typing.Optional[str] = None"}, {"name": "git_email", "val": ": typing.Optional[str] = None"}]- **git_user** (`str`, *optional*) -- The username to register through `git`. - **git_email** (`str`, *optional*) -- The email to register through `git`.0 Sets git username and email (only in the current repo).

git_credential_helper_storehuggingface_hub.Repository.git_credential_helper_storehttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L742[] Sets the git credential helper to `store`

git_head_commit_urlhuggingface_hub.Repository.git_head_commit_urlhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L779[]`str`The URL to the current checked-out commit. Get URL to last commit on HEAD. We assume it's been pushed, and the url scheme is the same one as for GitHub or HuggingFace.

git_head_hashhuggingface_hub.Repository.git_head_hashhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L751[]`str`The current checked out commit SHA. Get commit sha on top of HEAD.

git_pullhuggingface_hub.Repository.git_pullhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L977[{"name": "rebase", "val": ": bool = False"}, {"name": "lfs", "val": ": bool = False"}]- **rebase** (`bool`, *optional*, defaults to `False`) -- Whether to rebase the current branch on top of the upstream branch after fetching. - **lfs** (`bool`, *optional*, defaults to `False`) -- Whether to fetch the LFS files too. This option only changes the behavior when a repository was cloned without fetching the LFS files; calling `repo.git_pull(lfs=True)` will then fetch the LFS file from the remote repository.0 git pull

git_pushhuggingface_hub.Repository.git_pushhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1052[{"name": "upstream", "val": ": typing.Optional[str] = None"}, {"name": "blocking", "val": ": bool = True"}, {"name": "auto_lfs_prune", "val": ": bool = False"}]- **upstream** (`str`, *optional*) -- Upstream to which this should push. If not specified, will push to the lastly defined upstream or to the default one (`origin main`). - **blocking** (`bool`, *optional*, defaults to `True`) -- Whether the function should return only when the push has finished. Setting this to `False` will return an `CommandInProgress` object which has an `is_done` property. This property will be set to `True` when the push is finished. - **auto_lfs_prune** (`bool`, *optional*, defaults to `False`) -- Whether to automatically prune files once they have been pushed to the remote.0 git push If used without setting `blocking`, will return url to commit on remote repo. If used with `blocking=True`, will return a tuple containing the url to commit and the command object to follow for information about the process.

git_remote_urlhuggingface_hub.Repository.git_remote_urlhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L764[]`str`The URL of the `origin` remote. Get URL to origin remote.

is_repo_cleanhuggingface_hub.Repository.is_repo_cleanhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1275[]`bool``True` if the git status is clean, `False` otherwise. Return whether or not the git status is clean or not

lfs_enable_largefileshuggingface_hub.Repository.lfs_enable_largefileshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L869[] HF-specific. This enables upload support of files >5GB.

lfs_prunehuggingface_hub.Repository.lfs_prunehttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L959[{"name": "recent", "val": " = False"}]- **recent** (`bool`, *optional*, defaults to `False`) -- Whether to prune files even if they were referenced by recent commits. See the following [link](https://github.com/git-lfs/git-lfs/blob/f3d43f0428a84fc4f1e5405b76b5a73ec2437e65/docs/man/git-lfs-prune.1.ronn#recent-files) for more information.0 git lfs prune

lfs_trackhuggingface_hub.Repository.lfs_trackhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L828[{"name": "patterns", "val": ": typing.Union[str, typing.List[str]]"}, {"name": "filename", "val": ": bool = False"}]- **patterns** (`Union[str, List[str]]`) -- The pattern, or list of patterns, to track with git-lfs. - **filename** (`bool`, *optional*, defaults to `False`) -- Whether to use the patterns as literal filenames.0 Tell git-lfs to track files according to a pattern. Setting the `filename` argument to `True` will treat the arguments as literal filenames, not as patterns. Any special glob characters in the filename will be escaped when writing to the `.gitattributes` file.

lfs_untrackhuggingface_hub.Repository.lfs_untrackhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L853[{"name": "patterns", "val": ": typing.Union[str, typing.List[str]]"}]- **patterns** (`Union[str, List[str]]`) -- The pattern, or list of patterns, to untrack with git-lfs.0 Tell git-lfs to untrack those files.

list_deleted_fileshuggingface_hub.Repository.list_deleted_fileshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L793[]`List[str]`A list of files that have been deleted in the working directory or index. Returns a list of the files that are deleted in the working directory or index.

push_to_hubhuggingface_hub.Repository.push_to_hubhttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1289[{"name": "commit_message", "val": ": str = 'commit files to HF hub'"}, {"name": "blocking", "val": ": bool = True"}, {"name": "clean_ok", "val": ": bool = True"}, {"name": "auto_lfs_prune", "val": ": bool = False"}]- **commit_message** (`str`) -- Message to use for the commit. - **blocking** (`bool`, *optional*, defaults to `True`) -- Whether the function should return only when the `git push` has finished. - **clean_ok** (`bool`, *optional*, defaults to `True`) -- If True, this function will return None if the repo is untouched. Default behavior is to fail because the git command fails. - **auto_lfs_prune** (`bool`, *optional*, defaults to `False`) -- Whether to automatically prune files once they have been pushed to the remote.0 Helper to add, commit, and push files to remote repository on the HuggingFace Hub. Will automatically track large files (>10MB).

tag_existshuggingface_hub.Repository.tag_existshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1174[{"name": "tag_name", "val": ": str"}, {"name": "remote", "val": ": typing.Optional[str] = None"}]- **tag_name** (`str`) -- The name of the tag to check. - **remote** (`str`, *optional*) -- Whether to check if the tag exists on a remote. This parameter should be the identifier of the remote.0`bool`Whether the tag exists. Check if a tag exists or not.

wait_for_commandshuggingface_hub.Repository.wait_for_commandshttps://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/repository.py#L1453[] Blocking method: blocks all subsequent execution until all commands have been processed.