simpo-training

Run reference-free SimPO preference optimization with accelerate and DeepSpeed.

Updated May 2, 2026
One-click install
npx skills add https://github.com/qcmuu/AI-Research-Skills --skill simpo-training-qcmuu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simpo-training
Source: https://github.com/qcmuu/AI-Research-Skills/tree/main/06-post-training/simpo
Command: npx skills add https://github.com/qcmuu/AI-Research-Skills --skill simpo-training-qcmuu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires torch, transformers, datasets, trl, accelerate, and includes references (resource) components.

What problem does it solve?

This Skill solves the problem of aligning an LLM to human preferences by training on chosen-versus-rejected responses without requiring a separate reference model, reducing setup cost while improving preference performance.

Core Features & Use Cases

  • Reference-free preference optimization: Implements SimPO as a DPO alternative that does not need π_ref, making training simpler and more efficient.
  • Drop-in training workflows: Provides practical end-to-end guidance for configuring and launching SimPO runs on base models and instruct models using Accelerate + DeepSpeed ZeRO-3.
  • Preference-alignment controls: Covers key hyperparameters such as beta, gamma_beta_ratio, loss_type (sigmoid/hinge), and sft_weight to balance alignment strength vs capability retention.
  • Debugging and tuning guidance: Diagnoses common issues like loss divergence, forgetting, poor preference separation, and OOM by adjusting learning rate, beta, margins, and SFT regularization.

Use cases:

  • Align a base LLM to follow instructions better using general preference datasets.
  • Fine-tune an instruct/chat model for preference alignment while minimizing capability regression by adding SFT regularization.
  • Optimize math/code reasoning alignment by using lower learning rates and stronger margin settings.

Quick Start

Use the simpo-training skill to train SimPO on Mistral 7B by running accelerate launch with the deepspeed_zero3 config and a SimPO training config YAML.

Frequently Asked Questions about simpo-training

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is reference-free preference optimization for LLM alignment?

SimPO is a DPO alternative that aligns LLMs using chosen versus rejected response pairs without maintaining a separate reference policy, reducing setup cost while improving preference performance.

How do I configure SimPO training hyperparameters like beta and loss type?

SimPO training allows configuring beta, gamma_beta_ratio margins, selecting sigmoid or hinge loss types, and optionally adding SFT regularization to balance alignment strength against capability retention.

Can I run distributed preference optimization using accelerate and DeepSpeed?

Yes, SimPO training launches distributed training through accelerate and DeepSpeed ZeRO-3, providing drop-in end-to-end workflows for configuring and running preference alignment on base and instruct models.

How do I fix loss divergence or OOM issues during SimPO training?

Debug loss divergence, forgetting, and OOM by adjusting learning rate, beta, margin settings, and SFT regularization to stabilize reference-free preference optimization.

Does SimPO work for fine-tuning math and code reasoning models?

Yes, SimPO optimizes math and code reasoning alignment by using lower learning rates and stronger margin settings to prevent capability regression on instruct and reasoning-focused models.