User Guide (Latest)

Install AI Workbench on macOS

Use this documentation to install, update, or uninstall NVIDIA AI Workbench on your computer running macOS. To review important considerations before you start, see Install AI Workbench.

Note

If problems occur during installation, see Troubleshoot AI Workbench or the NVIDIA Developer Forum.

Use this documentation to perform the following tasks:

  • MacOS 12 (Monterrey) or higher

  • 500 MB of disk space for the AI Workbench application

  • 30 to 40 GB of disk space for containers

  • 16 GB of RAM

Use the following procedure to install AI Workbench on your computer running macOS.

  1. Download AI Workbench and run it. Follow the usual installation path for macOS.

    Warning

    Before downloading, please read the NVIDIA AI Product Agreement, the NVIDIA AI Workbench Shared Security Model, and our Data Privacy Policy.

    By downloading, installing, or using the NVIDIA AI Workbench software, you agree to the terms of the NVIDIA AI Product Agreement (EULA). If you do not agree to the terms of the EULA, you are not authorized to download, install, or use NVIDIA AI Workbench. Before downloading and using NVIDIA AI Workbench, please read our Shared Security Model.

  2. Choose Docker or Podman as your container runtime. You can use either Docker or Podman as your runtime; however, we recommend Docker for macOS. For more information, see AI Workbench Container Runtimes.

  3. (Optional) Connect AI Workbench to your Git server account. If you skip this step now, you must enter Git Author information when you are prompted. If you skip this step now, you can connect to Git later through settings. For more information, see Connect to Git.

  4. AI Workbench opens.

Use the following procedure to update AI Workbench on your computer running MacOS.

Warning

After you update AI Workbench on your local computer, you must also update any connected remote locations. For details, see Update AI Workbench on a Remote Computer.


  1. When a new update for AI Workbench is available, the Update Available window appears with details about the new version when you open AI Workbench.

    Tip

    The Update Available window might be behind the AI Workbench window if the AI Workbench window is maximized.

  2. Click Update Now. AI Workbench begins downloading the new files, and the progress appears in the window. After the download completes, the message Restart required appears.

  3. Click Restart Now. AI Workbench reopens automatically.

Use the following procedure to uninstall AI Workbench from your computer running macOS.

  1. In a command shell, run the the following command.

    Copy
    Copied!
                

    sudo -E $HOME/.nvwb/bin/nvwb-cli uninstall

  2. You are prompted to confirm that you want to uninstall AI Workbench. Type y and press enter.

    Wait for the uninstall to complete before you proceed with the following steps.

  3. (Optional) If you want to remove the application files, run the following command to remove the .nvwb folder.

    Copy
    Copied!
                

    rm -rf $HOME/.nvwb


  4. (Optional) Iif you want to remove your project repositories, run the following command.

    Copy
    Copied!
                

    rm -rf $HOME/nvidia-workbench/


  5. Open Finder and search for Workbench. Drag the icon to the trash.

Previous Install AI Workbench on Windows
Next Install AI Workbench Locally on Ubuntu
© Copyright © 2024, NVIDIA Corporation. Last updated on Nov 4, 2024.