Files
hao-ai-lab-FastVideo/examples/train
shaoxiongduan 8bc4e538d0 [feat] WanTrack tooling: sparse interactive app + warmstart YAML
examples/inference/gradio/trackwan/app_action.py:
  Bring the interactive drawing app in line with the sparse training
  regime our overfit runs used (WANTRACK_SPARSE=1). New 'Track budget'
  radio: 'dense' keeps the old full 50x50 grid; 'sparse' (new default)
  builds a much smaller [Tpx, num_moving + num_bg, 2] tensor -- the
  moving handle points from the drawn path + num_bg random background
  points from the training grid (seeded by the seed slider). New
  'num_bg' slider (0-60, default 20) matches WANTRACK_EXTRA_RANDOM=20.
  Overlay logic updated to draw every point in sparse mode instead of
  grid-strided subsampling that assumed N==2500.

examples/train/scenario/worldmodel/finetune_wantrack_synth_sparse_random_warmstart.yaml:
  Test config for the curriculum idea: start from sparse-fixed@1000
  and let random-sampling sparse training take over. Compared cold-
  start sparse-random (~0.8%) vs warmstart (~3.2%) vs fixed (~8.8%)
  divergence.
2026-07-07 03:24:11 +00:00
..

Training

Quick Start

Single-node

bash examples/train/run.sh <config.yaml> [--dotted.key value ...]

The script auto-detects available GPUs. Override with NUM_GPUS:

NUM_GPUS=4 bash examples/train/run.sh \
    examples/train/configs/fine_tuning/wan/t2v.yaml

Multi-node (Slurm)

bash examples/train/run_slurm.sh <config.yaml> <num_nodes> [--dotted.key value ...]
bash examples/train/run_slurm.sh \
    examples/train/configs/fine_tuning/wan/t2v.yaml 4 \
    --training.distributed.hsdp_shard_dim 8 \
    --training.distributed.hsdp_replicate_dim 4

Slurm environment variables:

Variable Default Description
PARTITION main Slurm partition
NUM_GPUS 8 GPUs per node
CPUS_PER_TASK 128 CPUs per task
MEM 1440G Memory per node
EXCLUDE "" Nodes to exclude

Overriding config values

Any config field can be overridden from the command line using dotted keys:

bash examples/train/run.sh examples/train/configs/fine_tuning/wan/t2v.yaml \
    --training.optimizer.learning_rate 1e-5 \
    --training.loop.max_train_steps 1000 \
    --training.checkpoint.output_dir outputs/my_experiment

Resuming from a checkpoint

bash examples/train/run.sh examples/train/configs/fine_tuning/wan/t2v.yaml \
    --training.checkpoint.resume_from_checkpoint outputs/my_experiment/checkpoint-500

W&B Logging

Training metrics and validation videos are logged to Weights & Biases. Set your API key before launching:

export WANDB_API_KEY=your_key_here

To disable W&B (e.g. for local debugging):

export WANDB_MODE=offline

The project name and run name are set in the config under training.tracker:

training:
  tracker:
    project_name: my_project
    run_name: my_run

Directory Layout

examples/train/
├── configs/      # Single-step training configs (by method and model)
├── scenario/     # Multi-step end-to-end training pipelines
├── run.sh        # Single-node launcher
└── run_slurm.sh  # Multi-node Slurm launcher

See configs/README.md and scenario/README.md for details.