Rethinking-OPD

拆解大模型在线蒸馏为何翻车,给出可复现配方

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 模型训练 🍴 复刻 77 👀 关注 1
GitHub ↗
GitHub 星标 ★ 1065
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源研究代码,免费使用

项目预览

Rethinking-OPD 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类模型训练
开发团队Thinking-Space
定价模式🏷️完全免费
价格说明开源研究代码,免费使用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
主要语言Python
技术栈/模型llms,mechanism,on-policy-distillation
GitHub 星标★ 1065
上线时间2026-04-12 00:00:00
代码更新2026-08-20
仓库体积59.9 MB
本站数据更新2026-11-05
维护状态维护中
收录时间2026-09-15
浏览次数1

项目介绍

Rethinking-OPD 是一个围绕大语言模型在线策略蒸馏(On-Policy Distillation, OPD)展开的研究型开源项目,配套论文《Rethinking On-Policy Distillation of Large Language Models: Phenomenology, Mechanism, and Recipe》。它要解决的问题是:现有 OPD 方法虽然被广泛用于把强教师模型的能力迁移到小模型,但训练中常出现不稳定、效果不如预期甚至退化,社区缺乏对背后机制的清晰解释。项目从现象学、机制和配方三个层面系统剖析 OPD,提供可复现的训练与评测代码,帮助研究者定位蒸馏失效的原因,并给出更稳健的蒸馏配置建议。核心能力包括:在线策略蒸馏实验框架、现象与机制分析工具、以及可复用的训练配方。适合做模型压缩、能力迁移和蒸馏算法改进的研究者与工程师参考。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-15 · 当前星标 ★ 1065

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 30 分钟 部署方式:本地安装 6 步

环境要求

  • 已安装 conda,用于创建隔离环境
  • verl 环境使用 Python 3.12
  • LlamaFactory 环境使用 Python 3.11
  • 需要事先准备 verl v0.7.0 与 LlamaFactory v0.9.5 的源码目录

安装与启动步骤

  1. 1创建 verl 环境

    用 conda 新建名为 verl 的 Python 3.12 环境,用于 OPD 与 RL 相关训练。

    conda create -n verl python==3.12
  2. 2激活 verl 环境

    切换到刚创建的环境,后续安装命令都要在该环境内执行。

    conda activate verl
  3. 3安装训练依赖

    进入 verl 源码目录,以 USE_MEGATRON=0 关闭 Megatron 后端,运行官方脚本安装 vLLM/SGLang/MCore 依赖。

    cd verl/
    USE_MEGATRON=0 bash scripts/install_vllm_sglang_mcore.sh
  4. 4安装 math-verify

    在 verl 环境中补充安装数学答案校验依赖 math-verify。

    pip install math-verify
  5. 5创建 SFT 环境

    SFT 训练使用 Python 3.11,需另建一个名为 sft 的环境,与 verl 环境分开。

    conda create -n sft python==3.11
  6. 6安装 LlamaFactory

    进入 LlamaFactory 源码目录,以可编辑模式安装本体,并装 metrics 额外依赖。

    cd LlamaFactory/
    pip install -e .
    pip install -r requirements/metrics.txt

如何确认成功

README 未给出验证方式;可执行 conda activate verl 后用 pip list 确认依赖已装入。

常见问题

Q:为什么环境要建两个?

A:README 中 OPD/RL 基于 verl 用 Python 3.12,SFT 基于 LlamaFactory 用 Python 3.11,两者版本不同,建议各建独立 conda 环境避免冲突。

Q:README 没有给 git clone 命令怎么办?

A:需自行从 verl 与 LLaMA-Factory 官方仓库获取 v0.7.0、v0.9.5 版本源码,准备好 verl/ 与 LlamaFactory/ 两个目录后再执行安装。

Q:安装脚本执行失败怎么办?

A:先确认当前位于 verl/ 目录下,且命令中保留了 USE_MEGATRON=0 前缀,它决定是否启用 Megatron 后端。

注意事项

  • README 未提供代码下载命令,需自行准备 verl v0.7.0 与 LlamaFactory v0.9.5 源码目录。
  • USE_MEGATRON=0 表示不使用 Megatron 后端,该安装脚本必须在 verl/ 目录内执行。
  • OPD/RL 环境(Python 3.12)与 SFT 环境(Python 3.11)不可混用。
  • README 未给出训练、评测入口与配置文件说明,具体运行方式请结合仓库与论文进一步确认。

核心亮点

  • 从现象、机制到配方三层递进分析,不止给结论还给出可复现实验代码
  • 聚焦在线策略蒸馏这一实际训练痛点,对蒸馏不稳定问题有针对性诊断
  • 基于真实大模型蒸馏实验,结论对模型压缩与能力迁移有直接参考价值

不足之处

  • 偏研究性质,工程化封装和开箱即用程度有限
  • 文档与社区生态仍在早期,长期维护情况待观察

适用场景

  • 研究大模型蒸馏算法、想理解 OPD 失效机制
  • 需要把强教师模型能力迁移到小模型时参考训练配方
  • 复现论文实验或在此基础上改进蒸馏方法

替代项目

MiniLLM、DistiLLM、GKD

上一篇:LLaMEA

下一篇:d1

同类项目推荐

AutoTimes 开源

用大模型直接做时间序列预测,无需改架构

Official implementation for "AutoTimes: Autoregressive Time Series Forecasters via L···

★ 269 2026-08-09
FATE-LLM 开源

数据不出域,多方联合微调大模型

Federated Learning for LLMs.

★ 273 2026-09-16
Lora-for-Diffusers 开源

手把手教你用LoRA微调扩散模型,从入门到实战

The most easy-to-understand tutorial for using LoRA (Low-Rank Adaptation) within dif···

★ 820 2026-08-09
voice_clone_lab 开源

几分钟音频克隆音色,本地微调生成专属语音

Clone a voice from a few minutes of audio and generate speech locally: Qwen3-TTS fin···

★ 155 2026-08-09
litgpt 开源

一条命令搞定大模型预训练、微调和部署,省时省力

20+ high-performance LLMs with recipes to pretrain, finetune and deploy at scale.

★ 13746 2026-08-09
SoftCoT 开源

用软思维链替代文本推理,大幅降低 LLM 推理成本

ACL'2025: SoftCoT: Soft Chain-of-Thought for Efficient Reasoning with LLMs. and prep···

★ 96 2026-08-09
AI-Toolkit-Easy-Install 开源

Windows 上一键装好 AI 微调工具,免折腾环境直接开训

One-click Portable Windows installation of 'AI-Toolkit by Ostris'

★ 539 2026-08-09
IPR 开源

逐步纠错,让LLM智能体每一步都走对

Watch Every Step! LLM Agent Learning via Iterative Step-level Process Refinement (E···

★ 67 2026-08-09
LLM-Finetuning 开源

用PEFT低成本微调大模型,快速适配下游任务

LLM Finetuning with peft

★ 2993 2026-08-09