qerl-quantization-rl

Combine NFVP4 quantization with LoRA to accelerate RL rollout phases while using quantization noise as implicit exploration bonus. Achieve 1.5x speedup and better strategy discovery through noise-enha

SKILL.md

GitHub

QeRL: Quantization-Enhanced RL Training for Efficient Scaling

RL training for large language models is computationally expensive, requiring full-precision model copies for both policy and rollout generation. QeRL uses model quantization to reduce memory overhead while discovering a surprising benefit: quantization noise acts as natural exploration bonus, improving strategy discovery.

Core insight: quantization isn't just compression—the numerical noise in quantized models increases policy entropy, encouraging better exploration during RL training. Combined with LoRA adaptation, this enables efficient RL on smaller GPUs.

Core Concept

Quantization-Enhanced Rollout: Replace full-precision rollout generation with quantized models, reducing memory requirements and enabling faster rollout phase computation.

Noise-as-Exploration: The numerical precision loss in quantization creates stochastic variations that boost policy entropy exploration, helping discover better strategies that full-precision training misses.

Adaptive Quantization Noise: Dynamically adjust quantization noise levels during training to optimize exploration-exploitation tradeoff.

Architecture Overview

  • Quantization Layer: NFVP4 quantization for model compression
  • LoRA Adapter: Low-rank adaptation layers for efficient fine-tuning
  • Noise Monitor: Tracks quantization noise levels and exploration impact
  • Adaptive Scheduler: Adjusts quantization precision based on training progress

Implementation Steps

Stage 1: Model Quantization with LoRA Setup

Prepare quantized model with efficient adaptation:

import torch
from transformers import AutoModelForCausalLM, BitsAndBytesConfig
import bitsandbytes as bnb
from peft import LoraConfig, get_peft_model

def setup_quantized_rl_model(model_name='llama-32b', device='cuda'):
    """
    Configure model with NFVP4 quantization and LoRA for RL training.
    """

    # NFVP4 quantization config
    quantization_config = BitsAndBytesConfig(
        load_in_4bit=True,
        bnb_4bit_compute_dtype=torch.float16,
        bnb_4bit_use_double_quant=True,
        bnb_4bit_quant_type='nf4'
    )

    # Load quantized model
    model = AutoModelForCausalLM.from_pretrained(
        model_name,
        quantization_config=quantization_config,
        device_map='auto'
    )

    # LoRA config for efficient fine-tuning
    lora_config = LoraConfig(
        r=16,
        lora_alpha=32,
        target_modules=['q_proj', 'v_proj'],
        lora_dropout=0.05,
        bias='none',
        task_type='CAUSAL_LM'
    )

    # Apply LoRA
    model = get_peft_model(model, lora_config)

    return model, quantization_config

# Setup
model, quant_config = setup_quantized_rl_model()
print(f"Model trainable params: {model.get_nb_trainable_parameters()}")

Stage 2: Rollout Generation with Quantized Models

Use quantized models for faster rollout:

def generate_quantized_rollout(
    quantized_model,
    policy_prompts,
    num_rollouts=4,
    max_length=256
):
    """
    Generate rollout trajectories using quantized model.
    Quantization noise provides exploration boost.
    """

    rollout_trajectories = []

    for prompt in policy_prompts:
        prompt_tokens = tokenize(prompt)

        # Generate multiple rollouts per prompt
        for _ in range(num_rollouts):
            # Temperature sampling to expose quantization noise impact
            with torch.no_grad():
                outputs = quantized_model.generate(
                    prompt_tokens,
                    max_length=max_length,
                    temperature=1.0,
                    top_p=0.95,
                    do_sample=True,
                    output_scores=True
                )

            trajectory = {
                'prompt': prompt,
                'response': tokenize_decode(outputs),
                'tokens': outputs,
                'policy_logprobs': compute_logprobs(outputs)
            }
            rollout_trajectories.append(trajectory)

    return rollout_trajectories

Stage 3: Noise-Aware Exploration Tracking

Monitor quantization noise and its exploration benefits:

def compute_quantization_noise_metrics(
    full_precision_outputs,
    quantized_outputs,
    policy_logprobs
):
    """
    Measure quantization noise and its effect on exploration.
    """

    # KL divergence between full and quantized outputs
    kl_divergence = torch.nn.functional.kl_div(
        torch.log_softmax(quantized_outputs, dim=-1),
        torch.softmax(full_precision_outputs, dim=-1)
    )

    # Policy entropy from quantized generation
    policy_entropy = -(
        torch.softmax(quantized_outputs, dim=-1) *
        policy_logprobs
    ).sum(dim=-1).mean()

    # Entropy gain vs full precision
    full_entropy = -(
        torch.softmax(full_precision_outputs, dim=-1) *
        torch.log(torch.softmax(full_precision_outputs, dim=-1) + 1e-10)
    ).sum(dim=-1).mean()

    entropy_gain = policy_entropy - full_entropy

    return {
        'kl_divergence': kl_divergence.item(),
        'policy_entropy': policy_entropy.item(),
        'entropy_gain': entropy_gain.item()
    }

# Track metrics during training
metrics_history = []
for step in range(training_steps):
    rollouts = generate_quantized_rollout(model, prompts)
    noise_metrics = compute_quantization_noise_metrics(
        full_outputs,
        quantized_outputs,
        policy_logprobs
    )
    metrics_history.append(noise_metrics)

Stage 4: Adaptive RL Training Loop

Integrate quantization into RL training:

def qerl_training_loop(
    model,
    data_loader,
    num_epochs=5,
    initial_noise_level=0.5
):
    """
    Train policy with quantization-enhanced exploration.
    Adaptively adjust noise level based on exploration metrics.
    """

    optimizer = torch.optim.AdamW(
        model.parameters(),
        lr=2e-4
    )

    noise_schedule = initial_noise_level
    best_entropy = 0

    for epoch in range(num_epochs):
        for batch_idx, (prompts, rewards) in enumerate(data_loader):
            # Generate rollouts with current noise level
            rollouts = generate_quantized_rollout(
                model,
                prompts,
                num_rollouts=4
            )

            # Compute policy loss
            policy_losses = []
            exploration_bonuses = []

            for rollout, reward in zip(rollouts, rewards):
                # Standard policy gradient
                log_prob = rollout['policy_logprobs'].sum()
                pg_loss = -(log_prob * reward)

                # Exploration bonus from quantization noise
                entropy_bonus = compute_quantization_noise_metrics(
                    full_outputs,
                    rollout['tokens'],
                    rollout['policy_logprobs']
                )['entropy_gain']
                exploration_bonus = entropy_bonus * 0.1

                policy_losses.append(pg_loss)
                exploration_bonuses.append(exploration_bonus)

            # Total loss
            total_loss = torch.stack(policy_losses).mean()
            total_loss = total_loss - torch.stack(exploration_bonuses).mean()

            # Update
            optimizer.zero_grad()
            total_loss.backward()
            optimizer.step()

            # Adaptive noise scheduling
            avg_entropy = np.mean([
                m['entropy_gain'] for m in metrics_history[-100:]
            ])

            if avg_entropy > best_entropy:
                best_entropy = avg_entropy
                noise_schedule = min(noise_schedule + 0.05, 1.0)
            else:
                noise_schedule = max(noise_schedule - 0.02, 0.1)

Practical Guidance

When to Use QeRL:

  • RL training with limited GPU memory (single GPU to multi-GPU)
  • Tasks where exploration is bottleneck (complex reasoning, diverse outputs)
  • When computational efficiency matters more than peak performance

When NOT to Use:

  • Tasks requiring full-precision numerical stability
  • When exploration bonus from noise isn't relevant
  • Single-epoch training where startup overhead dominates

Quantization Strategy Comparison:

Approach Memory Speed Exploration
Full Precision Baseline Baseline Baseline
NFVP4 Only 75% reduction 1.5x faster Slight increase
NFVP4 + LoRA 85% reduction 1.5x faster Significant increase
Double Quant 80% reduction 1.3x faster Similar to NFVP4

Common Pitfalls:

  • Quantizing policy model but not rollout (loses memory benefit)
  • Noise level too low (ineffective exploration)
  • Not tracking entropy metrics (miss optimal noise schedule)
  • Using full precision for reference comparisons during training

Reference

Based on the research at: https://arxiv.org/abs/2510.11696