mirror of
https://github.com/NVIDIA/Model-Optimizer.git
synced 2026-11-02 08:03:22 +08:00
## What does this PR do?
**Type of change:** New Feature <!-- Use one of the following: Bug fix,
new feature, new example, new tests, documentation. -->
**Overview:**
- Supported Context Parallel by patching torch ring attention;
- Require following libirary version for stable cp:
- torch2.8.0
- transformers5.0.0
- accelrate1.12.0
- Move to FSDP2
- Removed unused arguments in training script (`--multi_gpu`,
`fsdp_wrap_layer`)
- Bump CI container to `nvcr.io/nvidia/pytorch:25.08-py3`
## Usage
<!-- You can potentially add a usage example below. -->
```bash
./launch_train.sh --model $MODEL \
--output_dir $OUTPUT_DIR \
--data $DATA \
--num_epochs 0.1 \
--train_bs 1 \
--eagle_config eagle_config.json \
--training_seq_len 1024 \
--cp_size 2 #newly added
```
## Testing
- SDPA level correctness: tested TTT attention with/without CP, diff <
1%
```
=== Compare context-parallel (CP) outputs and grads with non-CP ===
Forward output comparison (CP vs Non-CP):
Absolute diff (adiff) cp_out vs out: 0.001953125
Relative diff (rdiff) cp_out vs out: 0.00182342529296875
WQ (query proj) grad comparison (CP vs Non-CP):
Absolute diff (adiff) cp_wq_grad vs wq_grad: 0.0078125
Relative diff (rdiff) cp_wq_grad vs wq_grad: 0.00347900390625
WK (key proj) grad comparison (CP vs Non-CP):
Absolute diff (adiff) cp_wk_grad vs wk_grad: 0.0078125
Relative diff (rdiff) cp_wk_grad vs wk_grad: 0.002471923828125
WV (value proj) grad comparison (CP vs Non-CP):
Absolute diff (adiff) cp_wv_grad vs wv_grad: 0.25
Relative diff (rdiff) cp_wv_grad vs wv_grad: 0.0069580078125
==============================================================
```
- E2E Training Acc
(Llama3.1-8B, Unsynthesized magpie)
<img width="911" height="630" alt="image"
src="https://github.com/user-attachments/assets/1ecacc7f-c720-494c-9c1b-b60e7ced7baa"
/>
- Peak Mem Reserved
(llama3.1-8B, 8xH100, train_length=4k)
| cp_size | max_memory_allocated(MB) |max_memory_reserved (MB) |
|----|--------------------------|--------------------------|
| 1 | 65040.20 |79018.00
| 2 | 50409.17 |73098.00
| 4 | 45120.92 |72052.00
| 8 | 38882.12 |66484.00
- Max Training Length test
(llama3.1-8B, H100)
| cp_size | 6k | 12k | 24k | 48k |
|--------------------|-----|-----|-----|-----|
| 1 | ✅ | OOM | OOM | OOM |
|2 | ✅ | ✅ | OOM | OOM |
| 4 | ✅ | ✅ | ✅ | OOM |
| 8 | ✅ | ✅ | ✅ | ✅ |
## Before your PR is "*Ready for review*"
<!-- If you haven't finished some of the above items you can still open
`Draft` PR. -->
- **Make sure you read and follow [Contributor
guidelines](https://github.com/NVIDIA/Model-Optimizer/blob/main/CONTRIBUTING.md)**
and your commits are signed.
- **Is this change backward compatible?**: Yes/No <!--- If No, explain
why. -->
- **Did you write any new necessary tests?**: Yes/No
- **Did you add or update any necessary documentation?**: Yes/No
- **Did you update
[Changelog](https://github.com/NVIDIA/Model-Optimizer/blob/main/CHANGELOG.rst)?**:
Yes/No <!--- Only for new features, API changes, critical bug fixes or
bw breaking changes. -->
## Additional Information
<!-- E.g. related issue. -->
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **New Features**
* Added context parallelism (CP) and data parallelism shard size
configuration parameters to training arguments.
* **Enhancements**
* Improved TTT attention masking support for speculative decoding
workflows.
* Enhanced training launch script with improved parallelism
configuration handling.
* **Chores**
* Updated core dependencies: torch, transformers, accelerate, and wandb.
* Added FSDP configuration file for distributed training setup.
<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Signed-off-by: h-guo18 <67671475+h-guo18@users.noreply.github.com>
221 lines
6.1 KiB
Bash
Executable File
221 lines
6.1 KiB
Bash
Executable File
#!/bin/bash
|
|
# SPDX-FileCopyrightText: Copyright (c) 2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
set -eo pipefail
|
|
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
--training_seq_len*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
TRAINING_SEQ_LEN="${1#*=}"
|
|
;;
|
|
--model*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
MODEL="${1#*=}"
|
|
;;
|
|
--data*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
DATA="${1#*=}"
|
|
;;
|
|
--offline-data*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
OFFLINE_DATA_PATH="${1#*=}"
|
|
;;
|
|
--mode*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
MODE="${1#*=}"
|
|
;;
|
|
--eagle_decoder_type*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
EAGLE_DECODER_TYPE="${1#*=}"
|
|
;;
|
|
--output_dir*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
OUTPUT_DIR="${1#*=}"
|
|
;;
|
|
--num_epochs*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
NUM_EPOCHS="${1#*=}"
|
|
;;
|
|
--save_steps*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
SAVE_STEPS="${1#*=}"
|
|
;;
|
|
--lr*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
LR="${1#*=}"
|
|
;;
|
|
--train_bs*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
TRAIN_BS="${1#*=}"
|
|
;;
|
|
--medusa_num_heads*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
MEDUSA_NUM_HEADS="${1#*=}"
|
|
;;
|
|
--medusa_num_layers*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
MEDUSA_NUM_LAYERS="${1#*=}"
|
|
;;
|
|
--eagle_config*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
EAGLE_CONFIG="${1#*=}"
|
|
;;
|
|
--disable_tqdm*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
DISABLE_TQDM="${1#*=}"
|
|
;;
|
|
--vlm_processor*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
VLM_PROCESSOR="${1#*=}"
|
|
;;
|
|
--vlm_img_dir*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
VLM_IMG_DIR="${1#*=}"
|
|
;;
|
|
--estimate_ar*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
ESTIMATE_AR="${1#*=}"
|
|
;;
|
|
--ar_validate_steps*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
AR_VALIDATE_STEPS="${1#*=}"
|
|
;;
|
|
--cp_size*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
CP_SIZE="${1#*=}"
|
|
;;
|
|
--dp_size*)
|
|
if [[ "$1" != *=* ]]; then shift; fi
|
|
DP_SHARD_SIZE="${1#*=}"
|
|
;;
|
|
*)
|
|
>&2 printf "Error: Invalid argument ${1#*=}\n"
|
|
exit 1
|
|
;;
|
|
esac
|
|
shift
|
|
done
|
|
|
|
set -x
|
|
|
|
# Get the default value for save_steps based on the available number of GPUs
|
|
GPU_COUNT=$(python -c "import torch; print(torch.cuda.device_count())")
|
|
# Calculate save_steps
|
|
DEFAULT_SAVE_STEPS=$((8192 / GPU_COUNT))
|
|
|
|
MODEL=${MODEL:-"TinyLlama/TinyLlama-1.1B-Chat-v1.0"}
|
|
MODE=${MODE:-"eagle3"}
|
|
EAGLE_DECODER_TYPE=${EAGLE_DECODER_TYPE:-"llama"}
|
|
# Set default OUTPUT_DIR to ckpts/{modelname}, where {modelname} is the last part of the model path
|
|
MODEL_BASENAME=$(basename "$MODEL")
|
|
OUTPUT_DIR=${OUTPUT_DIR:-"ckpts/${MODEL_BASENAME}-$(date +%Y%m%d_%H%M)"}
|
|
NUM_EPOCHS=${NUM_EPOCHS:-1}
|
|
SAVE_STEPS=${SAVE_STEPS:-$DEFAULT_SAVE_STEPS}
|
|
LR=${LR:-"1e-4"}
|
|
TRAIN_BS=${TRAIN_BS:-4}
|
|
MEDUSA_NUM_HEADS=${MEDUSA_NUM_HEADS:-1}
|
|
MEDUSA_NUM_LAYERS=${MEDUSA_NUM_LAYERS:-1}
|
|
TRAINING_SEQ_LEN=${TRAINING_SEQ_LEN:-2048}
|
|
OFFLINE_DATA_PATH=${OFFLINE_DATA_PATH:-""}
|
|
DISABLE_TQDM=${DISABLE_TQDM:-False}
|
|
VLM_PROCESSOR=${VLM_PROCESSOR:-}
|
|
VLM_IMG_DIR=${VLM_IMG_DIR:-}
|
|
AR_VALIDATE_STEPS=${AR_VALIDATE_STEPS:-1000}
|
|
ESTIMATE_AR=${ESTIMATE_AR:-False}
|
|
CP_SIZE=${CP_SIZE:-1}
|
|
DP_SHARD_SIZE=${DP_SHARD_SIZE:-$((GPU_COUNT/CP_SIZE))}
|
|
|
|
if [[ "$MODE" == "medusa" ]]; then
|
|
SPECULATIVE_ARGS="--medusa_num_heads $MEDUSA_NUM_HEADS --medusa_num_layers $MEDUSA_NUM_LAYERS"
|
|
elif [[ "$MODE" == "eagle1" || "$MODE" == "eagle3" ]]; then
|
|
if [[ -n "$EAGLE_CONFIG" ]]; then
|
|
SPECULATIVE_ARGS="--eagle_config $EAGLE_CONFIG"
|
|
else
|
|
SPECULATIVE_ARGS=""
|
|
fi
|
|
else
|
|
echo "Only medusa, eagle1, eagle3 supported for now!"
|
|
exit 1
|
|
fi
|
|
|
|
if [[ "$OFFLINE_DATA_PATH" != "" ]]; then
|
|
if [[ ! -d "$OFFLINE_DATA_PATH" ]]; then
|
|
echo "Offline data path $OFFLINE_DATA_PATH does not exist or is not a directory."
|
|
exit 1
|
|
else
|
|
OFFLINE_TRAINING_ARGS="--offline-data-path $OFFLINE_DATA_PATH --ar_validate_steps -1"
|
|
fi
|
|
else
|
|
OFFLINE_TRAINING_ARGS=""
|
|
fi
|
|
|
|
|
|
if [[ "$VLM_PROCESSOR" != "" ]]; then
|
|
VLM_ARGS="--vlm_processor $VLM_PROCESSOR --vlm_img_dir $VLM_IMG_DIR"
|
|
else
|
|
VLM_ARGS=""
|
|
fi
|
|
|
|
if [[ "$GPU_COUNT" -gt 1 ]]; then
|
|
#Use FSDP2 when multi GPU available
|
|
FSDP_ARGS="--fsdp 'full_shard' --fsdp_config fsdp_config.json"
|
|
else
|
|
#Otherwise, single GPU training
|
|
FSDP_ARGS=""
|
|
fi
|
|
|
|
|
|
# Disable tokenizers parallelism to avoid warning
|
|
export TOKENIZERS_PARALLELISM=False
|
|
CMD="accelerate launch --mixed_precision bf16 main.py \
|
|
--mode $MODE \
|
|
--eagle_decoder_type $EAGLE_DECODER_TYPE \
|
|
--model_name_or_path $MODEL \
|
|
--training_seq_len $TRAINING_SEQ_LEN \
|
|
--dataloader_drop_last True \
|
|
--bf16 True \
|
|
--output_dir $OUTPUT_DIR \
|
|
--num_train_epochs $NUM_EPOCHS \
|
|
--per_device_train_batch_size $TRAIN_BS \
|
|
--per_device_eval_batch_size $TRAIN_BS \
|
|
--gradient_accumulation_steps 1 \
|
|
--do_eval False \
|
|
--eval_accumulation_steps 1 \
|
|
--save_strategy steps \
|
|
--save_steps $SAVE_STEPS \
|
|
--learning_rate $LR \
|
|
--weight_decay 0.0 \
|
|
--warmup_steps 100 \
|
|
--lr_scheduler_type linear \
|
|
--logging_steps 100 \
|
|
--tf32 True \
|
|
--data_path $DATA \
|
|
--disable_tqdm $DISABLE_TQDM \
|
|
--estimate_ar $ESTIMATE_AR \
|
|
--ar_validate_steps $AR_VALIDATE_STEPS \
|
|
$VLM_ARGS \
|
|
$OFFLINE_TRAINING_ARGS \
|
|
$SPECULATIVE_ARGS \
|
|
$FSDP_ARGS \
|
|
--cp_size $CP_SIZE \
|
|
--dp_shard_size $DP_SHARD_SIZE \
|
|
"
|
|
|
|
start_time=$(date +%s)
|
|
sh -c "$CMD"
|
|
echo "Total time taken: $(( $(date +%s) - $start_time )) seconds"
|