Módulo 4 · Capítulo 16 · Deploy on Jetson
16. Configurar o ambiente GR00T
Defina o workspace, clone o repositório validado de deploy e instale o runtime da sua plataforma — Orin ou Thor.
16.1 Escolher o alvo
Orin ou Thor
16.1 Escolher o alvo
# Jetson AGX Orin
export GR00T_TARGET=orin
# Jetson AGX Thor
export GR00T_TARGET=thor
tr -d '\0' < /proc/device-tree/model
Confirme que GR00T_TARGET corresponde à placa detectada.
16.2 Definir o workspace
Caminhos
16.2 Definir o 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 Clonar o repositório validado
Revisão fixada
16.3 Clonar o repositório validado
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 Instalar o runtime da plataforma
Venvs por alvo
16.4 Instalar o runtime da plataforma
Jetson AGX Orin com JetPack 7.2
O wrapper de Orin do repositório cria e ativa .venv-jp72 e carrega os
caminhos do runtime CUDA do JetPack 7.2 automaticamente:
bash scripts/deployment/orin_jp72/run_full_trt.sh prepare
Jetson AGX Thor
source .venv/bin/activate
source scripts/activate_thor.sh
16.5 Obter acesso ao Hugging Face
Primeiro a licença
16.5 Obter acesso ao Hugging Face
O backbone oficial do GR00T 1.7 é o nvidia/Cosmos-Reason2-2B e exige
aceitar a licença do modelo da NVIDIA.
- Abra NVIDIA Cosmos-Reason2-2B.
- Aceite o contrato de licença.
- Autentique no Jetson:
uv tool install -U "huggingface_hub[cli]"
hf auth login
Não comite tokens
Não armazene tokens do Hugging Face no repositório nem em scripts de shell.
16.6 Verificar o ambiente
Checagem rápida
16.6 Verificar o ambiente
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
A saída deve informar aarch64, um build de PyTorch com CUDA e o ambiente
do alvo esperado.