pynetv 0.4.1__tar.gz

pynetv-0.4.1/.dockerignore

@@ -0,0 +1,39 @@
+# Git
+.git/
+.gitignore
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+.ruff_cache/
+.pytest_cache/
+uv.lock
+
+# App data (user-specific)
+cache/
+.cache/
+settings.json
+*.pem
+
+# Tools (not needed in container, except specific scripts)
+tools/
+!tools/install-ffmpeg.sh
+!tools/patches/
+!tools/install-ai_upscale.sh
+!tools/export-tensorrt.py
+
+# Tests
+*_test.py
+conftest.py
+
+# Docs
+*.md
+!README.md
+screenshots/
+LICENSE
+
+# Docker
+Dockerfile
+docker-compose.yml
+.dockerignore

pynetv-0.4.1/.github/actionlint.yaml

@@ -0,0 +1,5 @@
+self-hosted-runner:
+  # GitHub-hosted since 2026-09-17; actionlint v1.7.12 predates them.
+  labels:
+  - ubuntu-26.04
+  - ubuntu-26.04-arm

pynetv-0.4.1/.github/workflows/ai-upscale.yml

@@ -0,0 +1,155 @@
+name: AI Upscale Image
+
+on:
+  # Run manually when an FFmpeg base-image update should be published immediately.
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "Dockerfile.ai_upscale"
+      - "entrypoint-ai_upscale.sh"
+      - "*.py"
+      - "pyproject.toml"
+      - "templates/**"
+      - "static/**"
+      - "tools/**"
+      - ".github/workflows/ai-upscale.yml"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}-ai-upscale
+  DEFAULT_BASE: ubuntu:26.04
+
+jobs:
+  build:
+    runs-on: ubuntu-26.04
+    permissions:
+      contents: read
+      packages: write
+    strategy:
+      # One failing combination must not cancel the others.
+      fail-fast: false
+      matrix:
+        # Mirrors ffmpeg-base.yml: each image builds on the ffmpeg image of the same CUDA and OS.
+        nvidia: ['cuda:12.4', 'cuda:12.6', 'cuda:12.8', 'cuda:13.0']
+        base_image: ['ubuntu:22.04', 'ubuntu:24.04', 'ubuntu:26.04']
+
+    steps:
+      - name: Free disk space
+        run: |
+          # Remove large unnecessary packages to free up space for torch/tensorrt
+          sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache
+          sudo apt-get clean
+          df -h
+
+      - uses: actions/checkout@v7
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v4
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Parse CUDA version
+        id: cuda
+        run: |
+          # Extract "12.4" from "cuda:12.4"
+          CUDA_VER="${{ matrix.nvidia }}"
+          CUDA_VER="${CUDA_VER#cuda:}"
+          echo "version=$CUDA_VER" >> $GITHUB_OUTPUT
+          # "ubuntu:26.04" -> "ubuntu26.04"
+          OS="${{ matrix.base_image }}"
+          echo "os=${OS/:/}" >> $GITHUB_OUTPUT
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=cuda${{ steps.cuda.outputs.version }}-${{ steps.cuda.outputs.os }}
+            type=raw,value=cuda${{ steps.cuda.outputs.version }},enable=${{ matrix.base_image == env.DEFAULT_BASE }}
+            type=raw,value=latest,enable=${{ matrix.base_image == env.DEFAULT_BASE && steps.cuda.outputs.version == '13.0' }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          file: Dockerfile.ai_upscale
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            FFMPEG_IMAGE=ghcr.io/${{ github.repository }}-ffmpeg:cuda${{ steps.cuda.outputs.version }}-${{ steps.cuda.outputs.os }}
+            NVIDIA=${{ matrix.nvidia }}
+            BASE_IMAGE=${{ matrix.base_image }}
+          no-cache: true
+
+      - name: Verify image
+        run: |
+          # Free space: BuildKit uses separate storage, prune it before pulling
+          docker buildx prune -af || true
+          docker system prune -af || true
+          df -h
+          IMG=${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:cuda${{ steps.cuda.outputs.version }}-${{ steps.cuda.outputs.os }}
+          docker pull $IMG
+          # Verify everything that should be enabled is actually linked
+          # Note: --entrypoint bypasses the default entrypoint which tries to build TensorRT engines (requires GPU)
+          docker run --rm --entrypoint sh "$IMG" -c "
+            echo '=== Verifying AI Upscale build ==='
+            LDD_OUTPUT=\$(ldd /usr/local/bin/ffmpeg)
+
+            # Verify ffmpeg binaries exist
+            for bin in ffmpeg ffprobe ffplay; do
+              test -x /usr/local/bin/\$bin || { echo \"ERROR: \$bin not found\"; exit 1; }
+              echo \"OK: \$bin exists\"
+            done
+
+            # Verify non-NVIDIA dependencies are satisfied
+            # Note: All NVIDIA libraries (libnvinfer, libcuda, libcudart) are loaded via dlopen,
+            # so ffmpeg works even without NVIDIA GPU/drivers installed
+            MISSING=\$(echo \"\$LDD_OUTPUT\" | grep 'not found' | grep -v -E 'libnvinfer|libnvonnxparser|libcudart|libcuda' || true)
+            if [ -n \"\$MISSING\" ]; then
+              echo 'ERROR: Missing non-NVIDIA libraries:'
+              echo \"\$MISSING\"
+              exit 1
+            fi
+            echo 'OK: All non-NVIDIA dependencies satisfied'
+
+            # Verify ffmpeg has NO hard CUDA dependency (all CUDA/TensorRT loaded via dlopen)
+            if echo \"\$LDD_OUTPUT\" | grep -q 'libcudart'; then
+              echo 'ERROR: libcudart linked at compile time (should use dlopen)'
+              exit 1
+            fi
+            echo 'OK: No libcudart dependency (CUDA Driver API via dlopen)'
+            echo 'OK: libnvinfer loaded via dlopen (not in ldd output)'
+
+            # Verify Python AI packages installed (use pip show, not import - import needs CUDA runtime)
+            echo '=== Verifying Python packages ==='
+            pip3 show torch >/dev/null 2>&1 || { echo 'ERROR: torch not installed'; exit 1; }
+            echo 'OK: torch installed'
+            pip3 show onnx >/dev/null 2>&1 || { echo 'ERROR: onnx not installed'; exit 1; }
+            echo 'OK: onnx installed'
+            pip3 show tensorrt >/dev/null 2>&1 || { echo 'ERROR: tensorrt not installed'; exit 1; }
+            echo 'OK: tensorrt installed'
+
+            # Verify AI upscale scripts exist
+            echo '=== Verifying AI upscale scripts ==='
+            test -x /app/tools/install-ai_upscale.sh || { echo 'ERROR: install-ai_upscale.sh not found'; exit 1; }
+            echo 'OK: install-ai_upscale.sh exists'
+            test -f /app/tools/export-tensorrt.py || { echo 'ERROR: export-tensorrt.py not found'; exit 1; }
+            echo 'OK: export-tensorrt.py exists'
+            python3 /app/tools/export-tensorrt.py --list | grep -q '2x-nomosuni-compact' || { echo 'ERROR: Nomos model unavailable'; exit 1; }
+            if python3 /app/tools/export-tensorrt.py --help | grep -q -- '--model'; then
+              echo 'ERROR: Legacy model selection is still available'
+              exit 1
+            fi
+            echo 'OK: Nomos is the sole supported model'
+
+            echo ''
+            echo '=== All verifications passed ==='
+          "

pynetv-0.4.1/.github/workflows/ci.yml

@@ -0,0 +1,109 @@
+name: CI
+
+on:
+  # Run manually when an FFmpeg base-image update should be published immediately.
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      # Only trigger on files used by main Dockerfile
+      - "Dockerfile"
+      - "*.py"
+      - "pyproject.toml"
+      - "uv.lock"
+      - "templates/**"
+      - "static/**"
+      - "entrypoint.sh"
+      - ".github/workflows/ci.yml"
+  pull_request:
+    branches: [main]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+  FFMPEG_IMAGE: ghcr.io/${{ github.repository }}-ffmpeg:latest
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: "3.14.10"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.14.10"
+
+      - name: Install FFmpeg
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes --no-install-recommends ffmpeg
+
+      - name: Install dependencies
+        run: uv sync --frozen --group pre-commit
+
+      - name: Lint with ruff
+        run: uv --quiet run --frozen --group pre-commit ruff check .
+
+      - name: Type check with basedpyright
+        run: uv --quiet run --frozen --group pre-commit basedpyright
+
+      - name: Run tests
+        run: uv --quiet run --frozen --group pre-commit pytest
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Log in to Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v4
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Verify base image exists
+        run: |
+          if ! docker manifest inspect ${{ env.FFMPEG_IMAGE }} > /dev/null 2>&1; then
+            echo "ERROR: Base image ${{ env.FFMPEG_IMAGE }} not found"
+            echo "Run the 'FFmpeg Base Image' workflow first"
+            exit 1
+          fi
+          echo "Base image verified: ${{ env.FFMPEG_IMAGE }}"
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=ref,event=branch
+            type=sha,prefix=
+
+      - name: Build and push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            FFMPEG_IMAGE=${{ env.FFMPEG_IMAGE }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

pynetv-0.4.1/.github/workflows/ffmpeg-base.yml

@@ -0,0 +1,155 @@
+name: FFmpeg Base Image
+
+on:
+  schedule:
+    # Build daily at 3 AM UTC
+    # Application images are rebuilt separately on code changes or manual dispatch.
+    - cron: "0 3 * * *"
+  push:
+    branches: [main]
+    paths:
+      - "Dockerfile.ffmpeg"
+      - "tools/install-ffmpeg.sh"
+      - ".github/workflows/ffmpeg-base.yml"
+  workflow_dispatch:
+    inputs:
+      ffmpeg_version:
+        description: "FFmpeg version (e.g., 7.1 or snapshot)"
+        required: false
+        default: "snapshot"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}-ffmpeg
+  DEFAULT_BASE: ubuntu:26.04
+
+jobs:
+  build:
+    runs-on: ubuntu-26.04
+    permissions:
+      contents: read
+      packages: write
+    strategy:
+      # One failing combination must not cancel the others.
+      fail-fast: false
+      matrix:
+        # Every CUDA on every supported LTS; older CUDA serves older drivers/GPUs.
+        # The newest LTS owns the unsuffixed cudaX.Y and latest tags (see DEFAULT_BASE).
+        nvidia: ['cuda:12.4', 'cuda:12.6', 'cuda:12.8', 'cuda:13.0']
+        base_image: ['ubuntu:22.04', 'ubuntu:24.04', 'ubuntu:26.04']
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v4
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Parse CUDA version
+        id: cuda
+        run: |
+          # Extract "12.4" from "cuda:12.4"
+          CUDA_VER="${{ matrix.nvidia }}"
+          CUDA_VER="${CUDA_VER#cuda:}"
+          echo "version=$CUDA_VER" >> $GITHUB_OUTPUT
+          # "ubuntu:26.04" -> "ubuntu26.04"
+          OS="${{ matrix.base_image }}"
+          echo "os=${OS/:/}" >> $GITHUB_OUTPUT
+
+      - name: Generate build date
+        id: date
+        run: |
+          echo "date=$(date -u +'%Y-%m-%d')" >> $GITHUB_OUTPUT
+          echo "datetime=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_OUTPUT
+
+      - name: Determine FFmpeg version
+        id: version
+        run: |
+          VERSION="${{ github.event.inputs.ffmpeg_version || 'snapshot' }}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          if [ "$VERSION" = "snapshot" ]; then
+            echo "tag=${{ steps.date.outputs.date }}" >> $GITHUB_OUTPUT
+          else
+            echo "tag=$VERSION" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=cuda${{ steps.cuda.outputs.version }}-${{ steps.cuda.outputs.os }}
+            type=raw,value=cuda${{ steps.cuda.outputs.version }},enable=${{ matrix.base_image == env.DEFAULT_BASE }}
+            type=raw,value=latest,enable=${{ matrix.base_image == env.DEFAULT_BASE && steps.cuda.outputs.version == '13.0' }}
+            type=raw,value=${{ steps.date.outputs.date }}-cuda${{ steps.cuda.outputs.version }}-${{ steps.cuda.outputs.os }},enable=${{ steps.version.outputs.version == 'snapshot' }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          file: Dockerfile.ffmpeg
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            BUILD_DATE=${{ steps.date.outputs.datetime }}
+            FFMPEG_VERSION=${{ steps.version.outputs.version }}
+            NVIDIA=${{ matrix.nvidia }}
+            FFMPEG_BASE_IMAGE=${{ matrix.base_image }}
+          no-cache: true
+
+      - name: Verify image
+        run: |
+          IMG=${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:cuda${{ steps.cuda.outputs.version }}-${{ steps.cuda.outputs.os }}
+          docker pull $IMG
+          # Verify ffmpeg build - check binaries and shared library dependencies
+          # Note: Static libraries (libx264, libx265, etc.) are compiled into the binary
+          # and won't appear in ldd output. If they were missing, the build would have failed.
+          docker run --rm $IMG sh -c "
+            echo '=== Verifying ffmpeg build ==='
+
+            # Verify all binaries exist
+            for bin in ffmpeg ffprobe ffplay; do
+              test -x /usr/local/bin/\$bin || { echo \"ERROR: \$bin not found\"; exit 1; }
+              echo \"OK: \$bin exists\"
+            done
+
+            # Get ldd output for shared library checks
+            LDD_OUTPUT=\$(ldd /usr/local/bin/ffmpeg)
+
+            # Verify non-NVIDIA shared dependencies are satisfied
+            MISSING=\$(echo \"\$LDD_OUTPUT\" | grep 'not found' | grep -v -E 'libnvinfer|libnvonnxparser|libcudart|libcuda' || true)
+            if [ -n \"\$MISSING\" ]; then
+              echo 'ERROR: Missing non-NVIDIA libraries:'
+              echo \"\$MISSING\"
+              exit 1
+            fi
+            echo 'OK: All non-NVIDIA shared dependencies satisfied'
+
+            # Verify NVIDIA libraries (all loaded via dlopen - no hard dependencies)
+            # - CUDA Driver API (libcuda): loaded via dlopen when TensorRT backend used
+            # - TensorRT (libnvinfer): loaded via dlopen when TensorRT backend used
+            echo '=== Verifying NVIDIA libraries ==='
+            # Verify ffmpeg has NO hard CUDA dependency
+            if echo \"\$LDD_OUTPUT\" | grep -q 'libcudart'; then
+              echo 'ERROR: libcudart linked at compile time (should use dlopen)'
+              exit 1
+            fi
+            echo 'OK: No libcudart dependency (uses CUDA Driver API via dlopen)'
+            ls /usr/lib/x86_64-linux-gnu/libnvinfer.so* >/dev/null 2>&1 || { echo 'ERROR: TensorRT (libnvinfer) not installed'; exit 1; }
+            echo 'OK: libnvinfer installed (loaded via dlopen)'
+
+            # Verify libva is linked (we build it as shared for runtime)
+            echo \"\$LDD_OUTPUT\" | grep -q libva || { echo 'ERROR: libva not linked'; exit 1; }
+            echo 'OK: libva linked'
+
+            echo ''
+            echo '=== All verifications passed ==='
+          "

pynetv-0.4.1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - name: Build distributions
+        run: uv build
+      - name: Check package metadata
+        run: uvx --from twine twine check --strict dist/*
+      - name: Smoke test installed commands
+        env:
+          NETV_DATA_DIR: ${{ runner.temp }}/netv-data
+        run: |
+          uvx --isolated --from "$PWD"/dist/*.whl netv --help
+          uvx --isolated --from "$PWD"/dist/*.whl netv-gateway --help
+      - uses: actions/upload-artifact@v4
+        with:
+          name: distributions
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pynetv
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

pynetv-0.4.1/.github/workflows/release.yml

@@ -0,0 +1,75 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+  FFMPEG_IMAGE: ghcr.io/${{ github.repository }}-ffmpeg:latest
+
+jobs:
+  release:
+    runs-on: ubuntu-26.04
+    permissions:
+      contents: write
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0  # full history and tags for the changelog
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v4
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=raw,value=latest
+
+      - name: Build and push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            FFMPEG_IMAGE=${{ env.FFMPEG_IMAGE }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Generate release notes
+        id: notes
+        run: |
+          echo "## Docker Image" >> notes.md
+          echo "" >> notes.md
+          echo "Pull the image:" >> notes.md
+          echo "\`\`\`bash" >> notes.md
+          echo "docker pull ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ steps.meta.outputs.version }}" >> notes.md
+          echo "\`\`\`" >> notes.md
+          echo "" >> notes.md
+          echo "## What's Changed" >> notes.md
+          git log $(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || git rev-list --max-parents=0 HEAD)..HEAD --pretty=format:"- %s" | grep -v '^- Release v' >> notes.md || true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          body_path: notes.md
+          generate_release_notes: true

pynetv-0.4.1/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+.ruff_cache/
+.pytest_cache/
+
+# Debugging
+**/*.out
+**/*.log
+
+# App data
+.cache/
+cache/
+
+# Certificates
+*.pem
+/apple/.env
+
+# Tools - user data and generated files
+**/*.gz
+**/*.json
+**/*.m3u
+**/*.xml
+tools/.zap2xml/
+
+# macOS
+.DS_Store
+
+# Local App Store source material
+/apple/AppStoreScreenshots/**/*.pdf
+
+.testmondata
+.codegraph
+.coverage
+.testmondata*
+.codegraph/
+.coverage.*
+.coverage-*