Home

Awesome

<div align="center"> <img src="docs/assets/images/banner.png"> </div>

CoLLiE

CoLLiE (Collaborative Tuning of Large Language Models in an Efficient Way),一个帮助您从零开始训练大模型的完整工具箱。

Github Repo Stars GitHub Doc HuggingFace badge GitHub Workflow Status (with event) GitHub commit activity (branch) GitHub issues

<h4 align="center"> <p> [ <a href="https://github.com/OpenLMLab/collie/blob/dev/README.md">简体中文</a> ] | [ <a href="https://github.com/OpenLMLab/collie/blob/dev/README_EN.md">English</a> ] </p> </h4>

新闻

目录

<ul> <li><a href="#为什么选择CoLLiE">为什么选择CoLLiE</a></li> <li><a href="#特性">特性</a></li> <li><a href="#CoLLiE支持的模型">CoLLiE支持的模型</a></li> <li><a href="#评测">评测</a></li> <li><a href="#安装">安装</a></li> <li><a href="#Docker安装">Docker安装</a></li> <li><a href="#使用">使用</a> <ul> <li><a href="#快速开始">快速开始</a></li> <li><a href="#有趣的插件">有趣的插件</a></li> <li><a href="#更多成功样例和完整教程">更多成功样例和完整教程</a></li> </ul> </li> <li><a href="#社区">社区</a></li> <li><a href="#贡献者">贡献者</a></li> <li><a href="#引用我们">引用我们</a></li> </ul>

为什么选择CoLLiE

CoLLiE是一个可以帮助您从零开始训练大模型的完整工具箱,它提供了数据预处理、模型微调、模型保存以及训练过程各项指标监测等功能。CoLLiE集成了现有的并行策略、高效参数微调方法和高效优化器,以加快训练的速度,提高训练的质量,降低训练的开销。CoLLiE支持主流的多种模型(如MOSS, InternLM, LLaMA, ChatGLM等),您可以轻松在不同的模型之间切换。此外,CoLLiE提供了丰富的文档,使初学者可以快速入门。同时,CoLLiE还提供了高度可定制化的功能和灵活的配置选项,使有经验的用户能够根据自己的需求进行个性化定制。无论您是初学者还是有经验的专业人士,CoLLiE都可以为您提供满足需求的解决方案。

特点

CoLLiE 基于 DeepSpeedPyTorch,为大型语言模型提供协作式和高效的调优方法。 它主要包括以下四个特点:

<div align="center"> <img src="docs/assets/images/feature_list.png" width="800px"> </div> <details> <summary>完整特性</summary> <div align="center"> <img src="docs/assets/images/features.svg" width="800px"> </div> </details>

CoLLiE支持的模型

评测

显存占用

使用张量并行测试了批量大小为 1,序列长度为 2048,梯度累计步数为 2 下显存占用情况,结果如下:

<img src="docs/assets/images/mem_req.png" width="400px">

吞吐量

在 A100 和 RTX-3090 上测试了不同批量大小下使用 Adam 优化器的吞吐量,结果如下:

<img src="docs/assets/images/throughput.png" width="800px">

安装

在安装前,你需要确保:

PyPI安装

你可以简单地通过PyPI安装,命令如下:

pip install collie-lm

源码安装

git clone https://github.com/OpenLMLab/collie
python setup.py install

Docker安装

使用

快速开始

下面将提供一个使用CoLLiE训练Moss的样例,同时使用LOMO优化器,并且开启ZeRO3来降低显存消耗。

那么,请按照下面的步骤开启你的大模型训练之旅吧~ <img src="docs/assets/images/mario-running.gif" height="50px"/>

第一步:导入必要的包

from transformers import AutoTokenizer
from collie.config import CollieConfig
from collie.data import CollieDatasetForTraining
from collie.data import CollieDataLoader
from collie.optim.lomo import Lomo
from collie.controller.trainer import Trainer
from collie.controller.evaluator import EvaluatorForPerplexity, EvaluatorForGeneration
from collie.models.moss_moon import Moss003MoonForCausalLM
from collie.utils.monitor import StepTimeMonitor, TGSMonitor, MemoryMonitor, LossMonitor, EvalMonitor
from collie.metrics import DecodeMetric, PPLMetric
from collie.module import GPTLMLoss
from collie.utils.data_provider import GradioProvider

第二步:设置路径

选择预训练模型为MOSS

pretrained_model = "fnlp/moss-moon-003-sft"

第三步:设置CoLLiE配置

config = CollieConfig.from_pretrained(pretrained_model, trust_remote_code=True)
# 张量并行
config.tp_size = 2
# 数据并行
config.dp_size = 1
# 流水线并行
config.pp_size = 1
# 训练的epoch数量
config.train_epochs = 1
# 每{100}个step进行一次eval
config.eval_per_n_steps = 100
# 每{1}个epoch进行一次eval
config.eval_per_n_epochs = 1 
# 每个GPU的batch_size设置为{16}
config.train_micro_batch_size = 16
# 每次eval的batch_size为{1}
config.eval_batch_size = 1
# 设置DeepSpeed配置
config.ds_config = {
        # 开启FP16
        "fp16": {
            "enabled": True
        },
        "zero_allow_untested_optimizer": True,
        "zero_force_ds_cpu_optimizer": False,
        # 开启ZeRO-3
        "zero_optimization": {
            "stage": 3,
            "offload_optimizer": {
                "device": "cpu",
                "pin_memory": False
            }
        },
        "monitor_config": {
            "enabled": True,
            "tag": "adan",
            "csv_monitor": {
                "enabled": True,
                "output_path": "./ds_logs/"
            }
        }
}

第四步:设置Tokenizer

tokenizer = AutoTokenizer.from_pretrained("fnlp/moss-moon-003-sft", trust_remote_code=True)

第五步:加载数据集

这里自定义一个数据集,数据格式可以提供两种形式,具体请参考文档。

train_dataset = [
    {
        'input': 'Collie is a python package for ',
        'output': 'finetuning large language models.'
    } for _ in range(10000)
]
train_dataset = CollieDatasetForTraining(train_dataset, tokenizer)
eval_dataset = train_dataset[:32]

第六步:加载预训练模型

model = Moss003MoonForCausalLM.from_pretrained(pretrained_model, config=config)

第七步:设置优化器

optimizer = Lomo(
    model,
    lr = 0.001,
    clip_grad_norm = 5.0
)

第八步:添加监视器

monitors = [
    # 每个step用时监测
    StepTimeMonitor(config),
    # TGS(每秒生成token数量监测)
    TGSMonitor(config),
    # 显存使用情况监测
    MemoryMonitor(config),
    # Loss值监测
    LossMonitor(config),
    # Eval结果监测
    EvalMonitor(config)
]

第九步:添加Evaluator

这里添加两个Evaluator,分别用于计算PPL(困惑度:Perplexity)和保存Decode结果。

evaluator_ppl = EvaluatorForPerplexity(
    model = model,
    config = config,
    dataset = eval_dataset,
    monitors = [
        EvalMonitor(config)
    ],
    metrics = {
        'ppl': PPLMetric()
    }
)
evaluator_decode = EvaluatorForGeneration(
    model = model,
    config = config,
    tokenizer = tokenizer,
    dataset = eval_dataset,
    monitors = [
        EvalMonitor(config)
    ],
    metrics = {
        'decode': DecodeMetric()
    }

)

第十步:实例化Trainer

trainer = Trainer(
    model = model,
    config = config,
    loss_fn = GPTLMLoss(-100),
    optimizer = optimizer,
    train_dataset = train_dataset,
    monitors = monitors,
    evaluators = [evaluator_ppl, evaluator_decode],
)
# 开始训练/验证
trainer.train()

最后一步:启动命令行,开始训练!👍

Command CUDA_VISIBLE_DEVICES=0,1,2,3 torchrun --rdzv_backend=c10d --rdzv_endpoint=localhost:29402 --nnodes=1 --nproc_per_node=4 finetune_moss_for_training.py

如果你的命令行出现如下的进度条,那么恭喜你,你已经成功开始训练你的大模型!

<div align="center"> <img src="docs/assets/images/progress.png"> </div>

完整代码请参考<a href="https://github.com/OpenLMLab/collie/blob/dev/examples/finetune_moss_for_training.py">examples/finetune_moss_for_training.py</a>

有趣的插件

CoLLiE提供了许多即插即用的插件,下面将介绍Monitor检测器和异步DataProvider,更多插件等待探索和开发...

Monitor监测器

在CollieConfig.ds_config中添加monitor配置,并在Trainer中启用即可在训练过程中打开监测器。

    "monitor_config": {
        # 开启检测器
        "enabled": True,
        # 保存的文件名前缀
        "tag": "adan",
        # 保存文件格式:csv
        "csv_monitor": {
            "enabled": True,
            # 保存文件夹
            "output_path": "./ds_logs/"
        }
    }

启用检测器后,你将在ds_logs文件夹中获取相关的文件,如:

<div align="center"> <img src="docs/assets/images/monitor.png"> </div>

异步DataProvider

你只需要在Trainer中添加:data_provider,即可在训练过程中打开一个异步DataProvider,方便及时Human Eval!

trainer = Trainer(
    model = model,
    config = config,
    loss_fn = GPTLMLoss(-100),
    optimizer = optimizer,
    train_dataset = train_dataset,
    monitors = monitors,
    evaluators = [evaluator_ppl, evaluator_decode],
    # 添加
    data_provider = GradioProvider(tokenizer)
)
<div align="center"> <img src="docs/assets/images/data_provider.png"> </div>

更多成功样例和完整教程

CoLLiE提供了完整的 教程。 更多的示例也可在 示例 中查看。

社区

贡献者

<a href="https://github.com/Openlmlab/collie/graphs/contributors"> <img src="https://contrib.rocks/image?repo=Openlmlab/collie" /> </a>

引用我们