- 分布式训练库
- 结束
分布式训练库
常见框架
常见的分布式训练框架:
- 第一类:深度学习框架自带分布式训练功能。如:TensorFlow、PyTorch、MindSpore、Oneflow、PaddlePaddle等。
- 第二类:基于现有深度学习框架(如:PyTorch、Flax)进行扩展和优化,从而进行分布式训练。
- 如:
Megatron-LM
(张量并行)、DeepSpeed
(Zero-DP)、Colossal-AI
(高维模型并行,如2D、2.5D、3D)、Alpa
(自动并行)等
- 如:
训练框架 | 诞生时间 | 作者 | 功能 | 分析 |
---|---|---|---|---|
DeepSpeed | ||||
LLama-Factory | 2023-6-3 | 北航博士生 | 多种模型快捷微调 | 必须依赖: torch/transformers/datasets/trl/accelerate/peft 可选依赖: CUDA/deepspeed/bitsandbytes/vllm/flash-attn |
TorchTune | ||||
trl | ||||
trlx | ||||
Firefly | ||||
Xtuner | ||||
SWIFT | ||||
LLM 复现选择
如何选择分布式训练框架? 参考
- 训练成本:不同训练工具,训练同样大模型,成本不一样。对于大模型,训练一次动辄上百万/千万美元的费用。合适的成本始终是正确的选择。
- 训练类型:是否支持数据并行、张量并行、流水线并行、多维混合并行、自动并行等
- 效率:将普通模型训练代码变为分布式训练所需编写代码的行数,希望越少越好。
- 灵活性:选择的框架是否可以跨不同平台使用?
目前训练超大规模语言模型主要有两条技术路线:
- TPU + XLA + TensorFlow/JAX :由Google主导,由于TPU和自家云平台GCP深度绑定
- GPU + PyTorch + Megatron-LM + DeepSpeed :由 NVIDIA、Meta、MicroSoft 大厂加持,社区氛围活跃,也更受到大家欢迎。
DeepSpeed – 微软
DeepSpeed 是 Microsoft 基于 PyTorch 研发的开源深度学习优化库。
- 目的: 降低大模型训练的门槛,提升大模型的训练的效率,帮助开发者更有效率地管理及优化大模型的训练、部署任务。
详见站内专题: DeepSpeed
【2023-8-28】LLaMA Efficient Tuning
方法 | 全参数训练 | 部分参数训练 | LoRA | QLoRA |
---|---|---|---|---|
预训练 | ✅ | ✅ | ✅ | ✅ |
指令监督微调 | ✅ | ✅ | ✅ | ✅ |
奖励模型训练 | ✅ | ✅ | ||
PPO 训练 | ✅ | ✅ | ||
DPO 训练 | ✅ | ✅ | ✅ |
trl
【2024-3-13】TRL - Transformer Reinforcement Learning
huggingface 推出的全栈库,包含一整套工具,用于使用强化学习 (Reinforcement Learning) 训练 transformer 语言模型。
- 从监督调优 (Supervised Fine-tuning step, SFT),到训练奖励模型 (Reward Modeling),再到近端策略优化 (Proximal Policy Optimization),全面覆盖
- TRL 库已经与 🤗 transformers 集成,直接使用!
- 👉 文档地址
API 文档里功能:
- Model Class: 公开模型各自用途
- SFTTrainer: SFTTrainer 实现模型监督调优
- RewardTrainer: RewardTrainer 训练奖励模型
- PPOTrainer: PPO 算法对经过监督调优的模型再调优
- Best-of-N Samppling: 将“拔萃法”作为从模型的预测中采样的替代方法
- DPOTrainer: 用 DPOTrainer 完成直接偏好优化
文档中给出了几个例子:
- Sentiment Tuning: 调优模型以生成更积极的电影内容
- Training with PEFT: 执行由 PEFT 适配器优化内存效率的 RLHF 训练
- Detoxifying LLMs: 通过 RLHF 为模型解毒,使其更符合人类的价值观
- StackLlama: 在 Stack exchange 数据集上实现端到端 RLHF 训练一个 Llama 模型
- Multi-Adapter Training: 使用单一模型和多适配器实现优化内存效率的端到端训练
Trl 实践
【2023-6-30】使用TRL强化学习PPO控制文本的生成
步骤
- 初始化 GPT2 对话模型, 即LLM模型。Huggface中的这个中文对话模型
- 初始化一个情感分类模型即RM模型。这里笔者使用的是Huggface中的这个情感分类模型
- 样本情感极性越正向,模型输出的得分越大。
- c2-roberta-base-finetuned-dianping-chinese
- 通过PPO强化学习算法,利用情感分类模型评估对话模型的输出,对GPT2对话模型进行优化,让GPT2对话模型的输出的结果在情感分类模型中得到高分。同时不破坏GPT2对话模型输出通顺对话的能力。
强行学习训练
- 输入样本给GPT2, 拿到对话语言模型 GPT2的输出。
- 将对话语言模型GPT2的输出 输入到 情感分类模型 拿到 情感分类模型的输出,作为reward。
- 将对话语言模型GPT2 输入,输出, 以及 情感分类模型的 reward 一并输入给PPO优化器,让PPO优化器去优化对话语言模型GPT2。
import torch
from transformers import AutoTokenizer
from trl import PPOTrainer, PPOConfig, AutoModelForCausalLMWithValueHead, create_reference_model
from trl.core import respond_to_batch
import random
import torch.nn.functional as F
# get models
gen_model = AutoModelForCausalLMWithValueHead.from_pretrained('dialoggpt/')
model_ref = create_reference_model(gen_model)
tokenizerOne = AutoTokenizer.from_pretrained('dialoggpt/',padding_side='left')
tokenizerOne.eos_token_id = tokenizerOne.sep_token_id
# 初始化一个情感分类模型,输入文本,判断文本的情感极性
from transformers import AutoModelForSequenceClassification , AutoTokenizer, pipeline
ts_texts = ["我喜欢下雨。", "我讨厌他."]
cls_model = AutoModelForSequenceClassification.from_pretrained("./chineseSentiment/", num_labels=2)
tokenizerTwo = AutoTokenizer.from_pretrained("./chineseSentiment/")
classifier = pipeline('sentiment-analysis', model=cls_model, tokenizer=tokenizerTwo)
classifier(ts_texts)
# 数据预处理
from torch.utils.data import Dataset
import torch.nn.utils.rnn as rnn_utils
import json
data = []
with open("./train.txt", "r", encoding="utf-8") as f:
for i in f.readlines():
line = json.loads(i)
data.append(line)
def preprocess_conversation(data):
sep_id = tokenizerOne.sep_token_id
cls_id = tokenizerOne.cls_token_id
dialogue_list = []
for conver in data:
input_ids = [cls_id]
start = conver["conversation"][0]
# print(start["utterance"])
input_ids += tokenizerOne.encode(start["utterance"], add_special_tokens=False)
input_ids.append(sep_id)
dialogue_list.append(input_ids)
return dialogue_list
# 数据处理
dialogue_list = preprocess_conversation(data)
class MyDataset(Dataset):
def __init__(self, data):
self.data = data
def __getitem__(self, index):
x = self.data[index]
return torch.tensor(x)
def __len__(self):
return len(self.data)
mydataset = MyDataset(dialogue_list)
def collate_fn(batch):
padded_batch = rnn_utils.pad_sequence(batch, batch_first=True, padding_value=tokenizerOne.sep_token_id)
return padded_batch
# 定义PPO优化器: 学习率,强化学习steps,batch_size等参数,学习率不宜调大,容易把LLM语言模型调坏。
config = PPOConfig(
model_name="gpt2-positive",
learning_rate=1.41e-5,
steps = 2000,
batch_size = 16
)
ppo_trainer = PPOTrainer(config, gen_model, model_ref, tokenizerOne, dataset=mydataset, data_collator=collate_fn)
rewards_list = []
for epoch, batch in enumerate(ppo_trainer.dataloader):
#### Get response from gpt2
query_tensors = []
response_tensors = []
query_tensors = [torch.tensor(t).long() for t in batch]
for query in batch:
input_ids = query.unsqueeze(0)
response = []
for _ in range(30):
outputs = ppo_trainer.model(input_ids=input_ids)
logits = outputs[0]
next_token_logits = logits[0, -1, :]
next_token_logits[ppo_trainer.tokenizer.convert_tokens_to_ids('[UNK]')] = -float('Inf')
next_token = torch.multinomial(F.softmax(next_token_logits, dim=-1), num_samples=1)
if next_token == ppo_trainer.tokenizer.sep_token_id: #
break
input_ids = torch.cat((input_ids, next_token.unsqueeze(0)), dim=1)
response.append(next_token.item())
response_tensors.append(torch.Tensor(response).long())
responseSet = ["".join(ppo_trainer.tokenizer.convert_ids_to_tokens([i.item() for i in r])) for r in response_tensors]
print(responseSet)
#### Get reward from sentiment model
pipe_outputs = classifier(responseSet)
rewards = [torch.tensor(output["score"]) for output in pipe_outputs]
#### Run PPO step
stats = ppo_trainer.step(query_tensors, response_tensors, rewards)
print("epoch{}, reword is {}".format(epoch, sum(rewards)))
rewards_list.append(sum(rewards))
Trainer
Trainer 名称歧义
- PyTorch Lightning有个 Trainer
- HuggingFace Transformers也有 Trainer
- 还有一些github上封装的或者基于这两个继续封装的Trainer
这里的 Trainer 指 Huggingface 的 Trainer 训练框架
Trainer 介于原生 torch 和 pytorch-lighning 之间,是轻量级的辅助torch模型训练的utils,因为其实稍微改造一下,huggingface的trainer 可用来训练常规的非nlp的torch模型。
- 封装程度:
torch
<pytorch lightning
<trainer
Trainer 封装了 PyTorch 训练过程,包括:前向传播、反向传播和参数更新等步骤,用户只需要设计模型,调参就行
高级的 Trainer 加上了各种功能,比如:日志记录,断点重训,训练方式与精度,支持各种分布式训练框架像原生、Apex、Deepspeed和Fairscale,支持自定的回调函数等等
Lightning 官网的一张gif还是比较生动形象
Trainer 定义
do_train,do_eval,do_predict 这三个参数和trainer没什么关系
自定义
model_init
model_init
def model_init():
model = AutoModelForSequenceClassification.from_pretrained(
model_args.model_name_or_path,
from_tf=bool(".ckpt" in model_args.model_name_or_path),
config=config,
cache_dir=model_args.cache_dir,
revision=model_args.model_revision,
use_auth_token=True if model_args.use_auth_token else None
)
return model
compute_metrics
def compute_metrics(p: EvalPrediction) -> Dict:
preds,labels=p
preds = np.argmax(preds, axis=-1)
#print('shape:', preds.shape, '\n')
precision, recall, f1, _ = precision_recall_fscore_support(lables.flatten(), preds.flatten(), average='weighted', zero_division=0)
return {
'accuracy': (preds == p.label_ids).mean(),
'f1': f1,
'precision': precision,
'recall': recall
}
加权loss
分类任务中,类目不均衡时,采用加权loss
做法
- (1) 继承 Trainer 类, 重定义 compute_loss 函数
- (2) 使用回调函数 callback
示例
- 三分类问题,各类目加权 1 : 2 : 3
from torch import nn
from transformers import Trainer
class CustomTrainer(Trainer):
def compute_loss(self, model, inputs, return_outputs=False):
labels = inputs.pop("labels")
# forward pass
outputs = model(**inputs)
logits = outputs.get("logits")
# compute custom loss (suppose one has 3 labels with different weights)
loss_fct = nn.CrossEntropyLoss(weight=torch.tensor([1.0, 2.0, 3.0], device=model.device))
loss = loss_fct(logits.view(-1, self.model.config.num_labels), labels.view(-1))
return (loss, outputs) if return_outputs else loss
参数详解
Trainer 官网文档,版本为4.34.0
Trainer类 参数
Transformers Trainer类 参数:
model
(PreTrainedModel
或torch.nn.Module
, 可选):训练、评估或预测的实例化模型- 如果不提供,必须传递一个
model_init
来初始化一个模型。
- 如果不提供,必须传递一个
args
(TrainingArguments, 可选):训练参数- 如果不提供,用 TrainingArguments 默认参数,其中 output_dir 设置为当前目录中的名为 “tmp_trainer” 的目录。
data_collator
(DataCollator, 可选):用于从 train_dataset 或 eval_dataset 中构成batch的函数- 如果未提供tokenizer,将默认使用 default_data_collator();如果提供,将使用 DataCollatorWithPadding 。
train_dataset
(torch.utils.data.Dataset
或 torch.utils.data.IterableDataset
, 可选):训练数据集- 如果是 torch.utils.data.Dataset,则会自动删除模型的 forward() 方法不接受的列。
eval_dataset
(Union[torch.utils.data.Dataset, Dict[str, torch.utils.data.Dataset]), 可选):同上,评估数据集- 如果是字典,将对每个数据集进行评估,并在指标名称前附加字典的键值。
tokenizer
(PreTrainedTokenizerBase, 可选):预处理数据的分词器- 如果提供,将在批量输入时自动对输入进行填充到最大长度,并会保存在模型目录下中,为了重新运行中断的训练或重复微调模型时更容易进行操作。
model_init
(Callable[[], PreTrainedModel], 可选):模型实例化函数- 如果提供,每次调用 train() 时都会从此函数给出的模型的新实例开始。
compute_metrics
(Callable[[EvalPrediction]
, Dict], 可选):评估时计算指标的函数,必须接受 EvalPrediction 作为入参,并返回一个字典,其中包含了不同性能指标的名称和相应的数值,一般是准确度、精确度、召回率、F1 分数等。callbacks
(TrainerCallback 列表, 可选):自定义回调函数- 如果要删除使用的默认回调函数,要使用 Trainer.remove_callback() 方法。
optimizers
(Tuple[torch.optim.Optimizer, torch.optim.lr_scheduler.LambdaLR], 可选):指定包含优化器和学习率调度器的元组(Tuple)- 元组的两个元素分别是优化器(torch.optim.Optimizer)和学习率调度器(torch.optim.lr_scheduler.LambdaLR),默认会创建一个基于AdamW优化器的实例,并使用 get_linear_schedule_with_warmup() 函数创建一个学习率调度器。
preprocess_logits_for_metrics
(Callable[[torch.Tensor, torch.Tensor], torch.Tensor], 可选):指定函数,每次评估步骤(evaluation step)前,进入compute_metrics函数前对模型的输出 logits 进行预处理。- 接受两个张量(tensors)作为参数,一个是模型的输出 logits,另一个是真实标签(labels)。
- 然后返回一个经过预处理后的 logits 张量,给到compute_metrics函数作为参数。
TrainingArguments 参数
args:超参数定义,trainer的重要功能,大部分训练相关的参数都是这里设置
TrainingArguments 有接近100个参数
TrainingArguments 参数
output_dir
(str):模型checkpoint/最终结果的输出目录。overwrite_output_dir
(bool, 可选,默认为 False):如果设置为True,将覆盖输出目录中已存在的内容- 继续训练模型并且输出目录, 指向一个checkpoint目录。
do_train
(bool, 可选,默认为 False):是否执行训练- 其实Trainer 不直接使用此参数,主要是用于写脚本时,作为if的条件来判断是否执行接下来的代码。
do_eval
(bool, 可选):是否在验证集上进行评估,如果评估策略(evaluation_strategy)不是”no”,将自动设置为True。- 与do_train类似,不直接由Trainer使用,主要是用于写训练脚本。
do_predict
(bool, 可选,默认为 False):是否在测试集上预测。evaluation_strategy
(str, 可选,默认为 “no”):指定训练期间采用的评估策略,可选值包括:- “no”:在训练期间不进行任何评估。
- “steps”:每隔 eval_steps 步骤进行评估。
- “epoch”:每个训练周期结束时进行评估。
prediction_loss_only
(bool, 可选, 默认为 False):- 如果设置为True,评估和预测时,只返回损失值,而不返回其他评估指标。
per_device_train_batch_size
(int, 可选, 默认为 8):训练阶段,每个GPU/XPU/TPU/MPS/NPU/CPU的batch,每个训练步骤中每个硬件上的样本数量。per_device_eval_batch_size
(int, 可选, 默认为 8):评估阶段的每个GPU/XPU/TPU/MPS/NPU/CPU的batch,每个评估步骤中每个硬件上的样本数量。gradient_accumulation_steps
(int, 可选, 默认为 1):执行反向传播之前,梯度积累的更新步数。- 梯度积累可以在多个batch上累积梯度,然后一次性执行反向传播,显存不够的情况下执行大batch的反向传播。
- 假设4张卡,每张卡的batch size为8,那么一个steps的batch size就是32,如果这个参数设置为4,那么做反向传播的训练样本数量就是128。
- 两个好处:①显存不够增大此参数;②能加快训练速度,毕竟做反向传播的次数少了。
eval_accumulation_steps
(int, 可选):执行评估时,模型会累积多少个预测步骤的输出张量,然后才从GPU/NPU/TPU移动到CPU上,默认是整个评估的输出结果将在GPU/NPU/TPU上累积,然后一次性传输到CPU,速度更快,但占显存。eval_delay
(float, 可选):等待执行第一次评估的轮数或步数。- 如果evaluation_strategy为”steps”,设置此参数为10,则10个steps后才进行首次评估。
learning_rate
(float, 可选, 默认为 5e-5):AdamW优化器的初始学习率。weight_decay
(float, 可选, 默认为 0):权重衰减的值,应用在 AdamW 优化器所有层上,除了偏置(bias)和 Layer Normalization 层(LayerNorm)的权重上。- 权重衰减是一种正则化手段,通过向损失函数添加一个额外的项,来惩罚较大的权重值,有助于防止模型过拟合训练数据。
adam_beta1
(float, 可选, 默认为 0.9):AdamW优化器的beta1超参数。adam_beta2
(float, 可选, 默认为 0.999):AdamW优化器的beta2超参数。adam_epsilon
(float, 可选, 默认为 1e-8):AdamW优化器的epsilon超参数。max_grad_norm
(float, 可选, 默认为 1.0):梯度剪裁的最大梯度范数,可以防止梯度爆炸,一般都是1,如果某一步梯度的L2范数超过了 此参数,那么梯度将被重新缩放,确保它的大小不超过此参数。num_train_epochs
(float, 可选, 默认为 3.0):训练的总epochs数。max_steps
(int, 可选, 默认为 -1):如果设置为正数,执行的总训练步数,会覆盖 num_train_epochs。- 注意:如果使用此参数,就算没有达到这个参数值的步数,训练也会在数据跑完后停止。
lr_scheduler_type
(str, 可选, 默认为”linear”):学习率scheduler类型,根据训练进程来自动调整学习率。详细见:- “linear”:线性学习率scheduler,学习率以线性方式改变
- “cosine”:余弦学习率scheduler,学习率以余弦形状的方式改变。
- “constant”:常数学习率,学习率在整个训练过程中保持不变。
- “polynomial”:多项式学习率scheduler,学习率按多项式函数的方式变化。
- “piecewise”:分段常数学习率scheduler,每个阶段使用不同的学习率。
- “exponential”:指数学习率scheduler,学习率以指数方式改变。
warmup_ratio
(float, 可选, 默认为0.0):线性热身占总训练步骤的比例,线性热身是一种训练策略,学习率在开始阶段从0逐渐增加到其最大值(通常是设定的学习率),然后在随后的训练中保持不变或者按照其他调度策略进行调整。如果设置为0.0,表示没有热身。warmup_steps
(int,可选, 默认为0):线性热身的步骤数,这个参数会覆盖warmup_ratio,如果设置了warmup_steps,将会忽略warmup_ratio。log_level
(str, 可选, 默认为passive):主进程上要使用的日志级别,debug
:最详细的日志级别。info
:用于一般的信息性消息。warning
:用于警告信息。error
:用于错误信息。critical
:用于严重错误信息。passive
:不设置任何内容,将会使用Transformers库当前的日志级别(默认为”warning”)。- 建议训练时使用info级别。
log_level_replica
(str, 可选, 默认为warning):副本上要使用的日志级别,与log_level相同。log_on_each_node
(bool, optional, defaults to True):在多节点分布式训练中,是否在每个节点上使用log_level进行日志记录。logging_dir
(str, 可选):TensorBoard日志目录。默认为output_dir/runs/CURRENT_DATETIME_HOSTNAME。logging_strategy
(str, 可选, 默认为”steps”):训练过程中采用的日志记录策略。可选包括:- “no”:在训练过程中不记录任何日志。
- “epoch”:在每个epoch结束时记录日志。
- “steps”:根据logging_steps参数记录日志。
logging_steps
(int or float,可选, 默认为500):- 如果logging_strategy=”steps”,则此参数为每多少步记录一次步骤。
logging_nan_inf_filter
(bool, 可选, 默认为 True):是否过滤日志记录中为nan和inf的loss- 如果设置为True,将过滤每个步骤的loss,如果出现nan或inf,将取当前日志窗口的平均损失值。
save_strategy
(str , 可选, 默认为 “steps”):训练过程中保存checkpoint的策略,包括:- “no”:在训练过程中不保存checkpoint。
- “epoch”:在每个epoch束时保存checkpoint。
- “steps”:根据save_steps参数保存checkpoint。
save_steps
(int or float, 可选, 默认为500):- 如果save_strategy=”steps”,就是指两次checkpoint保存之间的更新步骤数。如果是在[0, 1)的浮点数,则就会当做与总训练步骤数的比例。
save_total_limit
(int, 可选):如果给定了参数,将限制checkpoint的总数,因为checkpoint也是很占硬盘的,将会删除输出目录中旧的checkpoint。- 当启用load_best_model_at_end时,会根据metric_for_best_model保留最好的checkpoint,以及最近的checkpoint。
- 当save_total_limit=5和指定load_best_model_at_end时,将始终保留最近的四个checkpoint以及最好的checkpoint;
- 当save_total_limit=1和指定load_best_model_at_end时,会保存两个checkpoint:最后一个和最好的一个(如果不同一个)。
load_best_model_at_end
(bool, 可选, 默认为False):是否在训练结束时,加载在训练过程中最好的checkpoint- 设置为 True 时,找到在验证集上指标最好的checkpoint并且保存,然后还会保存最后一个checkpoint
- 在普通的多epoch训练中,最好设置为True
- 但在大模型训练中,一般是一个epoch,使用的就是最后一个checkpoint。
save_safetensors
(bool, 可选, 默认为False):是否在保存和加载模型参数时使用 “safetensors”- “safetensors” 更好地处理了不同 PyTorch 版本之间的模型参数加载的兼容性问题。
save_on_each_node
(bool, 可选, 默认为 False):多节点分布式训练时,是否在每个节点上保存checkpoint,还是仅在主节点上保存。- 注意如果多节点使用的是同一套存储设备,比如都是外挂一个nas,开启后会报错,因为文件名称都一样。
use_cpu
(bool, 可选, 默认为 False):是否用CPU训练。如果设置为False,将使用CUDA或其他可用设备。seed
(int, 可选, 默认为42):训练过程的随机种子,确保训练的可重现性,主要用于model_init,随机初始化权重参数。data_seed
(int, 可选):数据采样的随机种子,如果没有设置将使用与seed相同的种子,可以确保数据采样的可重现性。jit_mode_eval
(bool, 可选, 默认为False):是否在推理(inference)过程中使用 PyTorch 的 JIT(Just-In-Time)跟踪功能- PyTorch JIT 是 PyTorch 的一个功能,用于将模型的前向传播计算编译成高性能的机器代码,会加速模型的推理。
use_ipex
(bool, 可选, 默认为 False):是否使用英特尔扩展(Intel extension)来优化 PyTorch,需要安装IPEX- IPEX是一组用于优化深度学习框架的工具和库,提高训练和推理的性能,特别针对英特尔的处理器做了优化。
bf16
(bool, 可选, 默认为False):是否使用bf16进行混合精度训练,而不是fp32训练,需要安培架构或者更高的NVIDIA架构,关于精度的问题可以看这篇文章:Glan格蓝:LLM大模型之精度问题(FP16,FP32,BF16)详解与实践- 混合精度训练:模型训练时将模型参数和梯度存储为
fp32
,但在前向和后向传播计算中使用fp16
,这样可以减少内存使用和计算时间,并提高训练速度。
- 混合精度训练:模型训练时将模型参数和梯度存储为
fp16
(bool,** 可选, 默认为**False):是否使用fp16进行混合精度训练,而不是fp32训练。fp16_opt_level
(str, 可选, 默认为 ‘‘O1’’):对于fp16训练,选择的Apex AMP的优化级别,可选值有 [‘O0’, ‘O1’, ‘O2’和’O3’]。详细信息可以看Apex文档。half_precision_backend
(str, 可选, 默认为”auto”):混合精度训练(Mixed Precision Training)时要使用的后端,必须是 “auto”、”cuda_amp”、”apex”、”cpu_amp” 中的一个。- “auto”将根据检测到的PyTorch版本来使用后端,而其他选项将会强制使用请求的后端。使用默认就行。
bf16_full_eval
(bool, 可选, 默认为 False):是否使用完全的bf16进行评估,而不是fp32。这样更快且省内存,但因为精度的问题指标可能会下降。fp16_full_eval
(bool, 可选, 默认为 False):同上,不过将使用fp16.tf32
(bool, 可选):是否启用tf32精度模式,适用于安培架构或者更高的NVIDIA架构,默认值取决于PyTorch的版本torch.backends.cuda.matmul.allow_tf32 默认值。local_rank
(int, 可选, 默认为 -1):在分布式训练中的当前进程(本地排名)的排名,这个用户不用设置,使用PyTorch分布式训练时会自动设置,默认为自动设置。ddp_backend
(str, 可选):处理分布式计算的后端框架,用于多个计算节点协同工作以加速训练,处理模型参数和梯度的同步、通信等操作,可选值如下- “
nccl
“:这是 NVIDIA Collective Communications Library (NCCL) 的后端。 - “
mpi
“:Message Passing Interface (MPI) 后端, 是一种用于不同计算节点之间通信的标准协议。 - “
ccl
“:这是 Intel的oneCCL (oneAPI Collective Communications Library) 的后端。 - “
gloo
“:这是Facebook开发的分布式通信后端。 - “
hccl
“:这是Huawei Collective Communications Library (HCCL) 的后端,用于华为昇腾NPU的系统上进行分布式训练。 - 默认会根据系统自动设置,一般是nccl。
- “
tpu_num_cores
(int, 可选):TPU上训练时,TPU核心的数量。dataloader_drop_last
(bool, 可选, 默认为False):是否丢弃最后一个不完整的batch,发生在数据集的样本数量不是batch_size的整数倍的时候。eval_steps
(int or float, 可选):如果evaluation_strategy=”steps”,两次评估之间的更新步数,如果未设置,默认和设置和logging_steps相同的值,如果是在[0, 1)的浮点数,则就会当做与总评估步骤数的比例。dataloader_num_workers
(int, 可选, 默认为 0):数据加载时的子进程数量(仅用于PyTorch), PyTorch的num_workers参数,0表示数据将在主进程中加载。past_index
(int, 可选, 默认为 -1):一些模型(如TransformerXL或XLNet)可用过去的隐藏状态进行预测,如果将此参数设置为正整数,Trainer将使用相应的输出(通常索引为2)作为过去状态,并将其在下一个训练步骤中作为mems关键字参数提供给模型,只针对一些特定模型。run_name
(str, 可选):训练运行(run)的字符串参数,与日志记录工具(例如wandb和mlflow)一起使用,不影响训练过程,就是给其他的日志记录工具开了一个接口,个人还是比较推荐wandb比较好用。disable_tqdm
(bool, 可选):是否禁用Jupyter笔记本中的~notebook.NotebookTrainingTracker生成的tqdm进度条,如果日志级别设置为warn或更低,则将默认为True,否则为False。remove_unused_columns
(bool, 可选, 默认为True):是否自动删除模型在训练时,没有用到的数据列,默认会删除,比如你的数据有两列分别是content和id,如果没有用到id这一列,训练时就会被删除。label_names
(List[str], 可选):在模型的输入字典中对应于标签(labels)的键,默认情况下不需要显式指定。metric_for_best_model
(str, 可选):与 load_best_model_at_end 结合使用,比较不同模型的度量标准,默认情况下,如果未指定,将使用验证集的 “loss” 作为度量标准,可使用accuracy、F1、loss等。greater_is_better
(bool, 可选):与 load_best_model_at_end 和 metric_for_best_model 结合使用,这个和上面的那个参数是对应的,那个指标是越大越好还是越小越好- 如果是loss, 越小越好,这个参数就会被设置为False;
- 如果是accuracy,把这个值设为True。
ignore_data_skip
(bool, 可选,默认为False):是否断点训练,即训练终止又恢复后,是否跳过之前的训练数据。resume_from_checkpoint
(str, 可选):从checkpoint恢复训练的路径。sharded_ddp
(bool, str 或 ShardedDDPOption 列表, 可选, 默认为’’):是否在分布式训练中使用 Sharded DDP(Sharded Data Parallelism),FairScale提供的,默认不使用- FairScale 是Mate开发的一个用于高性能和大规模训练的 PyTorch 扩展库。这个库扩展了基本的 PyTorch 功能,同时引入了最新的先进规模化技术,通过可组合的模块和易于使用的API,提供了最新的分布式训练技术。详细的可以看其官网。
fsdp
(bool, str 或 FSDPOption 列表, 可选, 默认为’’):是否启用 PyTorch 的FSDP
(Fully Sharded Data Parallel Training),以及如何配置分布式并行训练。fsdp_config
(str 或 dict, 可选):配置 PyTorch 的 FSDP(Fully Sharded Data Parallel Training)的配置文件deepspeed
(str 或 dict, 可选):是否启用 DeepSpeed,以及如何配置 DeepSpeed。- 目前分布式训练使用最多的框架,比上面pytorch原生分布式训练以及FairScale用的范围更广,详细的可以看其官网。
label_smoothing_factor
(float, 可选,默认为0.0):标签平滑的因子。debug
(str 或 DebugOption 列表, 可选, 默认为’’):启用一个或多个调试功能,支持选项:- “underflow_overflow”:此选项用于检测模型输入/输出中的溢出。
- “tpu_metrics_debug”:此选项用于在 TPU 上打印调试指标。
optim
(str 或 training_args.OptimizerNames, 可选, 默认为 “adamw_torch”):要用的优化器。可选项:- “adamw_hf”
- “adamw_torch”
- “adamw_torch_fused”
- “adamw_apex_fused”
- “adamw_anyprecision”
- “adafactor”
optim_args
(str, 可选):用于向特定类型的优化器(如adamw_anyprecision)提供额外的参数或自定义配置。group_by_length
(bool, 可选, 默认为 False):是否在训练数据集中对大致相同长度的样本进行分组然后放在一个batch里,目的是尽量减少在训练过程中进行的padding,提高训练效率。length_column_name
(str, 可选, 默认为 “length”):当上个参数设置为True时,可以给训练数据在增加一列”长度“,就是事先计算好的,可以加快分组的速度,默认是length。report_to
(str 或 str 列表, 可选, 默认为 “all”):要将训练结果和日志报告到的不同日记集成平台,有很多”azure_ml”, “clearml”, “codecarbon”, “comet_ml”, “dagshub”, “flyte”, “mlflow”, “neptune”, “tensorboard”, and “wandb”。直接默认就行,都发。ddp_find_unused_parameters
(bool, 可选):使用分布式训练时,这个参数用于控制是否查找并处理那些在计算中没有被使用的参数,如果启用了梯度检查点(gradient checkpointing),表示部分参数是惰性加载的,这时默认值为 False,因为梯度检查点本身已经考虑了未使用的参数,如果没有启用梯度检查点,默认值为 True,表示要查找并处理所有参数,以确保它们的梯度被正确传播。ddp_bucket_cap_mb
(int, 可选):在分布式训练中,数据通常分成小块进行处理,这些小块称为”桶”,这个参数每个桶的最大内存占用大小,一般自动分配即可。ddp_broadcast_buffers
(bool, 可选):分布式训练中,模型的某些部分可能包含缓冲区,如 Batch Normalization 层的统计信息,这个参数用于控制是否将这些缓冲区广播到所有计算设备,以确保模型在不同设备上保持同步,如果启用了梯度检查点,表示不需要广播缓冲区,因为它们不会被使用,如果没有启用梯度检查点,默认值为 True,表示要广播缓冲区,以确保模型的不同部分在所有设备上都一致。gradient_checkpointing
(bool, 可选, 默认为False):是否开启梯度检查点,简单解释一下:训练大型模型时需要大量的内存,其中在反向传播过程中,需要保存前向传播的中间计算结果以计算梯度,但是这些中间结果占用大量内存,可能会导致内存不足,梯度检查点会在训练期间释放不再需要的中间结果以减小内存占用,但它会使反向传播变得更慢。dataloader_pin_memory
(bool, 可选, 默认为 True):dataloader加载数据时,是否启用“pin memory”功能。“Pin memory” 用于将数据加载到GPU内存之前,将数据复制到GPU的锁页内存(pinned memory)中,锁页内存是一种特殊的内存,可以更快地传输数据到GPU,从而加速训练过程,但是会占用额外的CPU内存,会导致内存不足的问题,如果数据量特别大,百G以上建议False。skip_memory_metrics
(bool, 可选, 默认为 True):是否将内存分析报告添加到性能指标中,默认情况下跳过这一步,以提高训练和评估的速度,建议打开,更能够清晰的知道每一步的内存使用。include_inputs_for_metrics
(bool, 可选, 默认为 False):是否将输入传递给 compute_metrics 函数,一般计算metrics用的是用的是模型预测的结果和我们提供的标签,但是有的指标需要输入,比如cv的IoU(Intersection over Union)指标。auto_find_batch_size
(bool, 可选, 默认为 False):是否使用自动寻找适合内存的batch size大小,以避免 CUDA 内存溢出错误,需要安装 accelerate(使用 pip install accelerate),这个功能还是比较NB的。full_determinism
(bool, 可选, 默认为 False):如果设置为 True,将调用 enable_full_determinism() 而不是 set_seed(),训练过程将启用完全确定性(full determinism),在训练过程中,所有的随机性因素都将被消除,确保每次运行训练过程都会得到相同的结果,注意:会对性能产生负面影响,因此仅在调试时使用。torchdynamo
(str, 可选):用于选择 TorchDynamo 的后端编译器,TorchDynamo 是 PyTorch 的一个库,用于提高模型性能和部署效率,可选的选择包括 “eager”、”aot_eager”、”inductor”、”nvfuser”、”aot_nvfuser”、”aot_cudagraphs”、”ofi”、”fx2trt”、”onnxrt” 和 “ipex”。默认就行,自动会选。ray_scope
(str, 可选, 默认为 “last”):用于使用 Ray 进行超参数搜索时,指定要使用的范围,默认情况下,使用 “last”,Ray 将使用所有试验的最后一个检查点,比较它们并选择最佳的。详细的可以看一下它的文档。ddp_timeout
(int, 可选, 默认为 1800):用于 torch.distributed.init_process_group 调用的超时时间,在分布式运行中执行较慢操作时,用于避免超时,具体的可以看 PyTorch 文档 。torch_compile
(bool, 可选, 默认为 False):是否使用 PyTorch 2.0 及以上的 torch.compile 编译模型,具体的可以看 PyTorch 文档 。torch_compile_backend
(str, 可选):指定在 torch.compile 中使用的后端,如果设置为任何值,将启用 torch_compile。torch_compile_mode
(str, 可选):指定在 torch.compile 中使用的模式,如果设置为任何值,将启用 torch_compile。include_tokens_per_second
(bool, 可选):确定是否计算每个设备的每秒token数以获取训练速度指标,会在整个训练数据加载器之前进行迭代,会稍微减慢整个训练过程,建议打开。push_to_hub
(bool, 可选, 默认为 False):指定是否在每次保存模型时将模型推送到Huggingface Hub。hub_model_id
(str, 可选):指定要与本地 output_dir 同步的存储库的名称。hub_strategy
(str 或 HubStrategy, 可选, 默认为 “every_save”):指定怎么推送到Huggingface Hub。hub_token
(str, 可选):指定推送模型到Huggingface Hub 的token。hub_private_repo
(bool, 可选, 默认为 False):如果设置为 True,Huggingface Hub 存储库将设置为私有。hub_always_push
(bool, 可选, 默认为 False):是否每次都推送模型。
详见
Firefly
Firefly 是开源的大模型一站式训练框架
- 支持对各种大模型进行预训练、指令微调、
DPO
,支持全量参数、LoRA、QLoRA等训练方式。 - 支持包括但不限于Gemma、Qwen1.5、MiniCPM、Mixtral-8x7B、Mistral、Llama等绝大多数主流的大模型。
【2024-3-5】使用Firefly在单卡V100上对Qwen1.5进行SFT和DPO,大幅超越Qwen1.5和Gemma
用Firefly项目对Qwen1.5-7B进行训练的实验。我们对训练数据进行精细化筛选,然后在单张V100上进行SFT和DPO。经过两阶段的训练,我们的模型在Open LLM Leaderboard上的表现显著优于官方的Qwen1.5-7B-Chat、Gemma-7B-it、Vicuna-13B等模型。比Qwen1.5-7B-Chat高7.12分,比Gemma-7B-it高8.8分。
TorchTune
【2024-3-23】PyTorch官方发布LLM微调工具TorchTune
PyTorch官方最近发布了支持LLM微调的工具:TorchTune
。
- TorchTune 是一个原生的 PyTorch 库,用于轻松编写、微调和实验大型语言模型(LLMs)
TorchTune 功能
功能:
- 原生 PyTorch 实现的流行大型语言模型
- 支持多种格式的checkpoints,包括 Hugging Face 格式的checkpoints
- 针对流行微调技术的训练策略,带有参考基准和全面的校验检查
- 与 HuggingFace 数据集集成用于训练,以及与 EleutherAI 的评估工具 Eval Harness 集成用于评估
- 支持使用 PyTorch 分布式中的 FSDP 进行分布式训练
- YAML 配置文件,便于轻松配置训练运行
- [即将推出] 支持来自 TorchAO 的低精度数据类型和量化技术
- [即将推出] 与各种推理引擎的互操作性
TorchTune 微调
TorchTune 已经支持了Llama2 7B模型的微调:
- 单卡微调:https://github.com/pytorch/torchtune/blob/main/recipes/full_finetune_single_device.py
- 分布式微调:https://github.com/pytorch/torchtune/blob/main/recipes/full_finetune_distributed.py
- 单卡LoRA:https://github.com/pytorch/torchtune/blob/main/recipes/lora_finetune_single_device.py
- 分布式LoRA:https://github.com/pytorch/torchtune/blob/main/recipes/lora_finetune_distributed.py
- QLoRA:https://github.com/pytorch/torc
torchtune 安装
torchtune 必须通过克隆仓库并按照以下方式安装来构建:
# ①
pip install torchtune
# ②
git clone https://github.com/pytorch/torchtune.git
cd torchtune
pip install -e .
torchtitan
【2024-4-28】torchtitan - 用于大型模型训练的原生 PyTorch 库
torchtitan is a proof-of-concept (概念验证阶段) for Large-scale LLM training using native PyTorch.
- It is (and will continue to be) a repo to showcase PyTorch’s latest distributed training features in a clean, minimal codebase.
torchtitan
is complementary (补充) to and not a replacement (替代) for any of the great large-scale LLM training codebases such asMegatron
,Megablocks
,LLM Foundry
,Deepspeed
, etc.- Instead, we hope that the features showcased in
torchtitan
will be adopted by these codebases quickly. torchtitan is unlikely to ever grow a large community around it.
Our guiding principles when building torchtitan:
- Designed to be easy to understand, use and extend for different training purposes.
- Minimal changes to the model code when applying 1D, 2D, or (soon) 3D Parallel.
- Modular components instead of a monolithic codebase.
Get started in minutes, not hours!
总结
Megatron-DeepSpeed 实施 3D 并行以可以让大型模型以非常有效的方式进行训练。
- DataParallel (
DP
) - 相同的初始化模型被复制多次,并且每次都被馈送 minibatch 的一部分。处理是并行完成的,所有设置在每个训练步骤结束时进行同步。 - TensorParallel (
TP
) - 每个张量都被分成多个块,因此不是让整个张量驻留在单个 GPU 上,而是张量的每个分片都驻留在其指定的 GPU 上。在处理过程中,每个分片在不同的 GPU 上分别并行处理,最终结果在步骤结束时同步。这也被称作横向并行。 - PipelineParallel (
PP
) - 模型在多个 GPU 上垂直(层级)拆分,因此只有模型的一个或多个层放置在单个 GPU 上。每个 GPU 并行处理管道的不同阶段,并处理一小部分批处理。 - 零冗余优化器 (
ZeRO
) - 也执行与 TP 有点类似的张量分片,除了整个张量会及时重建以进行前向或反向计算,因此不需要修改模型。它还支持各种卸载技术以补偿有限的 GPU 内存。
训练超大规模语言模型主要有两条技术路线:
- TPU + XLA + TensorFlow/JAX
- GPU + PyTorch + Megatron-LM + DeepSpeed
- 前者由Google主导,由于TPU和自家云平台GCP深度绑定,对于非Googler来说, 只可远观而不可把玩
- 后者背后则有NVIDIA、Meta、MS大厂加持,社区氛围活跃,也更受到群众欢迎。
Deepspeed 是微软的大规模分布式训练工具。专门用于训练超大模型。
- 大模型的训练工具(1)—Deepspeed
DP
+PP
: DeepSpeed 将 DP 与 PP 结合起来DP
+PP
+TP
: 为了获得更高效的训练,PP 与 TP 和 DP 相结合,称为 3D 并行性- ZeRO DP+PP+TP: DeepSpeed 的主要功能之一是 ZeRO,它是 DP 的超级可扩展扩展。
- 【2023-3-16】大型语言模型(LLM)训练指南
增加的功能主要有:
- 3个维度并行化实现万亿参数模型训练
- ZeRO-Offload 使 GPU 单卡能够训练 10 倍大的模型
- 通过 DeepSpeed Sparse Attention 用6倍速度执行10倍长的序列
- 1 比特 Adam 减少 5 倍通信量
3D 并行:扩展至万亿参数模型
3D 并行同时解决了训练万亿参数模型的两个基本挑战:显存效率和计算效率。因此,DeepSpeed 可以扩展至在显存中放下最巨大的模型,而不会牺牲速度。
- 显存效率:集群上所能训练的LLM的参数量。
- 计算效率:单纯计算占系统的开销的比例。
(1)数据并行是分布式训练普遍使用的技术。
在该技术中,每批输入的训练数据都在数据并行的 worker 之间平分。反向传播后需要通信并规约梯度,以保证优化器在各个 worker 上进行相同的更新。数据并行性具有几个明显的优势,包括计算效率高和实现起来工作量小。但是,数据并行的 batch 大小随 worker 数量提高,而我们往往无法在不影响收敛性的情况下一直增加 batch 大小。
- 显存效率:数据并行会在所有 worker 之间进行模型和优化器的复制,因此显存效率不高。DeepSpeed 开发了 ZeRO ,它是一系列用于提高数据并行的显存效率的优化器。 这项工作依赖于 ZeRO 的 1 阶段,该阶段在 worker 之间划分优化器状态量以减少冗余。
- 计算效率:随着我们提高并行度,每个 worker 执行的计算量是恒定的。数据并行可以在小规模上实现近乎线性扩展。但是,在 worker 之间规约梯度的通信开销跟模型大小成正相关,所以当模型很大或通信带宽很低时,计算效率会受限。。梯度累积是一种用来均摊通信成本的一种常用策略。它会进一步增加batch大小,在本地使用 micro-batch 多次进行正向和反向传播积累梯度后,再进行梯度规约和优化器更新。
(2)模型并行是包含范围很广的一类技术。
它会在多个 worker 之间划分模型的各个层。就其本质而言,模型并行性的计算和通信因模型结构而异,因此在实现上有很大的工作量。DeepSpeed 借用了英伟达的 Megatron-LM 来为基于 Transformer 的语言模型提供大规模模型并行功能。模型并行会根据 worker 数量成比例地减少显存使用量,也是这三种并行度中显存效率最高的。但是其代价是计算效率最低。
- 显存效率:模型并行会根据 worker 数量成比例地减少显存使用量。至关重要的是,这是减少单个网络层的激活显存的唯一方法。DeepSpeed 通过在模型并行 worker 之间划分激活显存来进一步提高显存效率。
- 计算效率:由于每次前向和反向传播中都需要额外通信激活值,模型并行的计算效率很低。模型并行需要高通信带宽,并且不能很好地扩展到通信带宽受限的节点。此外,每个模型并行worker 都会减少每个通信阶段之间执行的计算量,从而影响计算效率。模型并行性通常与数据并行性结合使用,以在内存和计算效率之间进行权衡。
(3)流水线并行训练引擎也被包含在了这次发布的DeepSpeed中
流水线并行将模型的各层划分为可以并行处理的阶段。当一个阶段完成一个 micro-batch 的正向传递时,激活内存将被通信至流水线的下一个阶段。类似地,当下一阶段完成反向传播时,将通过管道反向通信梯度。必须同时计算多个 micro-batch 以确保流水线的各个阶段能并行计算。目前已经开发出了几种用于权衡内存和计算效率以及收敛行为的方法,例如 PipeDream。DeepSpeed 采用的方法是通过梯度累积来实现并行,并保持与传统数据并行和模型并行训练在相同的总 batch 大小下收敛情况相同。
- 显存效率:流水线并行减少的显存与流水线的阶段数成正比,使模型的大小可以随 worker 的数量线性扩展。但是,流水线并行不会减少每一层的激活函数的显存占用量。此外,每个 worker 必须存储同时运行的各个 micro-batch 的激活值。这导致流水线第一阶段的激活内存与单个 mirco batch 的总激活内存大致相同。一个万亿参数模型将需要为一个 micro batch 提供大约 19 GB 的显存的激活内存,这几乎占到新推出的英伟达 A100 GPU 总显存的一半。
- 计算效率:流水线并行具有最低的通信量,因为它的通信量只和在各阶段边界的各层的激活值大小成正比。但是,它不能无限扩展。像模型并行一样,增加流水线大小会减少每个流水线阶段的计算量,这会降低计算与通信的比率。如果要实现好的计算效率,流水线并行还要求其每个阶段的计算负载完美的均衡。
LLaMA-Factory
资料
- 【2024-7-18】LLaMA-Factory QuickStart
- 官方文档
LLaMA-Factory 介绍
LLaMA Factory 支持多种LLM微调方式,北航博士生推出,包括: 预训练、指令监督微调和奖励模型训练等。
- 支持
LoRA
和QLoRA
微调策略,广泛集成了业界前沿的微调方法。 - 特点: 支持多种LLM模型,提供了WebUI页面,使非开发人员也能微调。
- 体验地址:LLaMA-Board
- 可视化界面 LLaMA-Board
- github: LLaMA-Factory,附各阶段训练数据集
资源
功能
- 支持多种模型:LLaMA、LLaVA、Mistral、Mixtral-MoE、Qwen、Qwen2-VL、Yi、Gemma、Baichuan、ChatGLM、Phi 等等。
- 集成方法:(增量)预训练、(多模态)指令监督微调、奖励模型训练、PPO 训练、DPO 训练、KTO 训练、ORPO 训练等等。
- 多种精度:16 比特全参数微调、冻结微调、LoRA 微调和基于 AQLM/AWQ/GPTQ/LLM.int8/HQQ/EETQ 的 2/3/4/5/6/8 比特 QLoRA 微调。
- 先进算法:GaLore、BAdam、Adam-mini、DoRA、LongLoRA、LLaMA Pro、Mixture-of-Depths、LoRA+、LoftQ、PiSSA 和 Agent 微调。
- 实用技巧:FlashAttention-2、Unsloth、Liger Kernel、RoPE scaling、NEFTune 和 rsLoRA。
- 实验监控:LlamaBoard、TensorBoard、Wandb、MLflow、SwanLab 等等。
- 极速推理:基于 vLLM 的 OpenAI 风格 API、浏览器界面和命令行接口。
性能指标
- 与 ChatGLM 官方的 P-Tuning 微调相比,LLaMA Factory 的 LoRA 微调提供了 3.7 倍的加速比,同时在广告文案生成任务上取得了更高的 Rouge 分数。
- 结合 4 比特量化技术,LLaMA Factory 的 QLoRA 微调进一步降低了 GPU 显存消耗。
详情参考
LLaMA-Factory 安装
安装
依赖
- 必备依赖: torch/transformers/datasets/trl/accelerate/peft
- 可选依赖: CUDA/deepspeed/bitsandbytes/vllm/flash-attn
# ----------------------
git clone --depth 1 https://github.com/hiyouga/LLaMA-Factory.git
cd LLaMA-Factory
pip install -e ".[torch,metrics]"
# ---------------------
# Clone the repository
git clone https://github.com/hiyouga/LLaMA-Factory.git
# Create a virtual environment
conda create -n llama_factory python=3.10
# Activate the virtual environment
conda activate llama_factory
# Install dependencies
cd LLaMA-Factory
pip install -r requirements.txt
【2025-1-11】 win 10 上实践
pip install llamafactory # 一步安装
模型下载
项目支持通过模型名称直接从 huggingface 和 modelscope 下载模型,但不容易对模型文件统一管理,所以建议使用手动下载,然后使用绝对路径控制哪个模型。
以 Meta-Llama-3-8B-Instruct为例
# huggingface 下载(可能要先提交申请通过)
git clone https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct
# modelscope 下载(适合中国大陆网络环境)
git clone https://www.modelscope.cn/LLM-Research/Meta-Llama-3-8B-Instruct.git
# 或者 模型下载
from modelscope import snapshot_download
model_dir = snapshot_download('LLM-Research/Meta-Llama-3-8B-Instruct')
注意
# Hugging Face 模型和数据集下载中遇到问题,可使用魔搭/魔乐社区。
export USE_MODELSCOPE_HUB=1 # Windows 使用 `set USE_MODELSCOPE_HUB=1`
export USE_OPENMIND_HUB=1 # Windows 使用 `set USE_OPENMIND_HUB=1`
LLaMA-Factory 命令行
常用命令
主要命令
llamafactory-cli version # 显示版本
llamafactory-cli help # 帮助信息
# Web UI 使用
llamafactory-cli webui # 启动网页端
CUDA_VISIBLE_DEVICES=4 llamafactory-cli webui # 指定第4张显卡使用
CUDA_DEVICE_ORDER='cpu' && llamafactory-cli webui # cpu 上启动web ui
set CUDA_DEVICE_ORDER='cpu';llamafactory-cli webui # windows terminal 命令
对 Llama3-8B-Instruct 模型进行 LoRA 微调、推理和合并。
# 训练
llamafactory-cli train -h # 查看训练参数
# lora 微调
llamafactory-cli train examples/train_lora/llama3_lora_sft.yaml
# 推理
llamafactory-cli chat examples/inference/llama3_lora_sft.yaml
# 合并
llamafactory-cli export examples/merge_lora/llama3_lora_sft.yaml
# 用 vLLM 部署 OpenAI API
API_PORT=8000 llamafactory-cli api examples/inference/llama3_vllm.yaml
参数
参数解释
动作参数枚举 | 参数说明 |
---|---|
version |
显示版本信息 |
train |
命令行版本训练 |
chat |
命令行版本推理chat |
export |
模型合并和导出 |
api |
启动API server,供接口调用 |
eval |
使用mmmlu等标准数据集做评测 |
webchat |
前端版本纯推理的chat页面 |
webui |
启动LlamaBoard前端页面,包含可视化训练,预测,chat,模型合并多个子页面 |
关键参数
model_name_or_path
参数名称- huggingface 或 modelscope 标准定义,如“meta-llama/Meta-Llama-3-8B-Instruct”)
- 或者是本地下载的绝对路径,如 /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct
template
模型问答时prompt模板,不同模型不同,请参考 获取不同模型的模板定义,否则会回答结果会很奇怪或导致重复生成等现象的出现。- chat 版本模型基本都需要指定,比如 Meta-Llama-3-8B-Instruct 的 template 就是 llama3
也可提前把相关参数存在 yaml文件里,比如: LLaMA-Factory/examples/inference/llama3.yaml
at main · hiyouga/LLaMA-Factory, 本地位置是 examples/inference/llama3.yaml
内容如下
model_name_or_path: /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct
template: llama3
通过如下命令启动,效果跟上面一样,但是更方便管理
llamafactory-cli webchat examples/inference/llama3.yaml
效果如图,可通过 http://localhost:7860/ 进行访问
推理
transformers
huggingface transformers 库直接推理
import transformers
import torch
# 切换为你下载的模型文件目录, 这里的demo是Llama-3-8B-Instruct
# 如果是其他模型,比如qwen,chatglm,请使用其对应的官方demo
model_id = "/media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct"
pipeline = transformers.pipeline(
"text-generation",
model=model_id,
model_kwargs={"torch_dtype": torch.bfloat16},
device_map="auto",
)
messages = [
{"role": "system", "content": "You are a pirate chatbot who always responds in pirate speak!"},
{"role": "user", "content": "Who are you?"},
]
prompt = pipeline.tokenizer.apply_chat_template(
messages,
tokenize=False,
add_generation_prompt=True
)
terminators = [
pipeline.tokenizer.eos_token_id,
pipeline.tokenizer.convert_tokens_to_ids("<|eot_id|>")
]
outputs = pipeline(
prompt,
max_new_tokens=256,
eos_token_id=terminators,
do_sample=True,
temperature=0.6,
top_p=0.9,
)
print(outputs[0]["generated_text"][len(prompt):])
API
API 实现标准参考 OpenAI的相关接口协议,基于uvicorn服务框架进行开发, 使用如下的方式启动
本脚本改编自 llama3_lora_sft.yaml
CUDA_VISIBLE_DEVICES=0 API_PORT=8000 llamafactory-cli api \
--model_name_or_path /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct \
--adapter_name_or_path ./saves/LLaMA3-8B/lora/sft \
--template llama3 \
--finetuning_type lora
项目也支持了基于vllm 的推理后端,但是这里由于一些限制,需要提前将LoRA 模型进行merge,使用merge后的完整版模型目录或者训练前的模型原始目录都可。
CUDA_VISIBLE_DEVICES=0 API_PORT=8000 llamafactory-cli api \
--model_name_or_path megred-model-path \
--template llama3 \
--infer_backend vllm \
--vllm_enforce_eager
服务启动后,即可按照openai 的API 进行远程访问,主要的区别就是替换 其中的base_url,指向所部署的机器url和端口号即可。
import os
from openai import OpenAI
from transformers.utils.versions import require_version
require_version("openai>=1.5.0", "To fix: pip install openai>=1.5.0")
if __name__ == '__main__':
# change to your custom port
port = 8000
client = OpenAI(
api_key="0",
base_url="http://localhost:{}/v1".format(os.environ.get("API_PORT", 8000)),
)
messages = []
messages.append({"role": "user", "content": "hello, where is USA"})
result = client.chat.completions.create(messages=messages, model="test")
print(result.choices[0].message)
Ollama
导出GGUF,部署Ollama
GGUF 是 lllama.cpp 设计的大模型存储格式,可以对模型进行高效的压缩,减少模型的大小与内存占用,从而提升模型的推理速度和效率。
Ollama框架可以帮助用户快速使用本地的大型语言模型,那将LLaMA-Factory项目的训练结果导出到Ollama中部署呢?
- 将lora模型合并
- 安装gguf库
- 使用llama.cpp的转换脚本将训练后的完整模型转换为gguf格式
- 安装Ollama软件
- 注册要部署的模型文件
- 启动Ollama
1-3 步是准备好 gguf 格式的文件这也是Ollama所需要的标准格式。
4-6 步就是如何在Ollama环境中启动训练后的模型。
LLaMA-Factory 可视化
LLaMA Board
Web UI 使用
- LLaMA Board 可视化微调(由 Gradio 驱动)
- Web UI 目前只支持单卡训练/推理,当机器有多张显卡时请使用
CUDA_VISIBLE_DEVICES
指定一张显卡启动程序。 - 启动网页UI,系统上必须有 GPU !
目前webui版本只支持单机单卡和单机多卡,如果是多机多卡请使用命令行版本
# Web UI 使用
llamafactory-cli webui # 启动网页端
CUDA_VISIBLE_DEVICES=0 llamafactory-cli webui
CUDA_VISIBLE_DEVICES=4 llamafactory-cli webui # 指定第4张显卡使用
# 如果开启 gradio share功能,或者修改端口号
CUDA_VISIBLE_DEVICES=0 GRADIO_SHARE=1 GRADIO_SERVER_PORT=7860 llamafactory-cli webui
上述的多个不同的大功能模块都通过不同的tab进行了整合,提供了一站式操作体验。
- 训练 → 批量评估 → 交互测试 → 模型导出
- train页面,可通过预览命令功能,将训练脚本导出,用于支持多gpu训练
点击开始按钮, 即可开始训练,网页端和服务器端会同步输出相关的日志结果
训练完毕后, 点击“刷新适配器”,可找到该模型历史上使用webui训练的LoRA模型文件,后续再训练或者执行chat的时候,即会将此LoRA一起加载。
W&B
Weights & Biases 记录实验数据,请在 yaml 文件中添加下面的参数。
report_to: wandb
run_name: test_run # 可选
启动训练任务时,将 WANDB_API_KEY 设置为密钥来登录 W&B 账户。
SwanLab
用 SwanLab 记录实验数据,请在 yaml 文件中添加下面的参数。
use_swanlab: true
swanlab_run_name: test_run # 可选
启动训练任务时,登录 SwanLab账户 有三种方式:
- 方式一:在 yaml 文件中添加
swanlab_api_key=<your_api_key>
,并设置 API 密钥。 - 方式二:将环境变量
SWANLAB_API_KEY
设置为你的 API 密钥。 - 方式三:启动前使用
swanlab login
命令完成登录。
数据集
目前支持 alpaca 和 sharegpt 两种数据格式
以alpaca为例,整个数据集是一个json对象的list,具体数据格式为
[
{
"instruction": "用户指令(必填)",
"input": "用户输入(选填)",
"output": "模型回答(必填)",
"system": "系统提示词(选填)",
"history": [
["第一轮指令(选填)", "第一轮回答(选填)"],
["第二轮指令(选填)", "第二轮回答(选填)"]
]
}
]
例子比如单轮(alpaca_data_zh_51k.json 中的例子, 数据集在data/dataset_info.json中注册为alpaca_zh)
{
"instruction": "写一个有效的比较语句",
"input": "篮球和足球",
"output": "篮球和足球都是受欢迎的运动。"
}
和多轮 (oaast_sft_zh.json 中的例子, 数据集在data/dataset_info.json中注册为oaast_sft_zh)
{
"instruction": "谢谢",
"input": "",
"output": "不用谢! 很高兴我提供的信息能够帮助到你! 如果还有什么其他问题也可以向我提问。",
"history": [
[
"请你给我写一个面试准备计划,我想要去面试微软的程序员岗位",
"首先,你可以去微软官网寻找招聘信息并申请面试。\n其次,您可以在社交媒体平台寻找微软公司对程序员的面试问题,并做好准备。\n最后,您可以自己对面试过程进行模拟,熟悉话题并减少紧张感。\n我希望你能面试成功。"
]
]
}
LLaMA-Factory 使用
多GPU分布式训练, 多种工具
- huggingface Accelerate
- DeepSpeed
指令监督微调
sft lora
CUDA_VISIBLE_DEVICES=0 llamafactory-cli train \
--stage sft \ # 训练阶段 “sft”,"pt","rm","ppo"
--do_train \ # 是否训练模式
--model_name_or_path /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct \
--dataset alpaca_gpt4_zh,identity,adgen_local \ # 数据集列表, 多个数据集逗号分隔
--dataset_dir ./data \ # 数据集目录,自带的data
--template llama3 \
--finetuning_type lora \ # 微调类型: full, freeze, lora
--output_dir ./saves/LLaMA3-8B/lora/sft \ # 模型保存目录
--overwrite_cache \
--overwrite_output_dir \
--cutoff_len 1024 \ # 长度截断
--preprocessing_num_workers 16 \ #
--per_device_train_batch_size 2 \ # 训练时,各节点最小 batch_size
--per_device_eval_batch_size 1 \ # 训练时,各节点最小 batch_size
--gradient_accumulation_steps 8 \ # 梯度累积步数
--lr_scheduler_type cosine \ # 学习率衰减策略
--logging_steps 50 \ # 打日志步数
--warmup_steps 20 \ # warmup
--save_steps 100 \ # 模型保存间隔步数
--eval_steps 50 \
--evaluation_strategy steps \ #
--load_best_model_at_end \
--learning_rate 5e-5 \
--num_train_epochs 5.0 \
--max_samples 1000 \ # 采样数
--val_size 0.1 \
--plot_loss \
--fp16 # 半精度, v100不支持 bf16
训练结果
output_dir 下主要包含3部分
- adapter 开头: LoRA保存的结果了,后续用于模型推理融合
- training_loss 和 trainer_log 等记录训练的过程指标
- 其他是训练当时各种参数的备份
loss在 正常情况下会随着训练的时间慢慢变小,最后需要下降到1以下的位置才会有一个比较好的效果,可以作为训练效果的一个中间指标。
lora 效果验证
- webui
- terminal
lora 模型推理: webchat
- 指定原模型+lora模型
CUDA_VISIBLE_DEVICES=0 llamafactory-cli webchat \
--model_name_or_path /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct \
--adapter_name_or_path ./saves/LLaMA3-8B/lora/sft \
--template llama3 \
--finetuning_type lora
terminal 终端验证
CUDA_VISIBLE_DEVICES=0 llamafactory-cli chat \
--model_name_or_path /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct \
--adapter_name_or_path ./saves/LLaMA3-8B/lora/sft \
--template llama3 \
--finetuning_type lora
批量自动化评估
pip install jieba
pip install rouge-chinese
pip install nltk
本脚参考文件参数
CUDA_VISIBLE_DEVICES=0 llamafactory-cli train \
--stage sft \
--do_predict \ # 预测模式
--model_name_or_path /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct \
--adapter_name_or_path ./saves/LLaMA3-8B/lora/sft \
--eval_dataset alpaca_gpt4_zh,identity,adgen_local \
--dataset_dir ./data \
--template llama3 \
--finetuning_type lora \
--output_dir ./saves/LLaMA3-8B/lora/predict \
--overwrite_cache \
--overwrite_output_dir \
--cutoff_len 1024 \
--preprocessing_num_workers 16 \
--per_device_eval_batch_size 1 \
--max_samples 20 \ # 预测阶段采样数目
--predict_with_generate # 生成阶段
评估预测脚本 vs 训练脚本
区别如下两个
do_predict
预测模式predict_with_generate
生成文本max_samples
每个数据集采样多少用于预测对比
训练的LoRA和原始大模型进行融合,输出一个完整的模型文件
CUDA_VISIBLE_DEVICES=0 llamafactory-cli export \
--model_name_or_path /media/codingma/LLM/llama3/Meta-Llama-3-8B-Instruct \
--adapter_name_or_path ./saves/LLaMA3-8B/lora/sft \
--template llama3 \
--finetuning_type lora \
--export_dir megred-model-path \
--export_size 2 \
--export_device cpu \
--export_legacy_format False
Accelerate
accelerate launch src/train.py \
--ddp_timeout 18000000 \
--stage sft \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--dataset alpaca_gpt4_data_zh,alpaca_gpt4_data_en,glaive_toolcall_zh_demo,adgen_local \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--output_dir path_to_sft_checkpoint \
--overwrite_cache \
--overwrite_output_dir
--per_device_train_batch_size 2 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 5e-5 \
--num_train_epochs 3.0 \
--plot_loss \
--fp16
使用 DeepSpeed
deepspeed --num_gpus 2 src/train.py \
--deepspeed ds_config.json \
--ddp_timeout 18000000 \
--stage sft \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--dataset alpaca_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--output_dir path_to_sft_checkpoint \
--overwrite_cache \
--overwrite_output_dir
--per_device_train_batch_size 4 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 5e-5 \
--num_train_epochs 3.0 \
--plot_loss \
--fp16
奖励模型训练
Accelerate
accelerate launch src/train.py \
--stage rm \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--adapter_name_or_path path_to_sft_checkpoint \
--create_new_adapter \
--dataset dpo_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--output_dir path_to_ac_rm_checkpoint \
--per_device_train_batch_size 2 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 1e-5 \
--num_train_epochs 1.0 \
--plot_loss \
--fp16
使用 DeepSpeed
deepspeed --num_gpus 2 src/train.py \
--deepspeed ds_config.json \
--stage rm \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--adapter_name_or_path path_to_sft_checkpoint \
--create_new_adapter \
--dataset dpo_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--output_dir path_to_deep_rm_checkpoint \
--per_device_train_batch_size 2 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 1e-5 \
--num_train_epochs 1.0 \
--plot_loss \
--fp16
ppo 训练
Accelerate
accelerate launch src/train.py \
--stage ppo \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--adapter_name_or_path path_to_sft_checkpoint \
--create_new_adapter \
--dataset alpaca_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--reward_model path_to_ac_rm_checkpoint \
--output_dir path_to_ac_ppo_checkpoint \
--per_device_train_batch_size 2 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--top_k 0 \
--top_p 0.9 \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 1e-5 \
--num_train_epochs 1.0 \
--plot_loss \
--fp16
deepspeed
deepspeed --num_gpus 2 src/train.py \
--deepspeed ds_config.json \
--stage ppo \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--adapter_name_or_path path_to_sft_checkpoint \
--create_new_adapter \
--dataset alpaca_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--reward_model path_to_deep_rm_checkpoint \
--output_dir path_to_deep_ppo_checkpoint \
--per_device_train_batch_size 4 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--top_k 0 \
--top_p 0.9 \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 1e-5 \
--num_train_epochs 1.0 \
--plot_loss \
--fp16
dpo 训练
Accelerate
accelerate launch src/train.py \
--stage dpo \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--adapter_name_or_path path_to_sft_checkpoint \
--create_new_adapter \
--dataset dpo_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--output_dir path_to_ac_dpo_checkpoint \
--per_device_train_batch_size 2 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 1e-5 \
--num_train_epochs 1.0 \
--plot_loss \
--fp16
deepspeed
deepspeed --num_gpus 2 src/train.py \
--deepspeed ds_config.json \
--stage dpo \
--do_train \
--model_name_or_path /gemini/pretrain/Qwen1.5-4B/ \
--adapter_name_or_path path_to_sft_checkpoint \
--create_new_adapter \
--dataset dpo_zh_demo \
--template qwen \
--finetuning_type lora \
--lora_target q_proj,v_proj \
--output_dir path_to_deep_dpo_checkpoint \
--per_device_train_batch_size 2 \
--gradient_accumulation_steps 4 \
--lr_scheduler_type cosine \
--logging_steps 10 \
--save_steps 1000 \
--learning_rate 1e-5 \
--num_train_epochs 1.0 \
--plot_loss \
--fp16
Xtuner
上海AI实验室推出的 XTuner 是一个高效、灵活、全能的轻量化大模型微调工具库。与 LLaMA-Factory 类似,不过,在长序列训练、token生成速度等方面要比 LLaMA-Factory 更强。
简析
- 数据集: LLaMA-Factory 支持多种格式的数据集,更通用泛化;而
XTuner
只支持类似ShareGPT
格式的数据集。 - 模型支持: LLaMA-Factory 支持模型种类也要比XTuner更多;但 XTuner 多模态模型(LLaVA-Internlm2-7B / 20B、LLaVA-v1.5)的支持要比 LLaMA-Factory。
多轮对话训练时的loss计算。
- 从文档来看,XTuner更清晰,而且是我想要的效果;
- 而对于 LLaMA-Factory,其放出来的只是数据集格式文档,loss计算没那么透明,只能啃源码。
多轮对话所对应的长序列训练性能。随着 Gemini 1M context length 和 Sora 出世,如何训练超长上下文的大模型引起了大家广泛关注。同时在大多数的场景下,多轮对话一般也就是一个conversations包含几轮对话;但在实际情况中,一个conversations下有几百个对话,即长对话,这种场景还是比较多的。
解决方案比较麻烦,需要做拆分;在基座模型支持长上下文的情况下,如果微调框架能支持长序列训练,且性能不错,是很好的选择;
XTuner 在这方面要比 LLaMA-Factory 更好。
XTuner 序列并行设计思路参考了 DeepSpeed 的工作 DeepSpeed Ulysses,并加以优化,以达到直接基于 transformers 算法库或 Huggingface Hub 上的开源模型训练 1M 以上超长序列的目标。
模型 | 序列并行支持情况 |
---|---|
baichuan | 1/2 ❌ |
chatglm | 2/3 ❌ |
deepseek | ✅ |
gemma | ❌ |
internlm 2 | ✅ |
llama 2 | ✅ |
mistral | ❌ |
qwen 1/1.5 | ❌ |
starcoder | ❌ |
yi | ✅ |
zephyr | ✅ |
SWIFT
【2024-7-4】 阿里推出训练框架 SWIFT (Scalable lightWeight Infrastructure for Fine-Tuning)
SWIFT支持300+ LLM和50+ MLLM(多模态大模型)的训练(预训练、微调、对齐)、推理、评测和部署。开发者可以直接将我们的框架应用到自己的Research和生产环境中,实现模型训练评测到应用的完整链路。我们除支持了PEFT提供的轻量训练方案外,也提供了一个完整的Adapters库以支持最新的训练技术,如NEFTune、LoRA+、LLaMA-PRO等,这个适配器库可以脱离训练脚本直接使用在自己的自定流程中。