Skip to content

If you don't need CUDA acceleration, you do NOT need to install or configure CUDA, cuDNN, etc.

CUDA is a toolkit from NVIDIA that enables your graphics card to handle more tasks. In this software (pyVideoTrans), to enable CUDA acceleration, you must first install the CUDA environment. This guide will walk you through installing CUDA 12.8 and the corresponding cuDNN 9.11 on Windows 10.

The Windows pre-packaged version is bundled with CUDA 12.8; other versions are untested. cuDNN 9.8 can be installed on Windows 10, but Windows 11 requires cuDNN 9.11 or higher.


Step 1: Check if Your Graphics Card is NVIDIA

  1. Open Device Manager

    • Right-click the "Start" button (the Windows icon) in the bottom-left corner of your desktop.
    • Select "Windows Administrative Tools" > "Computer Management" from the pop-up menu. This will open a window.
  2. Find Graphics Card Information

    • In the Computer Management window, click Device Manager on the left. On the right, find "Display adapters" and click the small arrow in front to expand it.

    • Look for the word "NVIDIA", such as "NVIDIA GeForce GTX 1660".

    • If you see it, congratulations! Your graphics card is NVIDIA, and you can proceed. If not (e.g., it shows "Intel" or "AMD"), then CUDA cannot be used, and this tutorial ends here.


Step 2: Check and Update Your Graphics Driver Version

  1. Open NVIDIA Management Software

    • If you have the graphics driver installed, there might be a green "NVIDIA" icon in the system tray (near the clock) on the bottom-right of your taskbar. Right-click it and select "NVIDIA GeForce Experience" to open it.

    • If not, skip to step 3 to download manually.

  2. Check Driver Version and Update

    • After opening, click "Drivers" in the top-left corner.
    • It will show the current driver version (e.g., "546.33"). If a newer version is available, there will be a "Download" button.
    • Click "Download" and follow the prompts to install. Restart your computer after installation.
  3. No Software? Download Driver Manually


Step 3: Check for Existing CUDA and Determine Maximum Supported Version

  1. Open Command Prompt (CMD)
    • Press the Windows key + R on your keyboard to open the "Run" dialog.
    • Type cmd and press Enter to open a black command-line window.

  1. Check CUDA Version
    • In the command prompt, type: nvcc -V

Press Enter. If you see something like Cuda compilation tools, release 12.8, V12.8.xxx, it means CUDA is already installed, version 12.8. If you see "not recognized as an internal or external command", it means CUDA is not installed; proceed with installation.

If the version is 11.x, please uninstall it first and then reinstall 12.8.

  1. Check Maximum Supported CUDA Version
    • In the command prompt, type: nvidia-smi

Press Enter. A table will appear. Look at the top-right for "CUDA Version" (e.g., 12.8 or higher). This indicates the highest version your driver supports. As long as it's 12.8 or above, you can install our target CUDA 12.8. If it shows 11.x, your graphics driver is too old; please update it first.


Step 4: Download and Install CUDA 12.8

  1. Download CUDA 12.8
    • Open your browser and go to the NVIDIA download page: https://developer.nvidia.com/cuda-12-8-1-download-archive
    • Select "Windows" > "x86_64" > "10 (or 11 if you are on Windows 11)" > "exe (local)", then click "Download".
    • The filename will be something like cuda_12.8.1_572.61_windows.exe, and it will download to your "Downloads" folder.

  1. Install CUDA (Custom Mode)
    • Double-click the downloaded file. An installation window will pop up. Agree to the license and click Next.

    • Choose "Custom (Advanced)" installation and click "Next".

    • In the options list, only check the first line "CUDA". Uncheck all other options to avoid conflicts.

  • Then, click the + sign in front of CUDA and uncheck Visual Studio Integration, otherwise installation may fail easily.

  • Click "Next" and follow the prompts to complete the installation. The default path is C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8.

  1. What to Do If You Encounter an Error?

    • If the installation is interrupted with a "Not Installed" or "Failed" message, you may have selected the wrong options. Run the installer again, choose Custom installation, ensure only the first line "CUDA" is selected, all others are unchecked, and under CUDA, uncheck Visual Studio Integration.
    • If it still fails, proceed to the next step to install Visual Studio.

Step 5: Install Visual Studio (Skip This Step if CUDA Installation Succeeded)

If you unchecked Visual Studio Integration in the previous step, there should be no error. If an error still occurs, please install Visual Studio as described here.

  1. Download Visual Studio Community Edition

  2. Install C++ Development Environment

    • Double-click the installer. After the window pops up, select "Desktop development with C++".
    • Click "Install". This may take several tens of minutes. Restart your computer after installation.

  1. Reinstall CUDA 12.8
    • Go back to Step 4, run the CUDA installer again, and follow the Custom mode, selecting only "Runtime" for installation. This time it should succeed.

Step 6: Verify CUDA Installation and Configure Environment Variables

  1. Check if Installation Was Successful

    • Open CMD (Windows key + R, type cmd).
    • Type: nvcc -V If it shows Cuda compilation tools, release 12.8, V12.8.xxx, the installation was successful. If it says "not recognized as an internal or external command", you need to add environment variables.
  2. Add CUDA to Environment Variables (Usually set automatically; if not, add manually)

    • Right-click "This PC", select "Properties" > "Advanced system settings" > "Environment Variables".
    • Under "System variables", find "Path", click "Edit...", then click "New" and add the following three paths:
      C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\bin
      C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\lib
      C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\include
    • Click "OK" to save and close all windows.
    • Reopen CMD and type nvcc -V. You should now see the version information.


Step 7: Install cuDNN 9.11

  1. Download cuDNN 9.11

  1. Install cuDNN

    • Double-click the downloaded .exe file and follow the prompts to install.
  2. Add Environment Variables

The method is the same as for CUDA. If you installed a version other than cudnn9.11, you need to modify v9.11 below to your version. Also, you should navigate to the folder C:\Program Files\NVIDIA\CUDNN\vYourVersionNumber\bin and see what the subfolder name is. For cudnn v9.11, it shows 12.9. Different versions show different numbers, so modify 12.9 to the actual number displayed.

This number might be higher than your installed CUDA 12.8 version; don't worry, it's compatible.

  • C:\Program Files\NVIDIA\CUDNN\v9.11\bin\12.9
  • C:\Program Files\NVIDIA\CUDNN\v9.11\lib\12.9
  • C:\Program Files\NVIDIA\CUDNN\v9.11\include\12.9

Complete Environment Variables Diagram (Specific paths will vary based on installed CUDA and cuDNN versions)

Finally: All Done!

Restart your computer. Now CUDA 12.8 and cuDNN 9.11 are both installed! You can start running programs that require GPU support. If there are software instructions (e.g., run python script.py), open CMD, navigate to your project folder, and try the corresponding command.

  1. All cuDNN Version Download Archive: https://developer.nvidia.com/cudnn-archive
  2. All CUDA Version Download Archive: https://developer.nvidia.com/cuda-toolkit-archive