Stage 4 · Chapter 16 · Deploy on Jetson
16. Configure the GR00T Software Environment
Define the workspace, clone the validated deployment repository, and install the platform runtime for your target — Orin or Thor.
16.1 Select the Target
Orin or Thor
16.1 Select the Target
# Jetson AGX Orin
export GR00T_TARGET=orin
# Jetson AGX Thor
export GR00T_TARGET=thor
tr -d '\0' < /proc/device-tree/model
Confirm that GR00T_TARGET matches the detected board.
16.2 Define the Workspace
Paths
16.2 Define the Workspace
mkdir -p "${HOME}/.config/gr00t-inference"
cat > "${HOME}/.config/gr00t-inference/paths.sh" <<'EOF_PATHS'
: "${GR00T_TARGET:=orin}"
export GR00T_WORKSPACE="${GR00T_WORKSPACE:-${HOME}/gr00t-inference}"
export GR00T_REPO="${GR00T_REPO:-${GR00T_WORKSPACE}/Isaac-GR00T-Orin-JP72}"
export GR00T_MODEL_PATH="${GR00T_MODEL_PATH:-${GR00T_WORKSPACE}/checkpoints/checkpoint-5000}"
export GR00T_DATASET_PATH="${GR00T_DATASET_PATH:-${GR00T_WORKSPACE}/datasets/so101_vials_real}"
export GR00T_BACKBONE_PATH="${GR00T_BACKBONE_PATH:-${GR00T_WORKSPACE}/models/nvidia/Cosmos-Reason2-2B}"
export GR00T_TRT_OUTPUT="${GR00T_TRT_OUTPUT:-${GR00T_WORKSPACE}/artifacts/${GR00T_TARGET}/so101_trt}"
export GR00T_RESULT_PATH="${GR00T_RESULT_PATH:-${GR00T_WORKSPACE}/results/${GR00T_TARGET}/so101_trt_result.jpeg}"
EOF_PATHS
source "${HOME}/.config/gr00t-inference/paths.sh"
mkdir -p "$(dirname "${GR00T_REPO}")" "${GR00T_MODEL_PATH}" \
"${GR00T_DATASET_PATH}" "${GR00T_BACKBONE_PATH}" \
"${GR00T_TRT_OUTPUT}" "$(dirname "${GR00T_RESULT_PATH}")"
16.3 Clone the Validated Repository
Pinned revision
16.3 Clone the Validated Repository
source "${HOME}/.config/gr00t-inference/paths.sh"
git clone https://github.com/jjjadand/Isaac-GR00T-Orin-JP72.git "${GR00T_REPO}"
cd "${GR00T_REPO}"
git checkout dcf5f6b759fd17cab3644a97fc4429bca7451e38
git submodule update --init --recursive
16.4 Install the Platform Runtime
Per-target venvs
16.4 Install the Platform Runtime
Jetson AGX Orin with JetPack 7.2
The repository's Orin wrapper creates and activates .venv-jp72 and loads
the JetPack 7.2 CUDA runtime paths automatically:
bash scripts/deployment/orin_jp72/run_full_trt.sh prepare
Jetson AGX Thor
source .venv/bin/activate
source scripts/activate_thor.sh
16.5 Obtain Hugging Face Access
License first
16.5 Obtain Hugging Face Access
The official GR00T 1.7 backbone is nvidia/Cosmos-Reason2-2B and requires
acceptance of the NVIDIA model license.
- Open NVIDIA Cosmos-Reason2-2B.
- Accept the license agreement.
- Authenticate on the Jetson:
uv tool install -U "huggingface_hub[cli]"
hf auth login
Never commit tokens
Do not store Hugging Face tokens in the repository or shell scripts.
16.6 Verify the Environment
Sanity check
16.6 Verify the Environment
cd "${GR00T_REPO}"
python - <<'PY'
import os
import platform
import torch
print("machine:", platform.machine())
print("python:", platform.python_version())
print("torch:", torch.__version__)
print("cuda available:", torch.cuda.is_available())
print("target:", os.environ.get("GR00T_TARGET"))
PY
The command must report aarch64, a CUDA-enabled PyTorch build, and the
expected target environment.