quasarr 2.4.8__tar.gz → 2.4.10__tar.gz

{quasarr-2.4.8 → quasarr-2.4.10}/.github/workflows/HostnameRedaction.yml

@@ -4,7 +4,7 @@ on:
   issues:
     types: [ opened, edited ]
   pull_request:
-    types: [ opened, edited ]
+    types: [ opened, closed, reopened, synchronize, edited ]
   issue_comment:
     types: [ created, edited ]
   pull_request_review_comment:

quasarr-2.4.10/.github/workflows/PullRequests.yml

@@ -0,0 +1,334 @@
+name: CI/CD & Beta Build
+
+on:
+  workflow_dispatch:
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  GHCR_ENDPOINT: "ghcr.io/rix1337/quasarr"
+  DESCRIPTION: "Quasarr connects JDownloader with Radarr, Sonarr and LazyLibrarian."
+
+jobs:
+  quality-check:
+    name: Check & Auto-Fix
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      actions: write
+    outputs:
+      changes_pushed: ${{ steps.manager.outputs.changes_pushed }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name || github.repository }}
+          ref: ${{ github.head_ref || github.ref_name }}
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      # We just install python here so uv run has something to target
+      - run: uv python install 3.12
+
+      - name: Run Maintenance
+        id: manager
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          TARGET_REF: ${{ github.head_ref || github.ref_name }}
+          GITHUB_REPO: ${{ github.repository }}
+          WORKFLOW_NAME: ${{ github.workflow }}
+        run: |
+          uv run maintenance.py --ci
+
+  version:
+    needs: [ quality-check ]
+    if: needs.quality-check.outputs.changes_pushed != 'true' && (github.head_ref || github.ref_name) == 'dev'
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - id: version
+        run: echo "version=$(uv run python quasarr/providers/version.py)" >> $GITHUB_OUTPUT
+
+  build-wheel:
+    needs: [ quality-check, version ]
+    if: needs.quality-check.outputs.changes_pushed != 'true' && (github.head_ref || github.ref_name) == 'dev'
+    runs-on: ubuntu-latest
+    outputs:
+      attestation-id: ${{ steps.attest.outputs.attestation-id }}
+    permissions:
+      contents: read
+      id-token: write
+      attestations: write
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv build
+      - id: attest
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-path: "dist/*.whl"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel
+          path: ./dist/*
+
+  build-exe:
+    needs: [ quality-check, version ]
+    if: needs.quality-check.outputs.changes_pushed != 'true' && (github.head_ref || github.ref_name) == 'dev'
+    runs-on: windows-latest
+    env:
+      TMP: "D:\\a\\temp"
+      TEMP: "D:\\a\\temp"
+    steps:
+      - run: mkdir D:\a\temp -Force
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-suffix: "win-build" # Isolate this cache from Linux builds if you share keys
+
+      # --- CACHE ---
+      - name: Cache PyInstaller Analysis
+        uses: actions/cache@v4
+        with:
+          path: |
+            build
+            ~\AppData\Local\pyinstaller
+          # Invalidates cache only if dependencies (uv.lock) change
+          key: pyinstaller-analysis-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+          restore-keys: |
+            pyinstaller-analysis-${{ runner.os }}-
+
+      - shell: powershell
+        run: Set-MpPreference -DisableRealtimeMonitoring $true
+
+      - run: uv sync --group build
+
+      # --- BUILD COMMAND ---
+      - run: |
+          uv run python -c "from PIL import Image; Image.open('Quasarr.png').save('Quasarr.ico')"
+          uv run python quasarr/providers/version.py --create-version-file
+          # 1. Removed '--clean'
+          # 2. Added '--workpath "build"' (Matches the cached path above)
+          # 3. Added '--distpath "dist"' (Explicit output folder)
+          uv run pyinstaller --onefile -y --version-file "file_version_info.txt" --workpath "build" --distpath "dist" --icon "Quasarr.ico" "Quasarr.py" -n "quasarr-${{ needs.version.outputs.version }}-standalone-win64"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: exe-amd64
+          path: ./dist/*.exe
+
+  beta-release:
+    needs: [ version, build-wheel, build-exe ]
+    runs-on: ubuntu-latest
+    permissions: { contents: write }
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheel
+          path: ./wheel
+      - uses: actions/download-artifact@v4
+        with:
+          name: exe-amd64
+          path: ./exe-amd64
+      - id: changelog
+        uses: metcalfc/changelog-generator@v4.6.2
+        with:
+          myToken: ${{ secrets.GITHUB_TOKEN }}
+      - name: Create Release Body
+        run: |
+          echo "### Docker:" > release_body.md
+          echo "\`docker pull ${{ env.GHCR_ENDPOINT }}:beta\`" >> release_body.md
+          echo "### Python:" >> release_body.md
+          echo "\`uv tool upgrade quasarr\`" >> release_body.md
+          echo "### Changelog:" >> release_body.md
+          echo "${{ steps.changelog.outputs.changelog }}" >> release_body.md
+          echo "[Attestation](https://github.com/${{ github.repository }}/attestations/${{ needs.build-wheel.outputs.attestation-id }})" >> release_body.md
+      - uses: ncipollo/release-action@v1
+        with:
+          artifacts: "./wheel/*.whl,./exe-amd64/*.exe"
+          allowUpdates: true
+          removeArtifacts: true
+          replacesArtifacts: true
+          tag: beta
+          name: Beta Build
+          bodyFile: "release_body.md"
+          prerelease: true
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  build-docker-amd64:
+    needs: [ quality-check, version, build-wheel ]
+    if: needs.quality-check.outputs.changes_pushed != 'true' && (github.head_ref || github.ref_name) == 'dev'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheel
+          path: ./docker/dist
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/build-push-action@v6
+        with:
+          context: ./docker
+          platforms: linux/amd64
+          push: true
+          provenance: false
+          sbom: false
+          annotations: org.opencontainers.image.description=${{ env.DESCRIPTION }}
+          tags: |
+            ${{ env.GHCR_ENDPOINT }}:beta-amd64
+            ${{ env.GHCR_ENDPOINT }}:${{ needs.version.outputs.version }}-beta-amd64
+          build-args: VS=${{ needs.version.outputs.version }}
+          cache-from: type=gha,scope=beta-amd64
+          cache-to: type=gha,mode=max,scope=beta-amd64
+
+  build-docker-arm64:
+    needs: [ quality-check, version, build-wheel ]
+    if: needs.quality-check.outputs.changes_pushed != 'true' && (github.head_ref || github.ref_name) == 'dev'
+    runs-on: ubuntu-24.04-arm
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheel
+          path: ./docker/dist
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/build-push-action@v6
+        with:
+          context: ./docker
+          platforms: linux/arm64
+          push: true
+          provenance: false
+          sbom: false
+          annotations: org.opencontainers.image.description=${{ env.DESCRIPTION }}
+          tags: |
+            ${{ env.GHCR_ENDPOINT }}:beta-arm64
+            ${{ env.GHCR_ENDPOINT }}:${{ needs.version.outputs.version }}-beta-arm64
+          build-args: VS=${{ needs.version.outputs.version }}
+          cache-from: type=gha,scope=beta-arm64
+          cache-to: type=gha,mode=max,scope=beta-arm64
+
+  merge-docker-manifest:
+    needs: [ version, build-docker-amd64, build-docker-arm64 ]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - run: |
+          TAG_AMD64="${{ needs.version.outputs.version }}-beta-amd64"
+          TAG_ARM64="${{ needs.version.outputs.version }}-beta-arm64"
+          ANNOTATION="index:org.opencontainers.image.description=$DESCRIPTION"
+          
+          docker buildx imagetools create -t ${{ env.GHCR_ENDPOINT }}:beta \
+            --annotation "$ANNOTATION" \
+            ${{ env.GHCR_ENDPOINT }}:beta-amd64 \
+            ${{ env.GHCR_ENDPOINT }}:beta-arm64
+
+          docker buildx imagetools create -t ${{ env.GHCR_ENDPOINT }}:${{ needs.version.outputs.version }}-beta \
+            --annotation "$ANNOTATION" \
+            ${{ env.GHCR_ENDPOINT }}:${TAG_AMD64} \
+            ${{ env.GHCR_ENDPOINT }}:${TAG_ARM64}
+
+  notify:
+    name: Notify Discord & PR
+    needs: [ quality-check, version, beta-release, merge-docker-manifest ]
+    # Only run if the build wasn't skipped by the auto-fixer and the release succeeded
+    if: needs.quality-check.outputs.changes_pushed != 'true' && needs.beta-release.result == 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write # Required to comment on the PR
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Send Notifications
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
+          VERSION: ${{ needs.version.outputs.version }}
+          REPO: ${{ github.repository }}
+        run: |
+          echo "Fetching release details..."
+          # Get the body of the release we just created (beta tag)
+          RELEASE_BODY=$(gh release view beta --json body --jq .body)
+          
+          # --- 1. DISCORD NOTIFICATION ---
+          if [ -n "$DISCORD_WEBHOOK" ]; then
+            echo "Sending Discord Webhook..."
+          
+            # Construct a JSON payload safely using jq (handles escaping quotes/newlines)
+            # We create a simple embed with the version and the release body
+            jq -n \
+              --arg title "🚀 New Beta Build: $VERSION" \
+              --arg desc "$RELEASE_BODY" \
+              --arg url "https://github.com/$REPO/releases/tag/beta" \
+              '{content: null, embeds: [{title: $title, description: $desc, url: $url, color: 5814783}]}' \
+              > discord_payload.json
+          
+            curl -H "Content-Type: application/json" \
+                 -d @discord_payload.json \
+                 "$DISCORD_WEBHOOK"
+          else
+            echo "::warning::Skipping Discord notification (DISCORD_WEBHOOK secret not set)"
+          fi
+          
+          # --- 2. PR COMMENT FALLBACK ---
+          # Find the PR associated with the commit that triggered this push
+          echo "Looking for associated PR..."
+          PR_NUMBER=$(gh pr list --search "${{ github.sha }}" --state merged --json number --jq '.[0].number')
+          
+          if [ -n "$PR_NUMBER" ]; then
+            echo "Found PR #$PR_NUMBER. Posting comment..."
+          
+            echo "## 🚀 Beta Release $VERSION is Live!" > pr_comment.md
+            echo "" >> pr_comment.md
+            echo "$RELEASE_BODY" >> pr_comment.md
+            echo "" >> pr_comment.md
+            echo "[View Release on GitHub](https://github.com/$REPO/releases/tag/beta)" >> pr_comment.md
+          
+            gh pr comment "$PR_NUMBER" --body-file pr_comment.md
+          else
+            echo "No merged PR found for commit ${{ github.sha }}. Skipping PR comment."
+          fi

{quasarr-2.4.8 → quasarr-2.4.10}/.github/workflows/Release.yml

@@ -34,7 +34,6 @@ jobs:
         uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-          cache-dependency-glob: "pyproject.toml"
       - name: Get Version
         id: version
         run: |
@@ -58,7 +57,6 @@ jobs:
         uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-          cache-dependency-glob: "pyproject.toml"
       - name: Build wheel
         run: uv build
       - name: Generate artifact attestation
@@ -76,21 +74,33 @@ jobs:
     runs-on: windows-latest
     needs: version
     env:
-      TMP: D:\a\temp
-      TEMP: D:\a\temp
+      # We define a consistent build path to make caching reliable
+      BUILD_PATH: "build"
     steps:
-      - name: Create Temp Dir
-        run: mkdir D:\a\temp -Force
       - uses: actions/checkout@v6
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
 
+      # 1. Install uv with its own persistent cache
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-          cache-dependency-glob: "pyproject.toml"
+          cache-suffix: "win-build"
+
+      # 2. PyInstaller Caching
+      # We cache the local 'build' folder AND the global PyInstaller cache.
+      # The key invalidates if 'uv.lock' changes, forcing a re-analysis only when deps update.
+      - name: Cache PyInstaller Analysis
+        uses: actions/cache@v4
+        with:
+          path: |
+            build
+            ~\AppData\Local\pyinstaller
+          key: pyinstaller-analysis-${{ runner.os }}-${{ hashFiles('uv.lock') }}
+          restore-keys: |
+            pyinstaller-analysis-${{ runner.os }}-
 
       - name: Disable Windows Defender
         shell: powershell
@@ -101,10 +111,14 @@ jobs:
           uv sync --group build
 
       - name: Build exe
+        # CHANGES:
+        # 1. Removed '--clean' (Critical for speed)
+        # 2. Added '--workpath' to point to our cached folder
+        # 3. Added '--distpath' explicitly
         run: |
           uv run python -c "from PIL import Image; Image.open('Quasarr.png').save('Quasarr.ico')"
           uv run python quasarr/providers/version.py --create-version-file
-          uv run pyinstaller --clean --onefile -y --version-file "file_version_info.txt" --icon "Quasarr.ico" "Quasarr.py" -n "quasarr-${{ needs.version.outputs.version }}-standalone-win64"
+          uv run pyinstaller --onefile -y --version-file "file_version_info.txt" --workpath "build" --distpath "dist" --icon "Quasarr.ico" "Quasarr.py" -n "quasarr-${{ needs.version.outputs.version }}-standalone-win64"
 
       - uses: actions/upload-artifact@v4
         with:
@@ -252,7 +266,6 @@ jobs:
         uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-          cache-dependency-glob: "pyproject.toml"
 
       - name: Publish to PyPI
         if: ${{ !inputs.skip_pypi }}
@@ -273,7 +286,11 @@ jobs:
           fi
       - name: Create Release Body
         run: |
-          echo "### Install / Update:" > release_body.md
+          echo "### Docker:" > release_body.md
+          echo "" >> release_body.md
+          echo "\`docker pull ${{ env.GHCR_ENDPOINT }}:latest\`" >> release_body.md
+          echo "" >> release_body.md
+          echo "### Python:" >> release_body.md
           echo "" >> release_body.md
           echo "\`uv tool upgrade quasarr\`" >> release_body.md
           echo "" >> release_body.md
@@ -282,8 +299,6 @@ jobs:
           echo "${{ steps.changelog.outputs.changelog }}" >> release_body.md
           echo "" >> release_body.md
           echo "[Attestation](https://github.com/${{ github.repository }}/attestations/${{ needs.build-wheel.outputs.attestation-id }})" >> release_body.md
-          echo "" >> release_body.md
-          echo "\`docker pull ${{ env.GHCR_ENDPOINT }}:latest\`" >> release_body.md
 
       - name: Create Release
         uses: ncipollo/release-action@v1
@@ -292,3 +307,44 @@ jobs:
           artifactErrorsFailBuild: true
           bodyFile: "release_body.md"
           tag: v.${{ needs.version.outputs.version }}
+
+  notify:
+    name: Notify Discord
+    needs: [ version, release, merge-docker-manifest ]
+    if: always() && needs.release.result == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Send Discord Webhook
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
+          VERSION: ${{ needs.version.outputs.version }}
+          REPO: ${{ github.repository }}
+        run: |
+          # Use the exact tag format defined in the release job (v.X.X.X)
+          TAG="v.$VERSION"
+          echo "Fetching release details for $TAG..."
+          
+          # Fetch the body from the release we just created
+          RELEASE_BODY=$(gh release view "$TAG" --json body --jq .body)
+          
+          if [ -n "$DISCORD_WEBHOOK" ]; then
+            echo "Sending notification..."
+          
+            # Construct JSON payload using jq
+            # Color 5763719 is 'Green'
+            jq -n \
+              --arg title "🚀 New Release: $TAG" \
+              --arg desc "$RELEASE_BODY" \
+              --arg url "https://github.com/$REPO/releases/tag/$TAG" \
+              '{content: null, embeds: [{title: $title, description: $desc, url: $url, color: 5763719}]}' \
+              > discord_payload.json
+
+            curl -H "Content-Type: application/json" \
+                 -d @discord_payload.json \
+                 "$DISCORD_WEBHOOK"
+          else
+            echo "::warning::Skipping Discord notification (DISCORD_WEBHOOK secret not set)"
+          fi

{quasarr-2.4.8 → quasarr-2.4.10}/.gitignore

@@ -4,8 +4,7 @@
 *.pyc
 *.bak
 
-# Virtual Environment by uv
-uv.lock
+# Virtual Environment
 .venv
 
 # PyCharm

quasarr-2.4.10/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Development Setup for Pull Requests
+
+To test your changes before submitting a pull request:
+
+**1. Prepare your Environment with `uv`**
+
+Ensure you have the development tools (like `ruff`) installed and your environment synced:
+
+```bash
+uv sync --group dev
+```
+
+**2. Run Quasarr with the `--internal_address` parameter**
+
+```bash
+uv run Quasarr.py --internal_address=http://<host-ip>:<port>
+```
+
+Replace `<host-ip>` and `<port>` with the scheme, IP, and port of your host machine.
+The `--internal_address` parameter is **mandatory**.
+
+**3. Start the required services using the `dev-services-compose.yml` file**
+
+```bash
+CONFIG_VOLUMES=/path/to/config docker-compose -f docker/dev-services-compose.yml up
+```
+
+Replace `/path/to/config` with your desired configuration location.
+The `CONFIG_VOLUMES` environment variable is **mandatory**.
+
+---
+
+### Code Quality & Maintenance
+
+The CI pipeline enforces strict code styling and import optimization. Please run this commands before pushing your
+changes:
+
+**Format code AND upgrade dependencies:**
+
+```bash
+uv run maintenance.py --upgrade
+```

{quasarr-2.4.8 → quasarr-2.4.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quasarr
-Version: 2.4.8
+Version: 2.4.10
 Summary: Quasarr connects JDownloader with Radarr, Sonarr and LazyLibrarian. It also decrypts links protected by CAPTCHAs.
 Author-email: rix1337 <rix1337@users.noreply.github.com>
 License-File: LICENSE
@@ -11,7 +11,7 @@ Requires-Python: >=3.12
 Requires-Dist: beautifulsoup4>=4.14.3
 Requires-Dist: bottle>=0.13.4
 Requires-Dist: dukpy>=0.5.0
-Requires-Dist: pillow>=12.0.0
+Requires-Dist: pillow>=12.1.0
 Requires-Dist: pycryptodomex>=3.23.0
 Requires-Dist: requests>=2.32.5
 Description-Content-Type: text/markdown
@@ -243,11 +243,12 @@ Most feature requests can be satisfied by:
   [here](https://github.com/rix1337/Quasarr/pulls).
 - **Pull requests are welcome!** Especially for popular hostnames.
     - A short guide to set up required dev services is found
-      in [/docker/dev-setup.md](https://github.com/rix1337/Quasarr/blob/main/docker/dev-setup.md)
+      [here](https://github.com/rix1337/Quasarr/blob/main/CONTRIBUTING.md).
     - Always reach out on Discord before starting work on a new feature to prevent waste of time.
     - Please follow the existing code style and project structure.
     - Anti-bot measures must be circumvented fully by Quasarr. Thus, you will need to provide a working solution for new
       CAPTCHA types by integrating it in the Quasarr Web UI.
+      The simplest CAPTCHA bypass involves creating a Tampermonkey user script.
     - Please provide proof of functionality (screenshots/examples) when submitting your pull request.
 
 # SponsorsHelper

{quasarr-2.4.8 → quasarr-2.4.10}/Quasarr.py

@@ -6,6 +6,6 @@ import multiprocessing
 
 import quasarr
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     multiprocessing.freeze_support()
     quasarr.run()

{quasarr-2.4.8 → quasarr-2.4.10}/README.md

@@ -225,11 +225,12 @@ Most feature requests can be satisfied by:
   [here](https://github.com/rix1337/Quasarr/pulls).
 - **Pull requests are welcome!** Especially for popular hostnames.
     - A short guide to set up required dev services is found
-      in [/docker/dev-setup.md](https://github.com/rix1337/Quasarr/blob/main/docker/dev-setup.md)
+      [here](https://github.com/rix1337/Quasarr/blob/main/CONTRIBUTING.md).
     - Always reach out on Discord before starting work on a new feature to prevent waste of time.
     - Please follow the existing code style and project structure.
     - Anti-bot measures must be circumvented fully by Quasarr. Thus, you will need to provide a working solution for new
       CAPTCHA types by integrating it in the Quasarr Web UI.
+      The simplest CAPTCHA bypass involves creating a Tampermonkey user script.
     - Please provide proof of functionality (screenshots/examples) when submitting your pull request.
 
 # SponsorsHelper

{quasarr-2.4.8 → quasarr-2.4.10}/docker/Dockerfile

@@ -13,13 +13,14 @@ COPY --from=uv /uv /usr/local/bin/uv
 # install local package
 COPY dist/*.whl /tmp/
 
-# Updated: Added cache mount for uv to speed up installation
+# Configure uv to install tools in globally accessible paths
+ENV UV_TOOL_DIR=/opt/uv-tools
+ENV UV_TOOL_BIN_DIR=/usr/local/bin
+
+# The binary will now automatically appear in /usr/local/bin
 RUN --mount=type=cache,target=/root/.cache/uv \
     uv tool install /tmp/*.whl --force && rm /tmp/*.whl
 
-# Ensure the binary is in the PATH
-ENV PATH="/root/.local/bin:$PATH"
-
 # volumes and ports
 VOLUME /config
 EXPOSE 8080