Overview of OpenTau diagnostic scripts
mainOpenTau provides four diagnostic scripts located in src/opentau/scripts/ to help identify performance bottlenecks in training and inference. All training scripts use the same TrainPipelineConfig as opentau-train, ensuring they reproduce the exact model, dataset, and batch size of your actual run.
| Script | Purpose |
|---|---|
profile_step.py | Measures per-step wall-clock time, broken down into forward, backward, optimizer, and sync phases. Use this to find out why training is slow. |
profile_dataloader.py | Measures the dataloader-only throughput ceiling. Use this to rule out input-pipeline starvation before investigating the GPU. |
find_unused_params.py | Lists parameters that receive no gradient during a forward+backward pass. Use this to determine if you can safely set find_unused_parameters=False in DDP. |
benchmark_inference.py | Measures per-call policy.sample_actions latency under deployment-like conditions (random-init expert, bf16, batch 1). Use this to characterize serving or on-robot speed. |