Optimum 文件
如何使用 optimum 和 BetterTransformer?
並獲得增強的文件體驗
開始使用
如何使用 optimum 和 BetterTransformer?
安裝依賴項
您可以輕鬆地將 BetterTransformer
與 🤗 Optimum 整合,首先按如下方式安裝依賴項
pip install transformers accelerate optimum
此外,請務必按照 PyTorch 官方網站 上的指南安裝最新版本的 PyTorch。請注意,BetterTransformer
API 僅相容 torch>=1.13
,因此請確保在開始之前已在您的環境中安裝此版本。如果您想從 scaled_dot_product_attention
函式(用於基於解碼器的模型)中受益,請確保至少使用 torch>=2.0
。
步驟 1:載入您的模型
首先,使用 🤗 Transformers 載入您的 Hugging Face 模型。請確保下載受 BetterTransformer
API 支援的模型之一
>>> from transformers import AutoModel
>>> model_id = "roberta-base"
>>> model = AutoModel.from_pretrained(model_id)
>>> from transformers import AutoModel
>>> model_id = "roberta-base"
>>> model = AutoModel.from_pretrained(model_id, device_map="auto")
步驟 2:在您偏好的裝置上設定模型
如果您沒有使用 device_map="auto"
載入模型(或者如果您的模型不支援 device_map="auto"
),您可以手動將模型設定到 GPU 上
>>> model = model.to(0) # or model.to("cuda:0")
步驟 3:將您的模型轉換為 BetterTransformer!
現在是時候使用 BetterTransformer
API 轉換您的模型了!您可以執行以下命令
>>> from optimum.bettertransformer import BetterTransformer
>>> model = BetterTransformer.transform(model)
預設情況下,BetterTransformer.transform
將覆蓋您的模型,這意味著您之前的原生模型將無法再使用。如果您想出於某種原因保留它,只需新增標誌 keep_original_model=True
!
>>> from optimum.bettertransformer import BetterTransformer
>>> model_bt = BetterTransformer.transform(model, keep_original_model=True)
如果您的模型不支援 BetterTransformer
API,則會顯示錯誤跟蹤。另請注意,基於解碼器的模型(OPT、BLOOM 等)尚不受支援,但這已在 PyTorch 的未來路線圖中。
Pipeline 相容性
Transformer 的 pipeline 也與此整合相容,您可以將 BetterTransformer
用作 pipeline 的加速器。以下程式碼片段演示瞭如何操作
>>> from optimum.pipelines import pipeline
>>> pipe = pipeline("fill-mask", "distilbert-base-uncased", accelerator="bettertransformer")
>>> pipe("I am a student at [MASK] University.")
如果您想在 GPU 裝置上執行 pipeline,請執行
>>> from optimum.pipelines import pipeline
>>> pipe = pipeline("fill-mask", "distilbert-base-uncased", accelerator="bettertransformer", device=0)
>>> ...
您也可以像往常一樣使用 transformers.pipeline
並直接傳入轉換後的模型
>>> from transformers import pipeline
>>> pipe = pipeline("fill-mask", model=model_bt, tokenizer=tokenizer, device=0)
>>> ...
有關進一步使用,請參閱 pipeline
的官方文件。如果您遇到任何問題,請隨時在 GitHub 上提出問題!
訓練相容性
您現在可以從 BetterTransformer
API 中受益,用於您的訓練指令碼。只需確保在儲存模型之前透過呼叫 BetterTransformer.reverse
將模型轉換回其原始版本。以下程式碼片段演示瞭如何操作
from optimum.bettertransformer import BetterTransformer
from transformers import AutoModelForCausalLM
with torch.device(“cuda”):
model = AutoModelForCausalLM.from_pretrained(“gpt2-large”, torch_dtype=torch.float16)
model = BetterTransformer.transform(model)
# do your inference or training here
# if training and want to save the model
model = BetterTransformer.reverse(model)
model.save_pretrained("fine_tuned_model")
model.push_to_hub("fine_tuned_model")