Add devcontainer support

.devcontainer/Dockerfile

@@ -0,0 +1,4 @@
+ARG VARIANT=3.13-bookworm
+FROM mcr.microsoft.com/devcontainers/python:1-${VARIANT}
+
+RUN python -m pip install --no-cache-dir uv==0.10.7

.devcontainer/devcontainer.json

@@ -0,0 +1,41 @@
+{
+  "name": "Python Open Source Template",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "args": {
+      "VARIANT": "3.13-bookworm"
+    }
+  },
+  "remoteUser": "vscode",
+  "updateRemoteUserUID": true,
+  "containerEnv": {
+    "UV_LINK_MODE": "copy"
+  },
+  "mounts": [
+    {
+      "source": "uv-cache-${devcontainerId}",
+      "target": "/home/vscode/.cache/uv",
+      "type": "volume"
+    }
+  ],
+  "postCreateCommand": "uv sync --all-groups --locked && uv run pre-commit install --install-hooks",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "astral-sh.ty",
+        "charliermarsh.ruff",
+        "ms-python.python",
+        "redhat.vscode-yaml"
+      ],
+      "settings": {
+        "editor.codeActionsOnSave": {
+          "source.fixAll.ruff": "explicit",
+          "source.organizeImports.ruff": "explicit"
+        },
+        "editor.formatOnSave": true,
+        "python.defaultInterpreterPath": "${containerWorkspaceFolder}/.venv/bin/python",
+        "python.testing.pytestEnabled": true
+      }
+    }
+  }
+}

README.md

@@ -26,6 +26,12 @@ make verify  # Checks, tests, package build, and strict documentation build
 See [CONTRIBUTING.md](CONTRIBUTING.md) for contributor guidance and
 [AGENTS.md](AGENTS.md) for agent instructions.
 
+## Dev Container
+
+Open the repository in a Dev Container to use the pinned Python and uv
+environment. It installs all dependency groups and the configured Git hooks on
+creation, while retaining the uv download cache between rebuilds.
+
 ## Documentation and Releases
 
 Documentation lives in `docs/` and is built with Sphinx using the Palewire