History

Hongxin Liu 89fe027787 [legacy] move trainer to legacy (#4545 ) * [legacy] move trainer to legacy * [doc] update docs related to trainer * [test] ignore legacy test		2023-09-05 21:53:10 +08:00
..
experiments	[auto] fix install cmd (#3772 )	2023-05-18 13:33:01 +08:00
gemini	[gemini] improve compatibility and add static placement policy (#4479 )	2023-08-24 09:29:25 +08:00
titans	[legacy] move trainer to legacy (#4545 )	2023-09-05 21:53:10 +08:00
README.md	[doc] Fix typo under colossalai and doc(#3618 )	2023-04-26 11:38:43 +08:00
requirements.txt	[example] fix requirements (#2488 )	2023-01-17 13:07:25 +08:00
test_ci.sh	[CI] add test_ci.sh for palm, opt and gpt (#2475 )	2023-01-16 14:44:29 +08:00

README.md

Train GPT with Colossal-AI

This example shows how to use Colossal-AI to run huggingface GPT training in distributed manners.

GPT

We use the GPT-2 model from huggingface transformers. The key learning goal of GPT-2 is to use unsupervised pre-training models to do supervised tasks.GPT-2 has an amazing performance in text generation, and the generated text exceeds people's expectations in terms of contextual coherence and emotional expression.

Requirements

Before you can launch training, you need to install the following requirements.

Install PyTorch

#conda
conda install pytorch==1.12.0 torchvision==0.13.0 torchaudio==0.12.0 cudatoolkit=11.3 -c pytorch
#pip
pip install torch==1.12.0+cu113 torchvision==0.13.0+cu113 torchaudio==0.12.0 --extra-index-url https://download.pytorch.org/whl/cu113

Install Colossal-AI

Install requirements

pip install -r requirements.txt

This is just an example that we download PyTorch=1.12.0, CUDA=11.6 and colossalai. You can download another version of PyTorch and its corresponding ColossalAI version. Just make sure that the version of ColossalAI is at least 0.1.10, PyTorch is at least 1.8.1 and transformers is at least 4.231. If you want to test ZeRO1 and ZeRO2 in Colossal-AI, you need to ensure Colossal-AI>=0.1.12.

Dataset

For simplicity, the input data is randomly generated here.

Training

We provide two stable solutions. One utilizes the Gemini to implement hybrid parallel strategies of Gemini, DDP/ZeRO, and Tensor Parallelism for a huggingface GPT model. The other one use Titans, a distributed executed model zoo maintained by ColossalAI,to implement the hybrid parallel strategies of TP + ZeRO + PP.

We recommend using Gemini to quickly run your model in a distributed manner. It doesn't require significant changes to the model structures, therefore you can apply it on a new model easily. And use Titans as an advanced weapon to pursue a more extreme performance. Titans has included the some typical models, such as Vit and GPT. However, it requires some efforts to start if facing a new model structure.

GeminiDPP/ZeRO + Tensor Parallelism

bash run_gemini.sh

The train_gpt_demo.py provides three distributed plans (except ones already provided by PyTorch), you can choose the plan you want in run_gemini.sh. The CAI_Gemini leverages Tensor Parallel and Gemini + ZeRO DDP. For their differences, you may check out the answer to issue here.

ZeRO1 (CAI_ZeRO1)
ZeRO2 (CAI_ZeRO2)
Gemini + ZeRO DDP (CAI_Gemini)
Pytorch DDP (Pytorch_DDP)
Pytorch ZeRO (Pytorch_ZeRO)

Titans (Tensor Parallelism) + ZeRO + Pipeline Parallelism

Titans provides a customized GPT model, which uses distributed operators as building blocks. In [./titans/README.md], we provide a hybrid parallelism of ZeRO, TP and PP. You can switch parallel strategies using a config file.

Performance

Testbed: a cluster of 8xA100 (80GB) and 1xAMD EPYC 7543 32-Core Processor (512 GB). GPUs are connected via PCI-e. ColossalAI version 0.1.13.