tao-train-sparse4d

Train, evaluate, export, and quantize Sparse4D multi-camera temporal 3D detection models with NVIDIA TAO.

3.2k|370|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill tao-train-sparse4d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tao-train-sparse4d
Source: https://github.com/NVIDIA/skills/tree/main/skills/tao-train-sparse4d
Command: npx skills add https://github.com/NVIDIA/skills --skill tao-train-sparse4d

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Configuring and running Sparse4D multi-camera temporal 3D object detection and tracking workflows in NVIDIA TAO involves complex dataset conversion, spec overrides, anchor files, and AutoML routing that are easy to get wrong. This Skill guides an agent through the correct end-to-end procedure.

Core Features & Use Cases

  • Full action coverage: Guides dataset_convert, train, evaluate, inference, export, and quantize actions with mandatory per-action data source overrides.
  • AutoML routing: Reads skill_info.yaml and routes train actions through tao-run-automl when automl_policy is on, with per-run override support.
  • Error recovery guidance: Documents fixes for H5 depth path mismatches, missing anchor_init.npy files, temporal OOM, and quantize container issues.
  • Use Case: A robotics engineer asks the agent to train a Sparse4D model on AICity data; the Skill ensures dataset conversion runs first, anchor files are wired correctly, and training launches with proper spec overrides.

Quick Start

Ask your agent to train a Sparse4D model for multi-camera 3D detection on your AICity dataset using NVIDIA TAO.

Frequently Asked Questions about tao-train-sparse4d

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I train a Sparse4D model with NVIDIA TAO?

Run dataset_convert first to produce annotation pickles and anchor_init.npy, then launch train with mandatory data source overrides for data_root, anchor, and ann_file paths. The Skill routes training through AutoML by default unless automl_policy is set to off.

What dataset format does TAO Sparse4D training require?

Sparse4D training requires the sparse4d dataset type in OVPKL format, converted from AICity source data using the tao_toolkit.data_services image with the annotations convert command. Conversion produces annotation pickles and the anchor_init.npy file needed by all downstream actions.

What GPUs are needed for Sparse4D temporal 3D detection training?

Sparse4D training requires a minimum of 2 GPUs with 40GB or more VRAM each, with A100 and 8 GPUs recommended. bf16 precision is required for practical training, and multi-GPU uses DDP with find_unused_parameters enabled.

Why does Sparse4D training fail with an H5 depth path error?

The failure occurs when converted depth_map_path tuples point to camera directories instead of H5 files. Run the normalize_depth_paths.py script against the converted annotation directory after dataset_convert and before train, evaluate, or inference.

Can I disable AutoML when training Sparse4D in TAO?

Yes, set automl_policy to off for the run, or use phrases like disable AutoML or plain training in your request. This applies only to that run and uses direct model training instead of routing through tao-run-automl.

How do I fix temporal out-of-memory errors during Sparse4D training?

Reduce dataset.num_frames or dataset.batch_size to lower memory usage during temporal training. The instance bank and multi-camera temporal reasoning are memory intensive, so smaller sequence lengths help fit within available VRAM.