docs: add documentation for lfs usage and configuration

Author: samypr100

docs/concepts/projects/dependencies.md

@@ -350,6 +350,30 @@ dependencies = ["langchain"]
 langchain = { git = "https://github.com/langchain-ai/langchain", subdirectory = "libs/langchain" }
 ```
 
+Support for [Git LFS](https://git-lfs.com) is also configurable per source.
+
+```console
+$ uv add --lfs git+https://example.com/org/lfs-enabled-repo
+```
+
+```toml title="pyproject.toml"
+[project]
+dependencies = ["test-lfs-repo"]
+
+[tool.uv.sources]
+test-lfs-repo = { git = "https://example.com/org/lfs-enabled-repo", lfs = true }
+```
+
+- When `lfs = true`, uv will always fetch LFS objects for this git source.
+- When `lfs = false`, uv will never fetch LFS objects for this git source.
+- When omitted, `UV_GIT_LFS` environment variable takes precedence for all git sources without an
+  explicit `lfs` configuration.
+
+!!! warning
+
+    Ensure Git LFS is installed and configured on your system before attempting to install sources
+    using Git LFS, otherwise a build failure can occur.
+
 ### URL
 
 To add a URL source, provide a `https://` URL to either a wheel (ending in `.whl`) or a source

docs/guides/tools.md

@@ -142,6 +142,12 @@ Or even a specific commit:
 $ uvx --from git+https://github.com/httpie/cli@2843b87 httpie
 ```
 
+Or with [Git LFS](https://git-lfs.com) support:
+
+```console
+$ uvx --lfs --from git+https://example.com/org/lfs-enabled-repo lfs-enabled-executable
+```
+
 ## Commands with plugins
 
 Additional dependencies can be included, e.g., to include `mkdocs-material` when running `mkdocs`:
@@ -207,6 +213,12 @@ And, similarly, for package sources:
 $ uv tool install git+https://github.com/httpie/cli
 ```
 
+Or package sources with [Git LFS](https://git-lfs.com):
+
+```console
+$ uv tool install --lfs git+https://example.com/org/lfs-enabled-repo
+```
+
 As with `uvx`, installations can include additional packages:
 
 ```console