From ae5653986c35858d48d2205b48d67bc64437054a Mon Sep 17 00:00:00 2001
From: Arcitec <38923130+Arcitec@users.noreply.github.com>
Date: Fri, 19 Sep 2025 02:35:27 +0200
Subject: [PATCH] chore: Note why package build isolation was disabled for
 DeepSpeed

---
 pyproject.toml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index b79bad9..1f67e94 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -88,6 +88,10 @@ build-backend = "hatchling.build"
 
 [tool.uv]
 # Disable build isolation when building DeepSpeed from source.
+# NOTE: This is *necessary* so that DeepSpeed builds directly within our `.venv`,
+# and finds our CUDA-enabled version of PyTorch, which DeepSpeed *needs* during
+# its compilation to determine what GPU support to compile for itself. It also
+# saves time, since it won't waste time downloading a generic PyTorch version.
 no-build-isolation-package = ["deepspeed"]
 
 [tool.uv.sources]