@@ -0,0 +1 @@
+use flake
@@ -17,7 +17,7 @@
 
 ### Python Instructions
 
-- Write code to support Python 3.11, 3.12, 3.13.
+- Write code to support Python 3.12, 3.13, 3.14.
 - Write clear and concise comments for each function.
 - Ensure functions have descriptive names and include type hints.
 - Provide docstrings following PEP 257 conventions.
@@ -54,7 +54,8 @@ def calculate_area(radius: float) -> float:
         The area of the circle, calculated as π * radius^2.
     """
     import math
-    return math.pi * radius ** 2
+
+    return math.pi * radius**2
 ```
 
 ## Development Commands
 
@@ -27,7 +27,7 @@ jobs:
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          python-version: "3.11"
+          python-version: "3.14"
 
       - name: Install package
         run: |
 
@@ -47,7 +47,7 @@ jobs:
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
-          python-version: "3.11"
+          python-version: "3.14"
 
       - name: Install package
         run: |
 
@@ -42,8 +42,8 @@ jobs:
           - ubuntu-latest
           - gpu-runner
         python-version:
-          - "3.11"
-          - "3.13"
+          - "3.12"
+          - "3.14"
         test-group:
           - "not slow and not perf"
 
@@ -129,7 +129,9 @@ jobs:
           retention-days: 1
 
   benchmark:
-    # Will fail if an slowdown in the median of more than 10% is detected
+    # Fails on a median slowdown of more than 25%. The threshold is wide
+    # because this runs on a shared runner, where no-op PRs have drifted by
+    # up to 20%; anything tighter reports noise as a regression.
     name: 'Run Benchmark Comparison'
     if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
@@ -148,6 +150,8 @@ jobs:
         uses: astral-sh/setup-uv@v7
         with:
           enable-cache: true
+          # This job builds both the base and the PR checkout, so the version
+          # must satisfy `requires-python` on both sides of the comparison.
           python-version: "3.13"
 
       - name: 'Install dependencies'
@@ -185,7 +189,7 @@ jobs:
            -W ignore::pytest_benchmark.logger.PytestBenchmarkWarning \
            --log-cli-level=WARNING \
            --benchmark-storage=file://baseline-benchmarks \
-           --benchmark-compare-fail=median:10% \
+           --benchmark-compare-fail=median:25% \
            --benchmark-compare=0001
 
   publish-test-results:
 
@@ -238,4 +238,9 @@ Thumbs.db
 *~
 *.swp
 
+### Nix ###
+result
+result-*
+.direnv/
+
 sandbox/**
@@ -22,8 +22,9 @@ repos:
       - id: trailing-whitespace
         exclude: '\.out$'
 
-  - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.12.11
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Keep in sync with the ruff pin in pyproject.toml; update-ruff.yml bumps both.
+    rev: v0.16.5
     hooks:
       - id: ruff
         exclude: '\.out$|^benches/'
 
@@ -1 +1 @@
-3.11
+3.14
@@ -59,7 +59,7 @@ accuracy, not just the shapes.
 
 ## Code style
 
-The project targets Python 3.11+ and is checked with `ruff` under a strict rule
+The project targets Python 3.12+ and is checked with `ruff` under a strict rule
 set. Public functions carry type hints and Google-style docstrings without type
 annotations in the argument list. Keep lines within the configured limit and
 prefer clear code over clever code.
@@ -4,7 +4,7 @@
 [![Test src_method](https://github.com/Algorithmiq/src-method/actions/workflows/test.yml/badge.svg)](https://github.com/Algorithmiq/src-method/actions/workflows/test.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
 
-An implementation of the SRC algorithm introduced in [Camaño, Epperly and Tropp, *Quantum* **10**, 2022 (2026)](https://doi.org/10.22331/q-2026-03-10-2022) ([arXiv:2504.06475](https://arxiv.org/abs/2504.06475)), extending the idea to other kinds of tensor networks.
+An implementation of the SRC algorithm introduced in [Camaño, Epperly and Tropp, *Quantum* **10**, 2022 (2026)](https://doi.org/10.22331/q-2026-03-10-2022), extending the idea to other kinds of tensor networks.
 
 ### Features
 
@@ -116,6 +116,33 @@ process is done, you will have _all_ project dependencies installed, including
 > DevContainer is non-deterministic.  You might have to execute the *Reload Window*
 > command to get everything to work as expected after a fresh build of the container.
 
+### Alternative: Nix flake
+
+If you prefer [Nix] over Docker, the repository ships a `flake.nix` that provides
+a development shell with [uv], [Git] and the [GitHub CLI], plus the native
+libraries the binary wheels need at runtime. Python itself and all project
+dependencies remain managed by `uv`.
+
+With [flakes enabled](https://nixos.wiki/wiki/Flakes#Enable_flakes_temporarily), run:
+
+```bash
+nix develop
+```
+
+Entering the shell runs `uv sync --all-groups` and activates the uv project
+environment (`$UV_PROJECT_ENVIRONMENT` if set, otherwise `.venv`), so you land
+in a ready-to-use environment. GPU extras are not installed by the flake: add them
+explicitly with `uv sync --all-groups --extra gpu-nvidia` (or `--all-groups --extra gpu-rocm`) on a machine with the matching drivers.
+
+If you use [direnv], the provided `.envrc` enters the shell automatically:
+
+```bash
+direnv allow
+```
+
+Unlike the DevContainer, the Nix shell does not install the `pre-commit` hooks for
+you. Run `pre-commit install --install-hooks` once after the first `nix develop`.
+
 ## Documentation
 
 We use [MkDocs] to generate our documentation pages. You can find the latest version [at this link].
@@ -135,5 +162,9 @@ the editor will prompt you to open a new page in your browser, where you can see
 [Docker]: https://docs.docker.com/get-docker/
 [Visual Studio Code]: https://code.visualstudio.com/
 [GitHub CLI]: https://cli.github.com/
+[Git]: https://git-scm.com/
+[Nix]: https://nixos.org/download/
+[direnv]: https://direnv.net/
+[uv]: https://docs.astral.sh/uv/
 [MkDocs]: https://www.mkdocs.org/
 [at this link]: https://docs.algorithmiq.fi/src_method