horde-model-reference 3.0.0__tar.gz → 4.0.0__tar.gz

{horde_model_reference-3.0.0 → horde_model_reference-4.0.0}/.env.example

@@ -106,8 +106,8 @@
 # Enable pub/sub for cache invalidation across multiple PRIMARY workers.
 # HORDE_MODEL_REFERENCE_REDIS__USE_PUBSUB=True
 
-# URL of PRIMARY server API for REPLICA clients to fetch model references from. If None, REPLICA clients will only use GitHub. Example: https://stablehorde.net/api/model_references/
-# HORDE_MODEL_REFERENCE_PRIMARY_API_URL=https://stablehorde.net/api/model_references/
+# Base URL of the PRIMARY server API for REPLICA clients to fetch model references from. This must include the service's /api root path; the backend appends /model_references/v2/{category}. If None, REPLICA clients will only use GitHub. Example: https://models.aihorde.net/api
+# HORDE_MODEL_REFERENCE_PRIMARY_API_URL=https://models.aihorde.net/api
 
 # Timeout in seconds for HTTP requests to PRIMARY API.
 # HORDE_MODEL_REFERENCE_PRIMARY_API_TIMEOUT=10
@@ -364,8 +364,8 @@
 # Enable pub/sub for cache invalidation across multiple PRIMARY workers.
 # HORDE_MODEL_REFERENCE_REDIS__USE_PUBSUB=True
 
-# URL of PRIMARY server API for REPLICA clients to fetch model references from. If None, REPLICA clients will only use GitHub. Example: https://stablehorde.net/api/model_references/
-# HORDE_MODEL_REFERENCE_PRIMARY_API_URL=https://stablehorde.net/api/model_references/
+# Base URL of the PRIMARY server API for REPLICA clients to fetch model references from. This must include the service's /api root path; the backend appends /model_references/v2/{category}. If None, REPLICA clients will only use GitHub. Example: https://models.aihorde.net/api
+# HORDE_MODEL_REFERENCE_PRIMARY_API_URL=https://models.aihorde.net/api
 
 # Timeout in seconds for HTTP requests to PRIMARY API.
 # HORDE_MODEL_REFERENCE_PRIMARY_API_TIMEOUT=10

horde_model_reference-4.0.0/.git-blame-ignore-revs

@@ -0,0 +1 @@
+fb9a0b752e2c696acf24bfd657265820213986df

horde_model_reference-4.0.0/.github/workflows/codeql.yml

@@ -0,0 +1,88 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: ["main"]
+    paths-ignore:
+      - "**/*.md"
+      - "**/*.txt"
+      - "**/*.json"
+      - "**/*.toml"
+      - "**/*.yaml"
+      - "**/*.yml"
+  schedule:
+    - cron: "30 13 * * 3"
+
+jobs:
+  analyze:
+    name: Analyze
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners
+    # Consider using larger runners for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    timeout-minutes: ${{ (matrix.language == 'swift' && 120) || 360 }}
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ["python"]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby', 'swift' ]
+        # Use only 'java' to analyze code written in Java, Kotlin or both
+        # Use only 'javascript' to analyze code written in JavaScript, TypeScript or both
+        # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      # Initializes the CodeQL tools for scanning.
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+          # If you wish to specify custom queries, you can do so here or in a config file.
+          # By default, queries listed here will override any specified in a config file.
+          # Prefix the list here with "+" to use these queries and those in the config file.
+
+          # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+          # queries: security-extended,security-and-quality
+
+      # Autobuild attempts to build any compiled languages (C/C++, C#, Go, Java, or Swift).
+      # If this step fails, then you should remove it and run the build manually (see below)
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v3
+
+      # ℹ️ Command-line programs to run using the OS shell.
+      # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+
+      #   If the Autobuild fails above, remove it and uncomment the following three lines.
+      #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
+
+      # - run: |
+      #     echo "Run, Build Application using script"
+      #     ./location_of_script_within_repo/buildscript.sh
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3
+        with:
+          category: "/language:${{matrix.language}}"

horde_model_reference-4.0.0/.github/workflows/docker-publish.yml

@@ -0,0 +1,261 @@
+# SPDX-FileCopyrightText: 2026 Tazlin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+name: Docker image publish
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+    paths:
+      - 'Dockerfile'
+      - '.dockerignore'
+      - 'src/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - '.github/workflows/docker-publish.yml'
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+concurrency:
+  group: docker-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # -----------------------------------------------------------
+  # Build the Docker image and push to GHCR on main / tags.
+  # PRs only build (no push) so the image can be validated.
+  #
+  # IMPORTANT: The image MUST be built with --build-arg EXTRA_DEPS=redis
+  # to include the redis[hiredis] extra.  Without it, multi-worker PRIMARY
+  # deployments fail with ImportError on startup.
+  # -----------------------------------------------------------
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+    outputs:
+      image-digest: ${{ steps.build.outputs.digest }}
+      image-tags: ${{ steps.meta.outputs.tags }}
+      image-version: ${{ steps.meta.outputs.version }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha
+
+      - name: Build and push
+        id: build
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          load: ${{ github.event_name == 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: EXTRA_DEPS=redis
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Generate artifact attestation
+        if: github.event_name != 'pull_request'
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          subject-digest: ${{ steps.build.outputs.digest }}
+          push-to-registry: true
+
+  # -----------------------------------------------------------
+  # Validate the image starts and responds to the health check.
+  #
+  # Runs in PRIMARY mode with GitHub seeding enabled so the
+  # service downloads real model data and exercises the full
+  # startup path (no Postgres dependency, service uses file
+  # system as its primary storage backend).
+  #
+  # Tested variants in this job:
+  #   1. Single-worker PRIMARY (default CMD / fastapi run)
+  #   2. Multi-worker PRIMARY + Redis (uvicorn --workers 2)
+  #
+  # Both must pass /api/heartbeat before the job succeeds.
+  # -----------------------------------------------------------
+  validate:
+    runs-on: ubuntu-latest
+    needs: build-and-push
+    permissions:
+      contents: read
+      packages: read
+    services:
+      redis:
+        image: redis:7-alpine
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      # -- For pushes: pull the published image by digest ------
+      - name: Log in to GHCR
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Pull published image
+        if: github.event_name != 'pull_request'
+        env:
+          IMAGE_NAME_LC: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+        run: |
+          IMAGE="$(echo "$IMAGE_NAME_LC" | tr '[:upper:]' '[:lower:]')@${{ needs.build-and-push.outputs.image-digest }}"
+          docker pull "$IMAGE"
+          docker tag "$IMAGE" horde-model-reference:validate
+          echo "Pulled $IMAGE"
+
+      # -- For PRs: rebuild from GHA cache ---------------------
+      - name: Checkout
+        if: github.event_name == 'pull_request'
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        if: github.event_name == 'pull_request'
+        uses: docker/setup-buildx-action@v3
+
+      - name: Rebuild from cache for validation
+        if: github.event_name == 'pull_request'
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          load: true
+          tags: horde-model-reference:validate
+          build-args: EXTRA_DEPS=redis
+          cache-from: type=gha
+
+      # -- Variant 1: Single-worker PRIMARY --------------------
+      - name: Start single-worker PRIMARY container
+        run: |
+          docker run -d --name hmr-validate-single \
+            --network host \
+            -e HORDE_MODEL_REFERENCE_REPLICATE_MODE=PRIMARY \
+            -e HORDE_MODEL_REFERENCE_MAKE_FOLDERS=true \
+            -e HORDE_MODEL_REFERENCE_GITHUB_SEED_ENABLED=true \
+            -e HORDE_MODEL_REFERENCE_CANONICAL_FORMAT=v2 \
+            -e OTEL_SDK_DISABLED=true \
+            horde-model-reference:validate
+
+      - name: Wait for single-worker PRIMARY heartbeat
+        run: |
+          timeout=90
+          while ! curl -sf http://localhost:19800/api/heartbeat > /dev/null 2>&1; do
+            timeout=$((timeout - 2))
+            if [ "$timeout" -le 0 ]; then
+              echo "::error::Single-worker PRIMARY failed heartbeat within timeout"
+              docker logs hmr-validate-single
+              exit 1
+            fi
+            sleep 2
+          done
+          echo "Single-worker PRIMARY: heartbeat OK"
+
+      - name: Assert single-worker PRIMARY mode response
+        run: |
+          response=$(curl -sf http://localhost:19800/api/replicate_mode)
+          echo "replicate_mode response: $response"
+          echo "$response" | python3 -c "
+          import json, sys
+          d = json.load(sys.stdin)
+          assert d.get('replicate_mode') == 'PRIMARY', f'Expected PRIMARY, got: {d}'
+          assert d.get('writable') is True, f'Expected writable=true, got: {d}'
+          print('PASS: replicate_mode=PRIMARY, writable=true')
+          "
+
+      - name: Stop single-worker container
+        run: docker stop hmr-validate-single && docker rm hmr-validate-single
+
+      # -- Variant 2: Multi-worker PRIMARY + Redis -------------
+      - name: Start multi-worker PRIMARY container (2 workers + Redis)
+        run: |
+          docker run -d --name hmr-validate-multi \
+            --network host \
+            -e HORDE_MODEL_REFERENCE_REPLICATE_MODE=PRIMARY \
+            -e HORDE_MODEL_REFERENCE_MAKE_FOLDERS=true \
+            -e HORDE_MODEL_REFERENCE_GITHUB_SEED_ENABLED=true \
+            -e HORDE_MODEL_REFERENCE_CANONICAL_FORMAT=v2 \
+            -e HORDE_MODEL_REFERENCE_REDIS__USE_REDIS=true \
+            -e HORDE_MODEL_REFERENCE_REDIS__URL=redis://localhost:6379/0 \
+            -e HORDE_MODEL_REFERENCE_REDIS__USE_PUBSUB=true \
+            -e OTEL_SDK_DISABLED=true \
+            horde-model-reference:validate \
+            /app/.venv/bin/python -m uvicorn \
+              horde_model_reference.service.app:app \
+              --host 0.0.0.0 --port 19800 --workers 2
+
+      - name: Wait for multi-worker PRIMARY heartbeat
+        run: |
+          timeout=90
+          while ! curl -sf http://localhost:19800/api/heartbeat > /dev/null 2>&1; do
+            timeout=$((timeout - 2))
+            if [ "$timeout" -le 0 ]; then
+              echo "::error::Multi-worker PRIMARY failed heartbeat within timeout"
+              docker logs hmr-validate-multi
+              exit 1
+            fi
+            sleep 2
+          done
+          echo "Multi-worker PRIMARY: heartbeat OK"
+
+      - name: Assert multi-worker PRIMARY mode response
+        run: |
+          response=$(curl -sf http://localhost:19800/api/replicate_mode)
+          echo "replicate_mode response: $response"
+          echo "$response" | python3 -c "
+          import json, sys
+          d = json.load(sys.stdin)
+          assert d.get('replicate_mode') == 'PRIMARY', f'Expected PRIMARY, got: {d}'
+          assert d.get('writable') is True, f'Expected writable=true, got: {d}'
+          print('PASS: replicate_mode=PRIMARY, writable=true (multi-worker + Redis)')
+          "
+
+      - name: Stop multi-worker container
+        run: docker stop hmr-validate-multi && docker rm hmr-validate-multi
+
+      # -- Always dump logs on failure -------------------------
+      - name: Dump container logs on failure
+        if: failure()
+        run: |
+          docker logs hmr-validate-single 2>&1 || true
+          docker logs hmr-validate-multi 2>&1 || true

{horde_model_reference-3.0.0 → horde_model_reference-4.0.0}/.github/workflows/docker-validation.yml

@@ -9,10 +9,10 @@ on:
     branches:
       - main
     paths:
-      - 'Dockerfile'
-      - 'docker-compose*.yml'
-      - '.dockerignore'
-      - '.github/workflows/docker-validation.yml'
+      - "Dockerfile"
+      - "docker-compose*.yml"
+      - ".dockerignore"
+      - ".github/workflows/docker-validation.yml"
 
 permissions:
   security-events: write
@@ -253,11 +253,11 @@ jobs:
       - name: Run Trivy vulnerability scanner on Dockerfile
         uses: aquasecurity/trivy-action@0.35.0
         with:
-          scan-type: 'config'
-          scan-ref: 'Dockerfile'
-          format: 'sarif'
-          output: 'trivy-dockerfile-results.sarif'
-          severity: 'CRITICAL,HIGH'
+          scan-type: "config"
+          scan-ref: "Dockerfile"
+          format: "sarif"
+          output: "trivy-dockerfile-results.sarif"
+          severity: "CRITICAL,HIGH"
 
       - name: Upload Trivy SARIF results
         if: always()
@@ -289,11 +289,11 @@ jobs:
       - name: Run Trivy vulnerability scanner on image
         uses: aquasecurity/trivy-action@0.35.0
         with:
-          scan-type: 'image'
-          image-ref: 'horde-model-reference:scan'
-          format: 'sarif'
-          output: 'trivy-image-results.sarif'
-          severity: 'CRITICAL,HIGH'
+          scan-type: "image"
+          image-ref: "horde-model-reference:scan"
+          format: "sarif"
+          output: "trivy-image-results.sarif"
+          severity: "CRITICAL,HIGH"
 
       - name: Upload Trivy image SARIF results
         if: always()

horde_model_reference-4.0.0/.github/workflows/docs.yml

@@ -0,0 +1,66 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - main
+      - service
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "**.md"
+      - "docs/**"
+      - "mkdocs.yml"
+      - "src/**"
+      - "pyproject.toml"
+      - "uv.lock"
+      - ".github/workflows/docs.yml"
+
+jobs:
+  build:
+    name: MkDocs strict build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.0.0
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --locked --all-extras --group docs
+
+      # --strict fails the build on broken internal links and missing nav
+      # targets within the MkDocs site.
+      - name: Build docs (strict)
+        run: uv run mkdocs build --strict
+
+  link-check:
+    name: Markdown link check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      # We need to initialize the submodules to get the markdown files for link checking.
+      - name: Initialize submodules
+        run: git submodule update --init --recursive
+
+      # README and other root markdown live outside the MkDocs site, so the
+      # strict build above does not cover them. lychee in --offline mode
+      # validates relative/local links (catching README -> file drift) without
+      # hitting the network, so external-URL flakiness can't fail CI.
+      - name: Check relative links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >-
+            --offline
+            --no-progress
+            "README.md"
+            "CONTRIBUTING.md"
+            "DEPLOYMENT.md"
+            "./docs/**/*.md"
+            "./examples/**/*.md"
+          fail: true

{horde_model_reference-3.0.0 → horde_model_reference-4.0.0}/.github/workflows/lint.yml

@@ -9,11 +9,11 @@ on:
     branches:
       - main
     paths:
-      - '**.py'
-      - 'pyproject.toml'
-      - 'uv.lock'
-      - '.github/workflows/lint.yml'
-      - '.pre-commit-config.yaml'
+      - "**.py"
+      - "pyproject.toml"
+      - "uv.lock"
+      - ".github/workflows/lint.yml"
+      - ".pre-commit-config.yaml"
 
 jobs:
   pre-commit:
@@ -32,7 +32,7 @@ jobs:
         run: uv sync --locked --all-extras --dev
 
       - name: Run pre-commit
-        run: SKIP=mypy uv run pre-commit run --all-files --show-diff-on-failure
+        run: SKIP=pyrefly-check uv run pre-commit run --all-files --show-diff-on-failure
 
   lint:
     name: Lint (Ruff lint)
@@ -71,7 +71,7 @@ jobs:
         run: uv run ruff format .
 
   type-check:
-    name: Type Check (mypy)
+    name: Type Check (pyrefly)
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -90,5 +90,5 @@ jobs:
       - name: Install dependencies
         run: uv sync --locked --all-extras --dev
 
-      - name: Run mypy
-        run: uv run mypy src/
+      - name: Run pyrefly
+        run: uv run pyrefly check src/ tests/

{horde_model_reference-3.0.0 → horde_model_reference-4.0.0}/.github/workflows/maintests.yml

@@ -5,14 +5,14 @@ on:
     branches:
       - main
     paths:
-      - '**.py'
-      - '**.md'
-      - '**.json'
-      - '.github/workflows/maintests.yml'
-      - '.github/workflows/prtests.yml'
-      - '.github/workflows/release.yml'
-      - 'uv.lock'
-      - 'pyproject.toml'
+      - "**.py"
+      - "**.md"
+      - "**.json"
+      - ".github/workflows/maintests.yml"
+      - ".github/workflows/prtests.yml"
+      - ".github/workflows/release.yml"
+      - "uv.lock"
+      - "pyproject.toml"
 jobs:
   no_extra_fields:
     env:
@@ -68,7 +68,6 @@ jobs:
       - name: Check that query fields have not drifted
         run: uv run python scripts/verify_query_fields.py
 
-
   build:
     env:
       AIWORKER_CACHE_HOME: ${{ github.workspace }}/.cache
@@ -92,6 +91,5 @@ jobs:
       - name: Install the project
         run: uv sync --locked --all-extras --dev
 
-
       - name: Run tests
         run: uv run pytest tests -m "not integration"

{horde_model_reference-3.0.0 → horde_model_reference-4.0.0}/.github/workflows/prtests.yml

@@ -8,14 +8,14 @@ on:
       - opened
       - synchronize
     paths:
-      - '**.py'
-      - '**.md'
-      - '**.json'
-      - '.github/workflows/maintests.yml'
-      - '.github/workflows/prtests.yml'
-      - '.github/workflows/release.yml'
-      - 'uv.lock'
-      - 'pyproject.toml'
+      - "**.py"
+      - "**.md"
+      - "**.json"
+      - ".github/workflows/maintests.yml"
+      - ".github/workflows/prtests.yml"
+      - ".github/workflows/release.yml"
+      - "uv.lock"
+      - "pyproject.toml"
 jobs:
   no_extra_fields:
     env:

horde_model_reference-4.0.0/.github/workflows/release.yml

@@ -0,0 +1,82 @@
+name: horde_model_reference build and publish
+
+on:
+  push:
+    branches:
+      - releases
+
+jobs:
+  build-n-publish:
+    name: horde_model_reference build and publish
+    runs-on: ubuntu-latest
+
+    environment: # see https://github.com/pypa/gh-action-pypi-publish/tree/release/v1/
+      name: pypi
+      url: https://pypi.org/p/horde-model-reference/
+
+    permissions:
+      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
+      contents: write
+      pull-requests: read
+
+    steps:
+      - name: "📣 Release on push"
+        id: release
+        uses: rymndhng/release-on-push-action@v0.28.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          bump_version_scheme: patch
+          use_github_release_notes: true
+
+      - name: "✔️ Checkout"
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      # Pass the version number in an env var to the below steps
+      - name: Set build version env var
+        run: echo "SETUPTOOLS_SCM_PRETEND_VERSION=${{ steps.release.outputs.version }}" >> $GITHUB_ENV
+
+      # We need python...
+      - name: "🐍 Set up Python 3.10"
+        if: ${{ steps.release.outputs.version != '' }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      # Install build deps
+      - name: "🛠 Install pypa/build"
+        if: ${{ steps.release.outputs.version != '' }}
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+
+      # Build a pypi distribution using the env var version number
+      - name: "🔧 Build a binary wheel and a source tarball"
+        if: ${{ steps.release.outputs.version != '' }}
+        run: >-
+          python -m build --sdist --wheel --outdir dist/ .
+
+      # # Publish the package
+      - name: "📦 Publish distribution to PyPI"
+        if: ${{ steps.release.outputs.version != '' }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+    # # Update the badges (maybe, if we're lucky)
+    # - name: "📦 Refresh pypi badge cache"
+    #   run: >-
+    #     curl -X PURGE
+    #     url_here
+
+    # - name: "📦 Refresh downloads badge cache"
+    #   run: >-
+    #     curl -X PURGE
+    #     url_here
+
+    # - name: "Inform with Discord Webhook"
+    #   if: ${{ steps.release.outputs.version != '' }}
+    #   uses: tsickert/discord-webhook@v5.3.0
+    #   with:
+    #     webhook-url: ${{ secrets.DISCORD_WEBHOOK_URL }}
+    #     content: "New version of horde_model_reference has been published to pypi: ${{ steps.release.outputs.version }}."