AI Workbench Locations
A computer that has NVIDIA AI Workbench installed, and where you store and run your projects, is called a location. The first place you install AI Workbench is on your local computer, which can be a CPU-only computer. Later you can install AI Workbench on one or more remote computers, such as workstations, servers, cloud instances, and virtual machines.
With AI Workbench, you can use multiple remote GPU-enabled computers from within one user interface driven from your local laptop.
The Command Line Interface (CLI) uses the name context instead of location.
Use this documentation to learn about the following:
Your local computer is the first place that you install AI Workbench, and during installation AI Workbench creates a default local location. To install AI Workbench on your local computer, see Install AI Workbench.
You can install AI Workbench on one or more remote computers that you have SSH access to. First you install AI Workbench on the remote computer, and then you connect to it from your local AI Workbench. To install AI Workbench on a remote computer, see Install AI Workbench Remotely on Ubuntu.
Adding a remote location to your local AI Workbench gives you access to more compute power or GPUs than are available on your local computer. You can have multiple remote locations, each connected to a different system, giving you the flexibility to work on various types of systems with different compute resources.
Remote locations work by establishing an SSH tunnel between your local computer and the AI Workbench service on the remote computer. This secure connection allows you to access and work on your projects as if you were locally connected to the remote system. For details, see Connect to a Remote Location.
When you open the AI Workbench desktop app, or use the AI Workbench CLI, you choose the location that you want to start working in. After that, you can change your location.
When you open the AI Workbench desktop app, choose the location that you want to start working in on the My Locations window.
To change your location, in the AI Workbench desktop app, click the active location and then click Manage Locations.
When you work with the AI Workbench CLI,
use the command nvwb activate <location name> to start working in a location.
You can also include the -c or --context flag on any command to specify a location.
For more information, see Basic Quickstart (CLI).
To synchronize your work across different locations, save your projects on a Git Server. By storing your project in Git, you can commit and push your changes in one location, and then pull the changes in another other Location. For more information, see AI Workbench Integrations.
In the AI Workbench desktop app, you can access a project from another location with a single click. Open the project you want to work on, and next to the project name click Open In.
In the AI Workbench Command Line Interface (CLI), open a new terminal, activate the location,
and then manually clone the repository using the nvwb clone command.
For more information, see Basic Quickstart (CLI).
You cannot delete the local location.
You can delete a remote location by using the AI Workbench desktop app or CLI, as long as the location is not running. When you delete a remote location AI Workbench removes the connection information for that location. However, when you delete a remote location, AI Workbench does not delete any files or projects stored in that location. If you re-add the remote location, you can access your projects again. For instructions to uninstall AI Workbench, see Uninstall AI Workbench on a Remote Computer.
To delete a location, in the AI Workbench desktop app, click the active location and then click Manage Locations.
Click the ellipsis menu of the location that you want to delete and then click Delete Location.
In the CLI, use the command nvwb delete context <location name>.