Prerequisites for DoMINO-Automotive-Aero NIM#

The following are the prerequisites for using DoMINO-Automotive-Aero NIM.

Software#

With a Docker-supported operating system, install Docker - minimum version: 23.0.1
Install NVIDIA Drivers - minimum version: 545. However, if you are running on a data center GPU (for example, T4 or any other data center GPU), you can use NVIDIA driver release 470.57 (or later R470), 525.85 (or later R525), 535.86 (or later R535), or 545.23 (or later R545).
Install and configure the NVIDIA Container Toolkit - minimum version: 1.13.5
Verify your container runtime supports NVIDIA GPUs by running the following:

docker run --rm --runtime=nvidia --gpus all ubuntu nvidia-smi

Example output:

+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 560.35.03              Driver Version: 560.35.03      CUDA Version: 12.6     |
|-----------------------------------------+------------------------+----------------------+
| GPU  Name                 Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |
|                                         |                        |               MIG M. |
|=========================================+========================+======================|
|   0  NVIDIA A100-PCIE-40GB          Off |   00000000:41:00.0 Off |                    0 |
| N/A   37C    P0             35W /  250W |   40423MiB /  40960MiB |      0%      Default |
|                                         |                        |             Disabled |
+-----------------------------------------+------------------------+----------------------+
                                                                                         

For more information on enumerating multi-GPU systems, please see the NVIDIA Container Toolkit’s GPU Enumeration Docs.

NGC Account#

You must have an authenticated NGC (NVIDIA GPU Cloud) account with access to both the respective NIM and model checkpoints. Use the following procedure to log in to NGC, and set the NGC_API_KEY environment variable, so that you can pull images.

Create an account on NGC.
Generate an API Key. The following steps require your NGC API key.
Authenticate local Docker with NGC by running the following code. For more details, see the NGC authentication documentation.
```
docker login nvcr.io
Username: $oauthtoken
Password: <NGC API key>
```
Set the NGC API key environment variable in your shell. You need to set the NGC_API_KEY variable.
```
export NGC_API_KEY=<NGC API key>
```

Client Side Python Dependencies#

Note

It is recommended to use a virtual environment to install the dependencies.

In the provided guide, a few packages will be used to interact with the NIM:

pip install httpx==0.28.1
pip install numpy==1.22.0
pip install trimesh==4.6.2

For post processing the results, the following additional packages will be used:

pip install matplotlib==3.6.2
pip install pyvista==0.44.2
pip install scipy==1.10.1

sudo apt-get install xvfb

It is recommended to create an empty working directory for client code / input data:

mkdir domino
cd domino

Next Steps#

After you install all prerequisites, to get started, see the quickstart guide.