README.md

VinePPO: Unlocking RL Potential For LLM Reasoning Through Refined Credit Assignment

Amirhossein Kazemnejad*, Milad Aghajohari*, Eva Portelance, Alessandro Sordoni, Siva Reddy, Aaron Courville, Nicolas Le Roux

• Paper
• Abstract
• Updates
• Quick Start
  • Installation
  • Download the datasets
  • Create Experiment Script
  • Single GPU Training (Only for Rho models)
  • Running the experiments
• Initial SFT Checkpoints
• Acknowledgement
• Code Structure
  • Important files
• Citation

Code for reproducing the results in the VinePPO paper. This codebase also provides performant implementation (leveraging vLLM as inference engine*) of popular RL and RL-free baselines (such as PPO, DPO, and RestEM) for LLM reasoning.

*Generating up to 40K tok/sec on 8xH100 GPUs for 7B model

Paper

https://arxiv.org/abs/2410.01679

Abstract

Large language models (LLMs) are increasingly applied to complex reasoning tasks that require executing several complex steps before receiving any reward. Properly assigning credit to these steps is essential for enhancing model performance. Proximal Policy Optimization (PPO), a state-of-the-art reinforcement learning (RL) algorithm used for LLM finetuning, employs value networks to tackle credit assignment. However, value networks face challenges in predicting the expected cumulative rewards accurately in complex reasoning tasks, often leading to high-variance updates and suboptimal performance. In this work, we systematically evaluate the efficacy of value networks and reveal their significant shortcomings in reasoning-heavy LLM tasks, showing that they barely outperform a random baseline when comparing alternative steps. To address this, we propose VinePPO, a straightforward approach that leverages the flexibility of language environments to compute unbiased Monte Carlo-based estimates, bypassing the need for large value networks. Our method consistently outperforms PPO and other RL-free baselines across MATH and GSM8K datasets with fewer gradient updates (up to 9x), less wall-clock time (up to 3.0x). These results emphasize the importance of accurate credit assignment in RL finetuning of LLM and demonstrate VinePPO’s potential as a superior alternative to traditional value network-based methods.

Updates

• (Oct 1st, 2024) Initial release of VinePPO codebase.

Quick Start

Installation

This project is implemented based torch, Huggingface, FlashAttention, DeepSpeed, and vLLM libraries. To obtain the dependencies, we provide the following three ways:

1. Using pip

# Make sure torch 2.1.2 and cuda 12.1 is installed
pip install -r requirements.txt

2. Using Docker

sudo docker run \
  --ipc=host \
  --gpus all \
  kazemnejad/treetune:v15.1 \
  python -c "import torch; print(torch.__version__)"

Optional: You can use the following Dockerfile to build your own image

3. Using Singularity Container

singularity pull --arch amd64 library://realtreetune/dev/treetune:v15
singularity exec --nv treetune_v15.sif python -c "import torch; print(torch.__version__)"

Download the datasets

chmod a+x scripts/download_and_prepare_dataset.sh
./scripts/download_and_prepare_dataset.sh

Create Experiment Script

We first specify the configuration file for the experiment, and then, we explain how to run the training and evaluation using a configuration file.

VinePPO Experiments

• configs/polIter_rho1bSft2_vineppo_MATH.jsonnet
• configs/polIter_rho1bSft2_vineppo_GSM8K.jsonnet
• configs/polIter_deepseekSft2_vineppo_MATH.jsonnet
• configs/polIter_deepseekSft2_vineppo_GSM8K.jsonnet

PPO Experiments

• configs/polIter_rho1bSft2_ppo_MATH.jsonnet
• configs/polIter_rho1bSft2_ppo_GSM8K.jsonnet
• configs/polIter_deepseekSft2_ppo_MATH.jsonnet
• configs/polIter_deepseekSft2_ppo_GSM8K.jsonnet

DPO Experiments

• configs/polIter_rho1bSft2_dpo_positive_MATH.jsonnet
• configs/polIter_rho1bSft2_dpo_positive_GSM8K.jsonnet
• configs/polIter_deepseekSft2_dpo_positive_MATH.jsonnet
• configs/polIter_deepseekSft2_dpo_positive_GSM8K.jsonnet

RestEM Experiments

• configs/polIter_rho1bSft2_restem_MATH.jsonnet
• configs/polIter_rho1bSft2_restem_GSM8K.jsonnet
• configs/polIter_deepseekSft2_restem_MATH.jsonnet
• configs/polIter_deepseekSft2_restem_GSM8K.jsonnet

Once you have selected the configuration file, you can run the training and evaluation using the following script:

CONFIGSTR="configs/<config_file>.jsonnet"
APP_DIRECTORY="experiments/<path_to_output_dir>"

export APP_SEED="2746318213"
export WANDB_RUN_ID="<unique_wandb_run_id>" # Optional

NUM_GPUS=$(nvidia-smi --query-gpu=name --format=csv,noheader | wc -l)

# Run the training
deepspeed --no_local_rank --num_gpus=$NUM_GPUS  \
         src/treetune/main.py --configs "$CONFIGSTR" \
            run_iteration_loop

# Run the evaluation
deepspeed --no_local_rank --num_gpus=$NUM_GPUS   \
         src/treetune/main.py --configs "$CONFIGSTR" \
            run_evaluation

This setup was tested on 4x A100 80GB GPUs for Rho models and 8x H100 80GB GPUs for DeepSeek models.

PS: Refer to src/treetune/runtime/policy_iteration_runtime.py if you'd like to start reading the codebase.

Single GPU Training (Only for Rho models)

Add this config configs/trainers/devBz16.jsonnet to the $CONFIGSTR variable in the script above:

CONFIGSTR="configs/<config_file>.jsonnet,\
configs/trainers/devBz16.jsonnet"

Note that this is not fully tested and you may need to adjust the batch size to fit your GPU memory.

Running the experiments

To run the experiments, you can use the following script:

1. Normal local run

chmod +x run.sh
./run.sh

2. Running inside docker

mkdir -p experiments
docker run \
    --ipc=host \
    --gpus all \
    -v "$(pwd)":/src \
    --workdir /src \
    kazemnejad/treetune:v15.1 \
    ./run.sh

3. Running inside singularity

mkdir -p experiments
chmod a+x run.sh
singularity exec --nv \
	-H $(pwd):$HOME \
	-B $(pwd)/experiments:$HOME/experiments \
	/path/to/singularity/image/treetune_v15.sif \
	./run.sh

Initial SFT Checkpoints

Base Model \ SFT Dataset	GSM8K	MATH
DeepSeekMath 7B	🤗 Deepseekmath-SFT-GSM8K	🤗 Deepseekmath-SFT-MATH
RhoMath 1.1B	🤗 Rhomath-SFT-GSM8K	🤗 Rhomath-SFT-MATH

Acknowledgement

This is the release codebase for VinePPO. It is developed by @kazemnejad and @miladink.

This codebase takes pieces from the guidance, OpenAI PRM Repo, and DeepSeekMath.

Code Structure

• configs: Contains Jsonnet files for configuring experiment settings.
• src/treetune: The main directory for source code, encompassing:
  • models: Contains model loading, with pretrained.py the central piece to load HF models.
  • episode_generators: Manages the episode generation pipelines. The math_episode_generator.py script is key for PPO episode generation and math_episode_generator_with_mc_advantages.py creates the episodes for VinePPO.
  • trainers: Contains trainer classes, with ppo_trainer.py is the main PPO trainer which is shared between PPO and VinePPO.
  • runtime: Integrates components and implements training and evaluation procedures. The policy_iteration_runtime.py script is the starting point for running experiments.
• src/guidance: We ship the guidance module directly with the codebase.

Important files

Trainers:

• ppo_trainer.py: The main PPO trainer which is shared between PPO and VinePPO.
• dpo_positive_trainer.py: The DPO-Positive trainer.
• restem_trainer.py: The RestEM trainer.

Episode Generators:

• math_episode_generator.py: The PPO episode generator.
• math_episode_generator_with_mc_advantages.py: The VinePPO episode generator. This class contains the implementation for Monte Carlo value estimation.
• math_dpo_positive_episode_generator.py: The DPO-Positive episode generator, which generate positive and negative pairs for DPO.
• math_restem_episode_generator.py: The RestEM episode generator.

Tasks:

• math.py: The main task file for MATH dataset.
• gsm8k.py: The main task file for GSM8K dataset.
• math_grader_minerva.py: The grader for MATH dataset.
• math_extract_steps_inplace: The helper script to split MATH-style solutions into steps.

Other:

• policy_iteration_runtime.py: The main runtime script for running experiments including training and evaluation.
• vllm_server.py: The handler class for vLLM inference engine.
• cot_inference_strategy.py: The main class we use for running inferences with vLLM API.

Citation

@misc{Kazemnejad2024:VinePPO,
      title={VinePPO: Unlocking RL Potential For LLM Reasoning Through Refined Credit Assignment}, 
      author={Amirhossein Kazemnejad and Milad Aghajohari and Eva Portelance and Alessandro Sordoni and Siva Reddy and Aaron Courville and Nicolas Le Roux},
      year={2024},
      eprint={2410.01679},
      archivePrefix={arXiv},
      primaryClass={cs.LG},
      url={https://arxiv.org/abs/2410.01679}, 
}