initial git-xet docs

Author: jsulz

docs/hub/repositories-getting-started.md

@@ -8,6 +8,9 @@ This document shows how to handle repositories through the web interface as well
 
 If you do not have `git` available as a CLI command yet, you will need to [install Git](https://git-scm.com/downloads) for your platform. You will also need to [install Git LFS](https://git-lfs.github.com/), which will be used to handle large files such as images and model weights.
 
+> [!TIP]
+> For improved upload and download speeds when working with large files and Git, install the [Git Xet](xet/using-xet-storage#git) extension. 
+
 To be able to push your code to the Hub, you'll need to authenticate somehow. The easiest way to do this is by installing the [`huggingface_hub` CLI](https://huggingface.co/docs/huggingface_hub/index) and running the login command:
 
 ```bash

docs/hub/xet/using-xet-storage.md

@@ -1,4 +1,6 @@
-## Using Xet Storage
+# Using Xet Storage
+
+## Python
 
 To access a Xet-aware version of the `huggingface_hub`, simply install the latest version:
 
@@ -24,19 +26,85 @@ To see more detailed usage docs, refer to the `huggingface_hub` docs for:
 - [Download](https://huggingface.co/docs/huggingface_hub/guides/download#hfxet)
 - [Managing the `hf_xet` cache](https://huggingface.co/docs/huggingface_hub/guides/manage-cache#chunk-based-caching-xet)
 
-### Recommendations
+## Git
+
+Git users can access the benefits of Xet by downloading and installing the Git Xet extension. Once installed, simply use the [standard workflows for managing Hub repositories with Git](../repositories-getting-started) - no additional changes necessary. 
+
+### Prerequisites
+
+Install [Git](https://git-scm.com/) and [Git LFS](https://git-lfs.com/). 
+
+### Install on macOS or Linux (amd64 or aarch64)
+
+ To install using [Homebrew](https://brew.sh/):
+   ```
+   brew tap huggingface/tap
+   brew install git-xet
+   ```
+ Or, using an installation script, run the following in your terminal (requires `curl` and `unzip`):
+   ```
+   curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/huggingface/xet-core/refs/heads/main/git_xet/install.sh | sh
+   ```
+  To verify the installation, run:
+   ```
+   git-xet --version
+   ```
+### Windows (amd64)
+
+ Using an installer: 
+ - Download `git-xet-windows-installer-x86_64.zip` ([available here](https://github.com/huggingface/xet-core/releases/download/git-xet-v0.1.0/git-xet-windows-installer-x86_64.zip)) and unzip. 
+ - Run the `msi` installer file and follow the prompts.
+   
+ Manual installation:
+ - Download `git-xet-windows-x86_64.zip` ([available here](https://github.com/huggingface/xet-core/releases/download/git-xet-v0.1.0/git-xet-windows-x86_64.zip)) and unzip. 
+ - Place the extracted `git-xet.exe` under a `PATH` directory.
+ - Run `git-xet install` in a terminal.
+
+To verity the installation, run:
+  ```
+  git-xet --version
+  ```
+
+### Uninstall on macOS or Linux
+
+Using Homebrew:
+   ```
+   git-xet uninstall
+   brew uninstall git-xet
+   ```
+If you used the installation script (for MacOS or Linux), run the following in your terminal:
+   ```
+   git-xet uninstall
+   sudo rm $(which git-xet)
+   ```
+### Uninstall on Windows
+
+If you used the installer:
+-  Navigate to Settings -> Apps -> Installed apps
+- Find "Git-Xet".
+- Select the "Uninstall" option available in the context menu.
+
+If you manually installed:
+- Run `git-xet uninstall` in a terminal. 
+- Delete the `git-xet.exe` file from the location where it was originally placed.
+
+## Recommendations
+
+Xet integrates seamlessly with all of the Hub's workflows. However, there are a few steps you may consider to get the most benefits from Xet storage.
+
+When uploading or downloading with Python:
+
+- **Make sure `hf_xet` is installed**: While Xet remains backward compatible with legacy clients optimized for Git LFS, the `hf_xet` integration with `huggingface_hub` delivers optimal chunk-based performance and faster iteration on large files.
+- **Utilize `hf_xet` environment variables**: The default installation of `hf_xet` is designed to support the broadest range of hardware. To take advantage of setups with more network bandwidth or processing power read up on `hf_xet`'s [environment variables](https://huggingface.co/docs/huggingface_hub/package_reference/environment_variables#xet) to optimize downloads and uploads.
 
-Xet integrates seamlessly with the Hub's current Python-based workflows. However, there are a few steps you may consider to get the most benefits from Xet storage:
+When uploading or downloading in Git or Python: 
 
-- **Use `hf_xet`**: While Xet remains backward compatible with legacy clients optimized for Git LFS, the `hf_xet` integration with `huggingface_hub` delivers optimal chunk-based performance and faster iteration on large files.
-- **Utilize `hf_xet` environment variables**: The default installation of `hf_xet` is designed to support the broadest range of hardware. To take advantage of setups with more network bandwidth or processing power read up on `hf_xet`'s [environment variables](https://huggingface.co/docs/huggingface_hub/package_reference/environment_variables#xet) to further speed up downloads and uploads.
 - **Leverage frequent, incremental commits**: Xet's chunk-level deduplication means you can safely make incremental updates to models or datasets. Only changed chunks are uploaded, so frequent commits are both fast and storage-efficient.
 - **Be Specific in .gitattributes**: When defining patterns for Xet or LFS, use precise file extensions (e.g., `*.safetensors`, `*.bin`) to avoid unnecessarily routing smaller files through large-file storage.
 - **Prioritize community access**: Xet substantially increases the efficiency and scale of large file transfers. Instead of structuring your repository to reduce its total size (or the size of individual files), organize it for collaborators and community users so they may easily navigate and retrieve the content they need.
 
-### Current Limitations
+## Current Limitations
 
 While Xet brings fine-grained deduplication and enhanced performance to Git-based storage, some features and platform compatibilities are still in development. As a result, keep the following constraints in mind when working with a Xet-enabled repository:
 
-- **64-bit systems only**: The `hf_xet` client currently requires a 64-bit architecture; 32-bit systems are not supported.
-- **Git client integration (git-xet)**: Under active development - coming soon, stay tuned!
+- **64-bit systems only**: The `hf_xet` client currently requires a 64-bit architecture; 32-bit systems are not supported.