Fix uv resolving for the whole range of python versions.

* uv somehow decides to constrain libraries to be compatible with the whole range of python versions supported by torchjd (3.10-3.13) when resolving, so it does not install libraries that require python 3.11+ for example, even when using python 3.13. This leads to outdated library versions installed in the CI and locally, especially documentation-related libraries.
* Adding --python-version=... forces uv to resolve libraries compatible with the specified python version only, fixing the issue
* When using `uv run ...`, uv automatically re-syncs. There's no way to specify the python-version for which to resolve when this happens, so the idea is to prevent this resyncing by either using --no-sync everytime we call uv run, or by using the UV_NO_SYNC=1 environment variable. This is done in both ci files that have a uv run, and it's now recommended in CONTRIBUTING.md

Author: ValerianRey

.github/workflows/build-deploy-docs.yml

@@ -6,6 +6,9 @@ on:
     tags:
       - 'v[0-9]*.[0-9]*.[0-9]*'
 
+env:
+  UV_NO_SYNC: 1
+
 jobs:
   build-deploy-doc:
     name: Build & deploy doc
@@ -23,7 +26,7 @@ jobs:
           python-version: '3.13'
 
       - name: Install dependencies (default with full options & doc)
-        run: uv pip install '.[full]' --group doc
+        run: uv pip install --python-version=${{ inputs.python-version }} '.[full]' --group doc
 
       - name: Determine deployment folder
         id: deploy_folder

.github/workflows/tests.yml

@@ -6,6 +6,9 @@ on:
   schedule:
     - cron: '41 16 * * *'  # Every day at 16:41 UTC (to avoid high load at exact hour values).
 
+env:
+  UV_NO_SYNC: 1
+
 jobs:
   tests-full-install:
     name: Run tests with full install
@@ -23,7 +26,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install default (with full options) and test dependencies
-        run: uv pip install '.[full]' --group test
+        run: uv pip install --python-version=${{ inputs.python-version }} '.[full]' --group test
       - name: Run unit and doc tests with coverage report
         run: uv run pytest -W error tests/unit tests/doc --cov=src --cov-report=xml
       - name: Upload results to Codecov
@@ -41,7 +44,7 @@ jobs:
         with:
           python-version: '3.13'
       - name: Install default (without any option) and test dependencies
-        run: uv pip install . --group test
+        run: uv pip install --python-version=${{ inputs.python-version }} . --group test
       - name: Run unit and doc tests with coverage report
         run: |
           uv run pytest -W error tests/unit tests/doc \
@@ -67,7 +70,7 @@ jobs:
           python-version: '3.13'
 
       - name: Install dependencies (default with full options & doc)
-        run: uv pip install '.[full]' --group doc
+        run: uv pip install --python-version=${{ inputs.python-version }} '.[full]' --group doc
 
       - name: Build Documentation
         working-directory: docs
@@ -86,7 +89,7 @@ jobs:
         python-version: '3.13'
 
     - name: Install dependencies (default with full options & check)
-      run: uv pip install '.[full]' --group check
+      run: uv pip install --python-version=${{ inputs.python-version }} '.[full]' --group check
 
     - name: Run mypy
       run: uv run mypy src/torchjd

CONTRIBUTING.md

@@ -19,7 +19,21 @@ mandatory, we only provide installation steps with this tool. You can install it
 2) Create a virtual environment and install the project in it. From the root of `torchjd`, run:
    ```bash
    uv venv
-   CC=gcc uv pip install -e '.[full]' --group check --group doc --group test --group plot
+   CC=gcc uv pip install --python-version=3.13.3 -e '.[full]' --group check --group doc --group test --group plot
+   ```
+   We also advise using `UV_NO_SYNC=1` to prevent `uv` from syncing all the time. This is because by
+   default, it tries to resolve libraries compatible with the whole range of Python versions
+   supported by TorchJD, but in reality, we just need an installation compatible with the currently
+   used Python version. That's also why we specify `--python-version=3.14` when running
+   `uv pip install`. To follow that recommendation, add the following line to your `.bashrc`:
+   ```bash
+   export UV_NO_SYNC=1
+   ```
+   and start a new terminal. The alternative is to use the `--no-sync` flag whenever you run a pip
+   command that would normally sync (like `uv run`).
+
+3) Install pre-commit:
+   ```bash
    uv run pre-commit install
    ```
 
@@ -46,7 +60,7 @@ from the root of `torchjd`:
 rm -rf .venv
 rm uv.lock
 uv venv
-CC=gcc uv pip install -e '.[full]' --group check --group doc --group test --group plot
+CC=gcc uv pip install --python-version=3.13.3 -e '.[full]' --group check --group doc --group test --group plot
 uv run pre-commit install
 ```