Adding torch accelerator to ddp-tutorial-series example

Signed-off-by: dggaytan <[email protected]>

Author: dggaytan

distributed/ddp-tutorial-series/README.md

@@ -15,7 +15,27 @@ Each code file extends upon the previous one. The series starts with a non-distr
     * [slurm/setup_pcluster_slurm.md](slurm/setup_pcluster_slurm.md): instructions to set up an AWS cluster
     * [slurm/config.yaml.template](slurm/config.yaml.template): configuration to set up an AWS cluster
     * [slurm/sbatch_run.sh](slurm/sbatch_run.sh): slurm script to launch the training job
-
-
-
-
+## Installation
+```
+pip install -r requirements.txt
+```
+## Running Examples
+For running the examples to run for 20 Epochs and save checkpoints every 5 Epochs, you can use the following command:
+### Single GPU
+```
+python single_gpu.py 20 5
+```
+### Multi-GPU
+```
+python multigpu.py 20 5
+```
+### Multi-GPU Torchrun
+```
+torchrun --nnodes=1 --nproc_per_node=4 multigpu_torchrun.py 20 5
+```
+### Multi-Node
+```
+torchrun --nnodes=2 --nproc_per_node=4  multinode.py 20 5
+```
+
+For more details, check the [run_examples.sh](distributed/ddp-tutorial-series/run_examples.sh) script.

distributed/ddp-tutorial-series/multigpu.py

@@ -19,13 +19,10 @@ def ddp_setup(rank, world_size):
     os.environ["MASTER_ADDR"] = "localhost"
     os.environ["MASTER_PORT"] = "12355"
 
-    rank = int(os.environ["LOCAL_RANK"])
     if torch.accelerator.is_available():       
         device = torch.device(f"{torch.accelerator.current_accelerator()}:{rank}")
         torch.accelerator.set_device_index(rank)
         print(f"Running on rank {rank} on device {device}")
-    else:
-        print(f"Multi-GPU environment not detected")
 
     backend = torch.distributed.get_default_backend_for_device(device)
     init_process_group(backend=backend, rank=rank, world_size=world_size)

distributed/ddp-tutorial-series/run_example.sh

@@ -4,7 +4,8 @@
 # num_gpus = num local gpus to use (must be at least 2). Default = 2
 
 # samples to run include:
-# example.py
+# multigpu_torchrun.py
+# multinode.py
 
 echo "Launching ${1:-example.py} with ${2:-2} gpus"
-torchrun --nnodes=1 --nproc_per_node=${2:-2} --rdzv_id=101 --rdzv_endpoint="localhost:5972" ${1:-example.py}
+torchrun --nnodes=1 --nproc_per_node=${2:-2} --rdzv_id=101 --rdzv_endpoint="localhost:5972" ${1:-example.py} 10 1

distributed/ddp-tutorial-series/single_gpu.py

@@ -78,5 +78,5 @@ def main(device, total_epochs, save_every, batch_size):
     parser.add_argument('--batch_size', default=32, type=int, help='Input batch size on each device (default: 32)')
     args = parser.parse_args()
 
-    device = 0  # shorthand for cuda:0
+    device = 0  
     main(device, args.total_epochs, args.save_every, args.batch_size)

run_distributed_examples.sh

@@ -51,9 +51,10 @@ function distributed_tensor_parallelism() {
 }
 
 function distributed_ddp-tutorial-series() {
-    uv run bash run_example.sh multigpu.py || error "ddp tutorial series multigpu example failed"
+    uv python multigpu.py 10 1 || error "ddp tutorial series multigpu example failed"
     uv run bash run_example.sh multigpu_torchrun.py || error "ddp tutorial series multigpu torchrun example failed"
     uv run bash run_example.sh multinode.py || error "ddp tutorial series multinode example failed"
+    uv python single_gpu.py 10 1 || error "ddp tutorial series single gpu example failed"
 }
 
 function distributed_ddp() {