Hub documentation

استخدام المُكيِّفات في Hugging Face

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

استخدام المُكيِّفات في Hugging Face

ملاحظة: حلّ مكان مكتبة adapter-transformers حزمة Adapters وهي متوافقة تمامًا من حيث أوزان النموذج. راجع هنا لمزيد من التفاصيل.

Adapters هي مكتبة مضافة إلى 🤗 transformers لضبط نماذج اللغة المُسبقة التدريب بكفاءة باستخدام المُكيّفات (adapters) وطرق أخرى فعّالة من حيث المعاملات. كما توفر Adapters طرقًا متنوعة لتكوين وحدات المُكيّفات أثناء التدريب والاستدلال. يمكنك معرفة المزيد حول هذا الموضوع في ورقة Adapters.

استكشاف المُكيِّفات على المستودع

يمكنك العثور على نماذج Adapters عن طريق التصفية على يسار صفحة النماذج. يمكن العثور على بعض نماذج المحوّل في مستودع Adapter Hub repository. يتم تجميع النماذج من كلا المصدرين على موقع AdapterHub.

التثبيت

للبدء، يمكنك الرجوع إلى دليل تثبيت AdapterHub. كما يمكنك استخدام أمر التثبيت التالي من سطر واحد عبر pip:

pip install adapters

استخدام نماذج موجودة

لإرشادات شاملة حول تحميل المُكيِّفات المُدرَّبة مسبقًا، ننصح بالاطلاع على الدليل الرسمي.

كخلاصة موجزة، يتكون الإعداد الكامل من ثلاث خطوات:

  1. قم بتحميل نموذج أساسي من transformers باستخدام فئة AutoAdapterModel التي يوفرها Adapters.
  2. استخدم طريقة load_adapter() لتحميل مُكيّف وإضافته.
  3. فعّل المُكيّف عبر active_adapters (لأغراض الاستدلال) أو فعّله واطلبه كقابل للتدريب عبر train_adapter() (لأغراض التدريب). تأكد أيضاً من الاطلاع على تركيب المُكيّفات.
from adapters import AutoAdapterModel

# 1.
model = AutoAdapterModel.from_pretrained("FacebookAI/roberta-base")
# 2.
adapter_name = model.load_adapter("AdapterHub/roberta-base-pf-imdb")
# 3.
model.active_adapters = adapter_name
# or model.train_adapter(adapter_name)

يمكنك أيضًا استخدام list_adapters للعثور على جميع نماذج المحوّلات برمجيًا:

from adapters import list_adapters

# source can be "ah" (AdapterHub), "hf" (hf.co) or None (for both, default)
adapter_infos = list_adapters(source="hf", model_name="FacebookAI/roberta-base")

إذا كنت ترغب في معرفة كيفية تحميل نموذج محدد، يمكنك النقر على Use in Adapters وستحصل على مقتطف جاهز للتشغيل يمكنك من خلاله تحميله!

مشاركة نماذجك

لإرشادات شاملة حول مشاركة النماذج باستخدام Adapters، ننصح بالاطلاع على الدليل الرسمي.

يمكنك مشاركة مُكيّفك باستخدام طريقة push_adapter_to_hub من نموذج يحتوي بالفعل على مُكيّف.

model.push_adapter_to_hub(
    "my-awesome-adapter",
    "awesome_adapter",
    adapterhub_tag="sentiment/imdb",
    datasets_tag="imdb"
)

ينشئ هذا الأمر مستودعًا مع بطاقة نموذج مُولَّدة تلقائيًا وجميع البيانات الوصفية اللازمة.

موارد إضافية

Update on GitHub