البحث في الـ Hub

في هذا الشرح التعليمي، ستتعلم كيفية البحث عن النماذج ومجموعات البيانات والمساحات على Hub باستخدام huggingface_hub.

كيف تُدرج المستودعات؟

تتضمن مكتبة huggingface_hub عميل HTTP باسم HfApi للتفاعل مع Hub. ومن بين مهامها الأخرى، يمكنها عرض قوائم النماذج ومجموعات البيانات والمساحات المخزنة على Hub:

>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> models = api.list_models()

المخرجات الخاصة بـ list_models() هي مُتكرِّر (iterator) على النماذج المخزنة على Hub.

وبالمثل، يمكنك استخدام list_datasets() لعرض قوائم مجموعات البيانات وlist_spaces() لعرض قوائم Spaces.

كيف تُرشّح المستودعات؟

إنه من الرائع عرض المستودعات، لكن قد ترغب الآن في تصفية بحثك. تتمتع أدوات المساعدة الخاصة بالقوائم بعدة سمات مثل:

• filter
• author
• search
• num_parameters
• …

لنلقِ نظرة على مثال لجلب جميع النماذج على Hub التي تقوم بتصنيف الصور، وقد تم تدريبها على مجموعة بيانات imagenet، وتعمل مع PyTorch.

models = hf_api.list_models(filter=["image-classification", "pytorch", "imagenet"])

يمكنك أيضًا تصفية النماذج حسب عدد المعلمات باستخدام نفس صيغة النطاق المستخدمة في واجهة Hub:

models = hf_api.list_models(num_parameters="min:6B,max:128B")

أثناء التصفية، يمكنك أيضًا فرز النماذج وأخذ النتائج الأعلى فقط. على سبيل المثال، يجلب المثال التالي أعلى 5 مجموعات بيانات تم تنزيلها على Hub:

>>> list(list_datasets(sort="downloads", limit=5))
[DatasetInfo(
	id='argilla/databricks-dolly-15k-curated-en',
	author='argilla',
	sha='4dcd1dedbe148307a833c931b21ca456a1fc4281',
	last_modified=datetime.datetime(2023, 10, 2, 12, 32, 53, tzinfo=datetime.timezone.utc),
	private=False,
	downloads=8889377,
	(...)

لاستكشاف المرشحات المتاحة على Hub، قم بزيارة صفحتي models وdatasets في متصفحك، وابحث عن بعض المعلمات واطّلع على القيم في عنوان URL.

استخدام سطر الأوامر

يمكنك أيضًا سرد النماذج ومجموعات البيانات ومساحات Spaces والبحث عنها باستخدام واجهة سطر الأوامر hf:

# List models
>>> hf models ls --search "llama" --sort downloads --limit 5

# List datasets
>>> hf datasets ls --author Qwen

# List Spaces
>>> hf spaces ls --search "3d"

# Get info about a specific model
>>> hf models info Lightricks/LTX-2

لمزيد من التفاصيل، راجد دليل سطر الأوامر.