[Web] `onnxruntime-node` post-install script errors with: "Failed to find runtimes/win-x64/native/libonnxruntime_providers_cuda.so in NuGet package"

[rotemdan]

Describe the issue

Running:

npm install onnxruntime-node

on Linux or WSL2 (also reported on Debian 12), where CUDA Toolkit and cuDNN are available, causes the CUDA EP binaries to be downloaded during the post-install script.

After the binaries seem to be downloaded it errors with:

npm verbose pkgid onnxruntime-node@1.22.0
npm error code 1
npm error path /home/x/test111/node_modules/onnxruntime-node
npm error command failed
npm error command sh -c node ./script/install
npm error Downloading https://api.nuget.org/v3-flatcontainer/microsoft.ml.onnxruntime.gpu.linux/1.22.0/microsoft.ml.onnxruntime.gpu.linux.1.22.0.nupkg
npm error /home/x/test111/node_modules/onnxruntime-node/script/install-utils.js:176
npm error               throw new Error(`Failed to find ${pathInPackage} in NuGet package`);
npm error                     ^
npm error
npm error Error: Failed to find runtimes/win-x64/native/libonnxruntime_providers_cuda.so in NuGet package
npm error     at Object.download (/home/x/test111/node_modules/onnxruntime-node/script/install-utils.js:176:21)
npm error     at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
npm error     at async installPackages (/home/x/test111/node_modules/onnxruntime-node/script/install-utils.js:107:5)
npm error
npm error Node.js v22.14.0

The errors mentions win-x64 which doesn't look right because it's not the correct platform.

To reproduce

npm install onnxruntime-node

on Linux or WSL2, with CUDA toolkit and cuDNN globally available

Urgency

It potentially causes installation failure when installing any package or application that depends on onnxruntime-node, on Linux.

Workaround

ONNXRUNTIME_NODE_INSTALL=skip npm install onnxruntime-node

Can bypass the issue by preventing the post-install script to try to download the extra files.

ONNX Runtime Installation

Released Package

ONNX Runtime Version or Commit ID

v1.22.0

Execution Provider

Other / Unknown

[rotemdan]

Possible cause: In

onnxruntime/js/node/script/install-metadata.js

Line 19 in 9681fe6

manifests: {

The manifests for Linux packages, seem to point to win-x64 paths:

  // Each manifest defines a list of files to install
  manifests: {
    'linux/x64:cuda12': {
      './libonnxruntime_providers_cuda.so': {
        package: 'nuget:linux/x64:cuda12',
        path: 'runtimes/win-x64/native/libonnxruntime_providers_cuda.so',
      },
      './libonnxruntime_providers_shared.so': {
        package: 'nuget:linux/x64:cuda12',
        path: 'runtimes/win-x64/native/libonnxruntime_providers_shared.so',
      },
      './libonnxruntime_providers_tensorrt.so': {
        package: 'nuget:linux/x64:cuda12',
        path: 'runtimes/win-x64/native/libonnxruntime_providers_tensorrt.so',
      },
    },
  },

This file was introduced and last updated on April 16 2025, so the issue likely occurred since the transition to NuGet was made.

[fs-eire]

Thank you for helping investigating the cause. I can work on a fix to it.

[namdoel1412]

I got that error too while I'm installing onnxruntime-node on Linux environment

[fs-eire]

Made PR #24814 to fix this problem.

Once it's merged will start publishing a dev version.

[noaoh]

+1 in seeing the resolution for this

[fs-eire]

published onnxruntime-node@1.23.0-dev.20250522-ad7b0e368d including this fix.

[noaoh]

@fs-eire Is there a timeline for when the dev version gets promoted to an official release?

[fs-eire]

ONNX Runtime usually releases every 3 months. It’s expected to release the next version in early August

[fs-eire]

ONNX Runtime usually releases every 3 months. It’s expected to release the next version in early August

It's going to be quite a while before the next release. So I published a revision of 1.22.0:

onnxruntime-node@1.22.0-rev