diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..d31ad80
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,83 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Assert tag matches pyproject version
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          VERSION="$(python3 -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          if [ "$TAG" != "$VERSION" ]; then
+            echo "Tag v$TAG does not match pyproject version $VERSION" >&2
+            exit 1
+          fi
+
+      - name: Build
+        run: uv build
+
+      - name: Assert wheel contents
+        # Same guard as CI: a packaging change that drops the macros or config
+        # files produces a wheel that imports fine but cannot run a model.
+        run: |
+          python3 - <<'EOF'
+          import glob, sys, zipfile
+
+          wheel = glob.glob("dist/*.whl")[0]
+          names = set(zipfile.ZipFile(wheel).namelist())
+          required = [
+              "dbt/adapters/hotdata/__init__.py",
+              "dbt/adapters/hotdata/__version__.py",
+              "dbt/adapters/hotdata/client.py",
+              "dbt/adapters/hotdata/column.py",
+              "dbt/adapters/hotdata/connections.py",
+              "dbt/adapters/hotdata/credentials.py",
+              "dbt/adapters/hotdata/impl.py",
+              "dbt/adapters/hotdata/relation.py",
+              "dbt/adapters/hotdata/seeds.py",
+              "dbt/include/hotdata/__init__.py",
+              "dbt/include/hotdata/dbt_project.yml",
+              "dbt/include/hotdata/profile_template.yml",
+              "dbt/include/hotdata/macros/adapters.sql",
+              "dbt/include/hotdata/macros/materializations/table.sql",
+              "dbt/include/hotdata/macros/materializations/incremental.sql",
+              "dbt/include/hotdata/macros/materializations/seed.sql",
+              "dbt/include/hotdata/macros/materializations/view.sql",
+              "dbt/include/hotdata/macros/materializations/snapshot.sql",
+          ]
+          missing = [name for name in required if name not in names]
+          if missing:
+              sys.exit(f"wheel {wheel} is missing: {missing}")
+          print(f"ok: {wheel} contains all {len(required)} required files")
+          EOF
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/dbt-hotdata/
+    permissions:
+      # Required for PyPI trusted publishing (OIDC) — no API token needed.
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1