# البحث في الـ Hub

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

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

تتضمن مكتبة `huggingface_hub` عميل HTTP باسم [HfApi](/docs/huggingface_hub/v2.4.0/ar/package_reference/hf_api#huggingface_hub.HfApi) للتفاعل مع Hub. ومن بين مهامه الأخرى، يمكنه سرد النماذج ومجموعات البيانات والمساحات المخزنة على Hub:

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

المخرجات الخاصة بـ [list_models()](/docs/huggingface_hub/v2.4.0/ar/package_reference/hf_api#huggingface_hub.HfApi.list_models) هي مُتكرِّر (iterator) على النماذج المخزنة على Hub.

وبالمثل، يمكنك استخدام [list_datasets()](/docs/huggingface_hub/v2.4.0/ar/package_reference/hf_api#huggingface_hub.HfApi.list_datasets) لعرض قوائم مجموعات البيانات و[list_spaces()](/docs/huggingface_hub/v2.4.0/ar/package_reference/hf_api#huggingface_hub.HfApi.list_spaces) لعرض قوائم Spaces.

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

إنّ سرد المستودعات أمر رائع، لكنك قد ترغب الآن في تصفية بحثك. تملك أدوات القائمة عدة سمات مثل:
- `filter`
- `author`
- `search`
- `num_parameters`
- ...

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

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

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

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

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

```py
>>> 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](https://huggingface.co/models) و[datasets](https://huggingface.co/datasets) في متصفحك، وابحث عن بعض المعلمات وانظر إلى القيم في عنوان URL.

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

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

```bash
# 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
```

لمزيد من التفاصيل، راجد [دليل سطر الأوامر](./cli#hf-models).