Environment Variable Reference#
Environment variables select external runtimes, assets, and services for the simulated G1, simulated H2, and physical G1 workflow paths. The tables also list the shell variables that carry a run’s files between stages.
Starting a New Terminal#
Restore the settings for the stage you are resuming on the machine where it
runs. Use the same asset, dataset, and checkpoint paths as the preceding stage.
For an existing H2 run, retain H2_RUN_DIR; creating a new timestamped directory
would disconnect the later commands from your recording.
Export variables read by a launched process with export NAME=value.
Shell variables are expanded by the command
examples and need an assignment in each terminal that uses them, even when the
guide originally exported them. Shell state does not transfer to a new terminal,
another machine, or an already running container.
Stage |
Restore |
|---|---|
G1 simulation and recording |
Simulation runtime; CloudXR setup from Installation |
H2 simulation, recording, replay, and generation |
Simulation runtime and H2 assets; CloudXR in the separate server terminal |
G1 or H2 optional data generation |
AutoData overrides, if provisioning used non-default paths; the selected run’s input/output variables |
G1 or H2 dataset loading, training, and evaluation |
GR00T checkout, matching run variables; H2 assets for H2 simulation/evaluation |
Physical G1 teleoperation, recording, and deployment |
Isaac ROS workspace and activation; source the CloudXR environment in each teleoperation terminal |
Simulation Runtime#
Variable |
Requirement and Value |
Setup |
|---|---|---|
|
For non-interactive Isaac Sim launch, |
|
|
Optional override for the pinned Isaac Lab-Arena checkout. Unset uses the managed |
|
|
Absolute path to the clean, synced Isaac-GR00T checkout pinned in |
The EULA settings apply to simulation processes, including replay and generation. They do not accept the separate CloudXR license.
H2 Assets#
Restore these in each terminal that starts H2 simulation. The source contracts
are configs/robots/h2.yaml and configs/robots/h2_pink.yaml.
Variable |
Requirement and Value |
Setup |
|---|---|---|
|
Asset cache root used during preparation. The runtime default is |
|
|
Required for the Pink recording, replay, and generation embodiment. Use the |
|
|
Required H2 AGILE ONNX file. Its digest must match the robot configuration; a filename alone is insufficient. |
The H2 validation command exercises both Pink and joint embodiments and needs
all three settings plus ISAAC_GR00T_ROOT.
H2 CloudXR Server#
Set these in the CloudXR terminal, separate from the recording terminal. Start CloudXR provides the client download and launch commands.
Variable |
Requirement and Value |
|---|---|
|
Directory containing the downloaded pinned |
Isaac AutoData#
These overrides are optional. Restore any that you used during
provisioning.
tools/launch_autodata.sh owns their defaults; explicit command-line options
take precedence where provided.
Variable |
Default and Use |
|---|---|
|
The sibling |
|
Interpreter in the |
|
|
|
|
|
|
Run and Artifact Shell Variables#
These names belong to the guide’s shell commands. The applications receive their values through file paths and command-line arguments. Recreate them for the existing run before copying commands from a later stage.
Variable |
Value to Restore |
Guide |
|---|---|---|
|
Absolute path to this repository, captured before changing into Isaac-GR00T. |
|
|
Output of |
|
|
G1 LeRobot dataset and G1 modality configuration from the training guide. |
|
|
Training output directory for the selected G1 or H2 run. |
|
|
Selected published model directory or completed checkpoint directory from the matching robot’s training run. G1 also supports the released checkpoint described in its evaluation guide. |
|
|
|
|
|
Absolute path to the existing |
|
|
Recorded source HDF5 and its expected accepted episode count. |
|
|
Generated HDF5 and requested successful generation count. |
|
|
Measured wall-clock budget passed as |
|
|
Selected source or generated HDF5 and its expected episode count. Keep the path and count paired. For published-dataset loader validation, set |
|
|
Converted or downloaded dataset directory and H2 modality configuration. |
|
|
Separate output directory for the short training check. |
|
|
Temporary download values read from |
|
|
Physical G1 LeRobot output directory on the machine doing conversion. Transfer the complete directory when training elsewhere. |
Physical G1#
The physical path uses the Isaac ROS environment on Thor. Its x86_64 conversion, training, and export stages use the environments stated in their own guides.
Setting |
Requirement and Value |
Setup |
|---|---|---|
|
Absolute workspace path on the current machine. Setup persists |
|
|
UTF-8 locale; setup persists |
|
Isaac ROS and |
Run |
|
CloudXR environment |
With CloudXR running, source |
|
|
The training example supplies |
The physical training and LEAPP export guides pass dataset, checkpoint, and bundle paths explicitly. They do not use the simulation launchers’ GR00T or H2 environment variables.