CostNav Assets

This directory contains Omniverse USD assets used by CostNav.

For Open Source Users (Recommended)

1. Download Assets from Hugging Face

make download-assets-hf

This downloads all required assets to assets/Users/.

2. Initialize and Start Local Nucleus Server

Prerequisites: - Docker and Docker Compose installed - .env file with NGC credentials

Step 1: Set up NGC credentials in .env:

cp .env.example .env
# Edit .env and set NGC_PASS to your NGC API key
# Get your API key at: https://org.ngc.nvidia.com/setup/api-keys

Step 2: Run the nucleus server:

make start-nucleus

The script will configure Nucleus and copy assets. After starting, assets will be served at omniverse://localhost.

3. Set OMNI_URL in dotenv

OMNI_USER=omniverse
OMNI_PASS=costnav123
OMNI_URL=omniverse://localhost

For Internal Developers

Download from Internal Omniverse Server

make download-assets-omniverse

Upload to Hugging Face

make upload-assets-hf