math_rl_lora.sh

# Copyright 2025 Garena Online Private Limited
#
# 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.

# 1. Installation =========
# pip install vllm==0.8.4 && pip install -U oat-llm

# 2. Hyperparameter =========
GPUS=8
BATCH_SIZE=128
BATCH_SIZE_PER_DEVICE=1
ROLLOUT_PER_PROMPT=8
MAX_GENERATION=4096
MODEL=deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B
PROMPT_TEMPLATE=r1_distill_qwen
DATASET=lkevinzc/math-12k

# 3. Run =========
python -m oat.experiment.run_math_rl \
    --lora_rank $1 \
    --lora_alpha $(( $1 * 2 )) \
    --lora_dropout 0.05 \
    --critic_type drgrpo \
    --gpus $GPUS \
    --enable_prefix_caching \
    --collocate \
    --vllm_sleep \
    --vllm_gpu_ratio 0.35 \
    --gradient-checkpointing \
    --flash-attn \
    --bf16 \
    --learning_rate $2 \
    --lr_scheduler constant \
    --num_ppo_epochs 1 \
    --beta 0 \
    --oracle_type reward \
    --oracle math \
    --pretrain $MODEL \
    --prompt_template $PROMPT_TEMPLATE \
    --zero-stage 2 \
    --ref_offload \
    --prompt_data $DATASET \
    --train_split train \
    --input_key problem \
    --output_key answer \
    --max-train 9999999 \
    --num_prompt_epoch 20 \
    --prompt_max_length 1024 \
    --num_samples $ROLLOUT_PER_PROMPT \
    --temperature 1 \
    --top_p 1 \
    --generate_max_length $MAX_GENERATION \
    --save_steps -1 \
    --train_batch_size $BATCH_SIZE \
    --train_batch_size_per_device $BATCH_SIZE_PER_DEVICE \
    --rollout_batch_size $BATCH_SIZE \
    --rollout_batch_size_per_device $(( $BATCH_SIZE / $GPUS )) \
    --pi_buffer_maxlen_per_device $(( $BATCH_SIZE / $GPUS * $ROLLOUT_PER_PROMPT)) \
    --eval_batch_size 200 \
    --eval_steps 16 \
    --eval_temperature 0.6 \
    --eval_top_p 0.95 \
    --eval_n 32 \
    --eval_generate_max_length $MAX_GENERATION \
    --eval_data lkevinzc/math-eval \
    --test_split aime \
    --eval_input_key input \
    --use-wb \
    --wb-run-name RLVR-DrGRPO-$(basename "$MODEL")-$(basename "$DATASET")-LoraRank$1

# 4. Commands to reproduce experiments:
# bash examples/math_rl_lora.sh 0 0.000001 # Full fine-tuning with LR=1e-6
# bash examples/math_rl_lora.sh 1 0.00005 # LoRA with rank-1 with LR=5e-5