Install the AI Workbench Desktop App#
Overview#
- The Desktop App is the main user interface for AI Workbench.
The Desktop App itself does not provide the AI Workbench services. It is a UI for managing and using projects on different machines, and it manages the AI Workbench application through an API.
- You can install Desktop App in “remote only” mode in about one minute.
It is an Electron app that has no dependencies that you need to install, and the file is small so it downloads quickly. “Remote only” mode is the intial installation where you can add a remote location and work right away, but the full AI Workbench application isn’t fully installed locally. For that you must then do the “full local install”.
- After you install the Desktop App, you need to add an AI Workbench location, either remote or local.
The Desktop App is a UI for using Workbench on locations. It is installed in “remote only” mode at first. You need to add a remote location, or you can do the “full local install” to work on your laptop or desktop.
Install on Windows#
- Prerequisites: Verify you have one of the following versions of Windows.
Windows 11 23H2 (build 22631 or higher)
Windows 10 22H2 (build 19045.4052 or higher)
- Step One: Read and agree to the NVIDIA AI Product Agreement.
By downloading or installing NVIDIA AI Workbench, you agree to the NVIDIA AI Workbench Product Agreement.
- Step Two: Download the Installer for Windows.
- Step Three: Install the application.
Locate the downloaded installer file
Double click the installer file
Follow the guided steps
- Success: The Desktop App will open to a splash page.
You can open the Locations Manager from the splash page.
- Next Steps: Add a remote location or do the full local install on Windows.
Go here to see how to add a remote location
Install on MacOS#
Prerequisites: Your operating system must be MacOS 14 (Sonoma) or higher.
- Step One: Read and agree to the NVIDIA AI Product Agreement.
By downloading or installing NVIDIA AI Workbench, you agree to the NVIDIA AI Workbench Product Agreement.
- Step Two: Download the Desktop App for MacOS.
- Step Three: Install the application.
Double-click the NVIDIA AI Workbench installation icon
Drag the AI Workbench App into the Applications folder
Follow the guided steps
- Success: The Desktop App will open to a splash page.
You can open the Locations Manager from the splash page.
- Next Steps: Add a remote location or do the full local install on MacOS.
Go here to see how to add a remote location
Install on Ubuntu Desktop#
- Prerequisites:
A system with Ubuntu Desktop
24.04or22.04sudoprivilegesThe
curlcommand line tool installed
- Step One: Read and agree to the NVIDIA AI Product Agreement.
By downloading or installing NVIDIA AI Workbench, you agree to the NVIDIA AI Workbench Product Agreement.
- Step Two: Configure the apt package manager to install AI Workbench.
Download and add NVIDIA’s public GPG key for the repository with the command:
curl -fsSL https://workbench.download.nvidia.com/stable/linux/gpgkey | sudo tee -a /etc/apt/trusted.gpg.d/ai-workbench-desktop-key.asc
Add the Workbench Debian repository to
sources.listwith the command:echo "deb https://workbench.download.nvidia.com/stable/linux/debian default proprietary" | sudo tee -a /etc/apt/sources.list
Update the Debian package index with the command:
sudo apt update
- Step Three: Install the Desktop App.
Install the Desktop App with the command:
sudo apt install nvidia-ai-workbench
- Success: The Desktop App will open to a splash page.
You can open the Locations Manager from the splash page.
- Next Steps: Add a remote location or do the full local install on Ubuntu Desktop.
Go here to see how to add a remote location
Go here to see how to do the full local install on Ubuntu Desktop