Skip to main content
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.

  1. Open NVIDIA Cosmos-Reason2-2B.
  2. Accept the license agreement.
  3. 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.

Next: Chapter 17 — Prepare the Dataset and Model Assets.

Loading Comments...