2025-09-10 nightly release (0639492)

Author: pytorchbot

.github/workflows/build_docs.yml

@@ -0,0 +1,80 @@
+name: Docs
+
+on:
+  pull_request:
+  push:
+    branches:
+      - nightly
+      - main
+      - release/*
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        python-version: ["3.11"]
+        cuda-version: ["12.6"]
+        ffmpeg-version: ["7"]
+      fail-fast: false
+    uses: pytorch/test-infra/.github/workflows/linux_job_v2.yml@main
+    permissions:
+      id-token: write
+      contents: read
+    with:
+      runner: linux.4xlarge.nvidia.gpu
+      repository: pytorch/audio
+      gpu-arch-type: cuda
+      gpu-arch-version: ${{ matrix.cuda-version }}
+      timeout: 120
+      job-name: docs
+
+      script: |
+        set -ex
+        # Set up Environment Variables
+        export PYTHON_VERSION="${{ matrix.python-version }}"
+        export FFMPEG_VERSION="${{ matrix.ffmpeg-version }}"
+        export CU_VERSION_WITHOUT_PERIODS="$(echo "${{ matrix.cuda-version }}" | sed 's/\.//g')"
+        export PIP_PROGRESS_BAR=off
+        export CONDA_QUIET=1
+
+        # Set UPLOAD_CHANNEL
+        if [[(${GITHUB_EVENT_NAME} = 'pull_request' && (${GITHUB_BASE_REF} = 'release'*)) || (${GITHUB_REF} = 'refs/heads/release'*) ]]; then
+          export UPLOAD_CHANNEL=test
+        else
+          export UPLOAD_CHANNEL=nightly
+        fi
+
+        echo "::group::Create conda env"
+        # Mark Build Directory Safe
+        git config --global --add safe.directory /__w/audio/audio
+        conda create -c conda-forge --strict-channel-priority -y --prefix ci_env python="${PYTHON_VERSION}" ffmpeg="${FFMPEG_VERSION}" cmake ninja
+        conda activate ./ci_env
+        conda info
+        python -m pip install --upgrade pip
+        echo "::endgroup::"
+
+        echo "::group::Install PyTorch and TorchCodec"
+        PYTORCH_WHEEL_INDEX="https://download.pytorch.org/whl/${UPLOAD_CHANNEL}/cu${CU_VERSION_WITHOUT_PERIODS}"
+        python -m pip install numpy
+        python -m pip install --pre torch torchcodec --index-url="${PYTORCH_WHEEL_INDEX}"
+        python -c 'import torch; print(f"{torch.__version__}"); print(f"{torch.__file__}"); print(f"{torch.cuda.is_available()=}")'
+        echo "::endgroup::"
+
+        echo "::group::Build and install TorchAudio"
+        python -m pip install . -v --no-build-isolation
+        echo "::endgroup::"
+
+        echo "::group::Install TorchAudio documentation build requirements"
+        python -m pip install -r docs/requirements.txt -r docs/requirements-tutorials.txt
+        echo "::endgroup::"
+
+        echo "::group::Build TorchAudio documentation"
+        export BUILD_GALLERY=true
+        (cd docs && make html)
+        echo "::endgroup::"
+
+        echo "::group::Copy artifacts"
+        cp -rf docs/build/html/* "${RUNNER_DOCS_DIR}"
+        mv docs/build/html /artifacts/
+        echo "::endgroup::"

.github/workflows/docs.yaml

@@ -52,13 +52,11 @@ endif()
 
 
 # Options
-option(BUILD_SOX "Build libsox statically" ON)
 option(BUILD_RIR "Enable RIR simulation" ON)
 option(BUILD_RNNT "Enable RNN transducer" ON)
 option(BUILD_ALIGN "Enable forced alignment" ON)
 option(BUILD_CUDA_CTC_DECODER "Build CUCTC decoder" OFF)
 option(BUILD_TORCHAUDIO_PYTHON_EXTENSION "Build Python extension" OFF)
-option(USE_FFMPEG "Enable ffmpeg-based features" OFF)
 option(USE_CUDA "Enable CUDA support" OFF)
 option(USE_ROCM "Enable ROCM support" OFF)
 option(USE_OPENMP "Enable OpenMP support" OFF)
@@ -166,14 +164,6 @@ else()
 endif()
 
 add_subdirectory(src/libtorchaudio)
-if (USE_FFMPEG)
-  if (DEFINED ENV{FFMPEG_ROOT})
-    add_subdirectory(third_party/ffmpeg/single)
-  else()
-    message(STATUS "Building FFmpeg integration with multi version support")
-    add_subdirectory(third_party/ffmpeg/multi)
-  endif()
-endif()
 if (BUILD_CUDA_CTC_DECODER)
   if (NOT USE_CUDA)
     message(FATAL "BUILD_CUDA_CTC_DECODER=1 but USE_CUDA=0.")

CMakeLists.txt

@@ -44,13 +44,7 @@ Please refer to https://pytorch.org/audio/main/build.html
 
 ## Running Test
 
-If you built sox, set the `PATH` variable so that the tests properly use the newly built `sox` binary:
-
-```bash
-export PATH="<path_to_torchaudio>/third_party/install/bin:${PATH}"
-```
-
-The following dependencies are also needed for testing:
+The following dependencies are needed for testing:
 
 ```bash
 pip install typing pytest scipy numpy parameterized

CONTRIBUTING.md

@@ -43,7 +43,6 @@ build:
     - USE_CUDA
     - CUDA_HOME
     - TORCH_CUDA_ARCH_LIST
-    - USE_FFMPEG
     - USE_OPENMP
     - MACOSX_DEPLOYMENT_TARGET
 

packaging/torchaudio/meta.yaml

@@ -87,16 +87,6 @@ elseif (UNIX)
       URL ${base_url}/2023-07-06/linux_x86_64/6.0.tar.gz
       URL_HASH SHA256=04d3916404bab5efadd29f68361b7d13ea71e6242c6473edcb747a41a9fb97a6
       )
-  else ()
-    # Possible case ppc64le (though it's not officially supported.)
-    message(
-      FATAL_ERROR
-      "${CMAKE_SYSTEM_PROCESSOR} is not supported for FFmpeg multi-version integration. "
-      "If you have FFmpeg libraries installed in the system,"
-      " setting FFMPEG_ROOT environment variable to the root directory of FFmpeg installation"
-      " (the directory where `include` and `lib` sub directories with corresponding headers"
-      " and library files are present) will invoke the FFmpeg single-version integration. "
-      "If you do not need the FFmpeg integration, setting USE_FFMPEG=0 will bypass the issue.")
   endif()
 elseif(MSVC)
   FetchContent_Declare(

third_party/ffmpeg/multi/CMakeLists.txt

@@ -34,10 +34,8 @@ def _get_build(var, default=False):
 
 
 _BUILD_CPP_TEST = _get_build("BUILD_CPP_TEST", False)
-_BUILD_SOX = False if platform.system() == "Windows" else _get_build("BUILD_SOX", True)
 _BUILD_RIR = _get_build("BUILD_RIR", True)
 _BUILD_RNNT = _get_build("BUILD_RNNT", True)
-_USE_FFMPEG = _get_build("USE_FFMPEG", True)
 _USE_ROCM = _get_build("USE_ROCM", torch.backends.cuda.is_built() and torch.version.hip is not None)
 _USE_CUDA = _get_build("USE_CUDA", torch.backends.cuda.is_built() and torch.version.hip is None)
 _BUILD_ALIGN = _get_build("BUILD_ALIGN", True)
@@ -102,7 +100,6 @@ def build_extension(self, ext):
             "-DCMAKE_VERBOSE_MAKEFILE=ON",
             f"-DPython_INCLUDE_DIR={distutils.sysconfig.get_python_inc()}",
             f"-DBUILD_CPP_TEST={'ON' if _BUILD_CPP_TEST else 'OFF'}",
-            f"-DBUILD_SOX:BOOL={'ON' if _BUILD_SOX else 'OFF'}",
             f"-DBUILD_RIR:BOOL={'ON' if _BUILD_RIR else 'OFF'}",
             f"-DBUILD_RNNT:BOOL={'ON' if _BUILD_RNNT else 'OFF'}",
             f"-DBUILD_ALIGN:BOOL={'ON' if _BUILD_ALIGN else 'OFF'}",
@@ -112,7 +109,6 @@ def build_extension(self, ext):
             f"-DUSE_ROCM:BOOL={'ON' if _USE_ROCM else 'OFF'}",
             f"-DUSE_CUDA:BOOL={'ON' if _USE_CUDA else 'OFF'}",
             f"-DUSE_OPENMP:BOOL={'ON' if _USE_OPENMP else 'OFF'}",
-            f"-DUSE_FFMPEG:BOOL={'ON' if _USE_FFMPEG else 'OFF'}",
         ]
         build_args = ["--target", "install"]
         # Pass CUDA architecture to cmake