# عميل HfApi

فيما يلي توثيق لفئة `HfApi`، والتي تعمل كغلاف بلغة بايثون لواجهة برمجة التطبيقات الخاصة بـ Hugging Face Hub.

جميع الطرق من `HfApi` متاحة أيضًا مباشرةً من جذر الحزمة. وتُفصَّل كلا الطريقتين أدناه.

يُعد استخدام طريقة الجذر أكثر مباشرة، لكن فئة [HfApi](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi) تمنحك مرونة أكبر. على وجه التحديد، يمكنك تمرير رمز (token) يُعاد استخدامه في جميع استدعاءات HTTP. وهذا يختلف عن `hf auth login` أو [login()](/docs/huggingface_hub/main/ar/package_reference/authentication#huggingface_hub.login) حيث لا يتم حفظ الرمز على الجهاز. كما يمكن توفير نقطة نهاية (endpoint) مختلفة أو تكوين وكيل مستخدم (user-agent) مخصص.

```python
from huggingface_hub import HfApi, list_models

# Use root method
models = list_models()

# Or configure a HfApi client
hf_api = HfApi(
    endpoint="https://huggingface.co", # Can be a Private Hub endpoint.
    token="hf_xxx", # Token is not persisted on the machine.
)
models = hf_api.list_models()
```

## HfApi[[huggingface_hub.HfApi]]

#### huggingface_hub.HfApi[[huggingface_hub.HfApi]]

```python
huggingface_hub.HfApi(endpoint: str | None = None, token: str | bool | None = None, library_name: str | None = None, library_version: str | None = None, user_agent: dict | str | None = None, headers: dict[str, str] | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2132)

**المعاملات:**

endpoint (`str`، *اختياري*) : نقطة نهاية Hub. القيمة الافتراضية هي .

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

library_name (`str`، *اختياري*) : اسم المكتبة التي تُرسل طلب HTTP. سيُضاف إلى ترويسة user-agent. مثال: `"transformers"`.

library_version (`str`، *اختياري*) : إصدار المكتبة التي تُرسل طلب HTTP. سيُضاف إلى ترويسة user-agent. مثال: `"4.24.0"`.

user_agent (`str`، `dict`، *اختياري*) : معلومات وكيل المستخدم على شكل قاموس أو سلسلة نصية واحدة. سيتم استكمالها بمعلومات حول الحزم المثبتة.

headers (`dict`، *اختياري*) : رؤوس إضافية تُرسل مع كل طلب. مثال: `{"X-My-Header": "value"}`. الرؤوس المُمررة هنا لها الأولوية على الرؤوس الافتراضية.

عميل للتفاعل مع Hugging Face Hub عبر HTTP.

يتم تهيئة العميل ببعض الإعدادات عالية المستوى المستخدمة في جميع الطلبات المرسلة إلى Hub (نقطة نهاية HF، المصادقة، وكلاء المستخدم...). يُفضَّل استخدام عميل `HfApi` لكنه ليس إلزاميًا، إذ إن جميع طرقه العامة معرَّضة مباشرةً في جذر `huggingface_hub`.

#### accept_access_request[[huggingface_hub.HfApi.accept_access_request]]

```python
accept_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10877)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي تريد قبول طلب الوصول إليه.

user (`str`، *اختياري*) : اسم المستخدم الذي يجب قبول طلب الوصول الخاص به. يجب تقديم بالضبط واحد من `user` أو `request_id`.

request_id (`str`, *اختياري*) : المعرّف الخاص بطلب الوصول الذي سيتم قبوله (انظر `AccessRequest`). مطلوب عندما يتم تكوين المستودع بحيث لا يتم مشاركة أسماء المستخدمين للمقدمين. يجب تقديم بالضبط واحد من `user` أو `request_id`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم قبول طلب الوصول له. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا لم يكن المستخدم موجودًا على Hub.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا تعذّر العثور على طلب وصول المستخدم.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا كان طلب وصول المستخدم موجودًا بالفعل في قائمة المقبولين.

قبول طلب وصول من مستخدم لمتخزن محكوم محدد.

بمجرد قبول الطلب، سيتمكن المستخدم من تنزيل أي ملف من المستودع والوصول إلى تبويب المجتمع. إذا كان وضع الموافقة تلقائيًا، فلا يلزم قبول الطلبات يدويًا. يمكن إلغاء الطلب المقبول أو رفضه في أي وقت باستخدام [cancel_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) و [reject_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request).

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

#### add_collection_item[[huggingface_hub.HfApi.add_collection_item]]

```python
add_collection_item(collection_slug: str, item_id: str, item_type: CollectionItemType_T, note: str | None = None, exists_ok: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10415)

**المعاملات:**

collection_slug (`str`) : المعرّف المختصر (Slug) للمجموعة المراد تحديثها. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

item_id (`str`) : المعرّف الخاص بالعنصر الذي تريد إضافته إلى المجموعة. استخدم repo_id للمستودعات/المساحات/مجموعات البيانات، ومعرف الورقة البحثية للأوراق، و slug لمجموعة أخرى (مثل `"moonshotai/kimi-k2"`) أو معرف الدلو (مثل `"namespace/bucket-name"`).

item_type (`str`) : نوع العنصر المراد إضافته. يمكن أن يكون أحد `"model"`، `"dataset"`، `"space"`، `"paper"`، `"collection"` أو `"bucket"`.

note (`str`، *اختياري*) : ملاحظة تُرفق بالعنصر في المجموعة. الحد الأقصى لحجم الملاحظة هو 500 حرف.

exists_ok (`bool`، *اختياري*) : إذا كان `True`، فلا ترفع خطأً إذا كان العنصر موجودًا بالفعل.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا كان العنصر الذي تحاول إضافته إلى المجموعة غير موجود على Hub.
- `HfHubHTTPError` -- خطأ HTTP 409 إذا كان العنصر الذي تحاول إضافته إلى المجموعة موجودًا بالفعل في المجموعة (وكان exists_ok=False)

أضف عنصرًا إلى مجموعة على Hub.

يعيد: [Collection](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.Collection)

مثال:

```py
>>> from huggingface_hub import add_collection_item
>>> collection = add_collection_item(
...     collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab",
...     item_id="pierre-loic/climate-news-articles",
...     item_type="dataset"
... )
>>> collection.items[-1].item_id
"pierre-loic/climate-news-articles"
# ^item got added to the collection on last position

# Add item with a note
>>> add_collection_item(
...     collection_slug="davanstrien/climate-64f99dc2a5067f6b65531bab",
...     item_id="datasets/climate_fever",
...     item_type="dataset",
...     note="This dataset adopts the FEVER methodology that consists of 1,535 real-world claims regarding climate-change collected on the internet."
... )
(...)
```

#### add_space_secret[[huggingface_hub.HfApi.add_space_secret]]

```python
add_space_secret(repo_id: str, key: str, value: str, description: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8048)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

key (`str`) : المفتاح السري. مثال: `"GITHUB_API_KEY"`

value (`str`) : القيمة السرية. مثال: `"your_github_api_key"`.

description (`str`، *اختياري*) : وصف السر. مثال: `"Github API key to access the Github API"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يضيف أو يحدّث سراً في مساحة.

تتيح لك المفاتيح السرية تعيين مفاتيح أو رموز سرية لمساحة دون الحاجة إلى تضمينها في الكود. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

#### add_space_variable[[huggingface_hub.HfApi.add_space_variable]]

```python
add_space_variable(repo_id: str, key: str, value: str, description: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8174)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

key (`str`) : مفتاح متغير. مثال: `"MODEL_REPO_ID"`

value (`str`) : قيمة المتغير. مثال: `"the_model_repo_id"`.

description (`str`) : وصف المتغير. مثال: `"Model Repo ID of the implemented model"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يضيف متغيّرًا في مساحة أو يحدّثه.

تتيح المتغيرات تعيين متغيرات البيئة لمساحة دون الحاجة إلى ترميزها بشكل ثابت. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables

#### auth_check[[huggingface_hub.HfApi.auth_check]]

```python
auth_check(repo_id: str, repo_type: str | None = None, token: bool | str | None = None, write: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12052)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم التحقق من الوصول إليه. يجب أن يكون التنسيق `"user/repo_name"`. مثال: `"user/my-cool-model"`.

repo_type (`str`, *اختياري*) : نوع المستودع. يجب أن يكون أحد `"model"` أو `"dataset"` أو `"space"`. إذا لم يُحدد، فإن القيمة الافتراضية هي `"model"`.

token (`Union[bool, str, None]`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

write (`bool`, *اختياري*) : إذا كان `True`، يتحقق مما إذا كان لدى المستخدم إذن كتابة المحتوى على المستودع. إذا كان `False` (الافتراضي)، يتحقق فقط من الوصول للقراءة.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [GatedRepoError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.GatedRepoError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- تُستدعى إذا لم يكن المستودع موجودًا، أو كان خاصًا، أو لم يكن لدى المستخدم صلاحية الوصول. وقد يحدث ذلك إذا كان `repo_id` أو `repo_type` غير صحيح، أو إذا كان المستودع خاصًا لكن المستخدم غير مصادَق.

- [GatedRepoError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.GatedRepoError) -- تُستدعى إذا كان المستودع موجودًا لكنه محمي (gated) ولم يكن للمستخدم صلاحية الوصول إليه.

تحقق مما إذا كان رمز المستخدم المُقدَّم لديه وصول إلى مستودع محدد على Hugging Face Hub.

تحقّق هذه الطريقة مما إذا كان لدى المستخدم، الذي تمّ مصادقته عبر الرمز المميز المُقدَّم، صلاحية الوصول إلى المستودع المحدد. إذا لم يتم العثور على المستودع أو إذا كان المستخدم يفتقر إلى الصلاحيات المطلوبة للوصول إليه، ترمي الطريقة استثناءً مناسبًا.

مثال:

تحقق مما إذا كان لدى المستخدم صلاحية الوصول إلى مستودع:

```python
>>> from huggingface_hub import auth_check
>>> from huggingface_hub.utils import GatedRepoError, RepositoryNotFoundError

try:
    auth_check("user/my-cool-model")
except GatedRepoError:
    # Handle gated repository error
    print("You do not have permission to access this gated repository.")
except RepositoryNotFoundError:
    # Handle repository not found error
    print("The repository was not found or you do not have access.")
```

في هذا المثال:
- إذا كان للمستخدم صلاحية الوصول، فإن الطريقة تكتمل بنجاح.
- إذا كان المستودع محميًا أو غير موجود، يتم رفع استثناءات مناسبة، مما يتيح للمستخدم
لمعالجتها وفقاً لذلك.

#### batch_bucket_files[[huggingface_hub.HfApi.batch_bucket_files]]

```python
batch_bucket_files(bucket_id: str, add: list[tuple[str | Path | bytes, str]] | None = None, copy: list[tuple[str, str, str, str]] | None = None, delete: list[str] | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14734)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

add (`list` من `tuple`، *اختياري*) : الملفات المراد رفعها. كل عنصر هو `(source, destination)` حيث `source` هو مسار إلى ملف محلي (`str` أو `Path`) أو محتوى خام `bytes`، و`destination` هو المسار داخل الدلو.

copy (`list` من `tuple`، *اختياري*) : الملفات التي سيتم نسخها عبر xet hash. كل عنصر هو tuple من نوع `(source_repo_type, source_repo_id, xet_hash, destination)` حيث: - `source_repo_type` هو نوع المستودع المصدر: `"model"`، `"dataset"`، `"space"`، أو `"bucket"`. - `source_repo_id` هو المعرّف الخاص بالمستودع المصدر أو bucket (مثل `"username/my-model"`). - `xet_hash` هو xet hash للملف المراد نسخه. - `destination` هو مسار الوجهة داخل bucket. هذه عملية جانب الخادم — لا يتم تنزيل البيانات أو إعادة رفعها.

delete (`list` من `str`، *اختياري*) : مسارات الملفات التي سيتم حذفها من الدلو.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `BucketBatchError`

- `BucketBatchError` -- إذا أبلغ الخادم عن فشل بعض العمليات. يتم رفع الخطأ مرة واحدة بعد إرسال كل عملية، مما يعني أن العمليات الأخرى في الدفعة قد تم تطبيقها.

أضِف ملفات وانسخها و/أو احذفها في الدلو.

هذه عملية غير معاملة. إذا حدث خطأ أثناء العملية، فقد تكون بعض الملفات قد تم رفعها أو نسخها أو حذفها بينما لم يتم ذلك لملفات أخرى.

مثال:
```python
>>> from huggingface_hub import batch_bucket_files

# Upload files
>>> batch_bucket_files(
...     "username/my-bucket",
...     add=[
...         ("./model.safetensors", "models/model.safetensors"),
...         (b'{{"key": "value"}}', "config.json"),
...     ],
... )

# Copy xet files from another bucket or repo (server-side, no data transfer)
>>> batch_bucket_files(
...     "username/my-bucket",
...     copy=[
...         ("bucket", "username/source-bucket", "<xethash_1>", "models/model.safetensors"),
...         ("model", "username/my-model", "<xethash_2>", "models/config.safetensors"),
...     ],
... )

# Delete files
>>> batch_bucket_files("username/my-bucket", delete=["old-model.bin"])

# Upload and delete in one batch
>>> batch_bucket_files(
...     "username/my-bucket",
...     add=[("./new.txt", "new.txt")],
...     delete=["old.txt"],
... )
```

#### bucket_info[[huggingface_hub.HfApi.bucket_info]]

```python
bucket_info(bucket_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14063)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [BucketInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketInfo)

معلومات الدلو.

**يرفع:** `BucketNotFoundError` أو ``or``

- `BucketNotFoundError` -- إذا تعذّر العثور على الدلو. قد يكون السبب عدم وجوده،
- ``or`` -- لأنه مَعيَّن على `private` ولا تملك صلاحية الوصول إليه.

احصل على معلومات حول دلو (bucket) محدد على Hub.

مثال:
```python
>>> from huggingface_hub import bucket_info
>>> info = bucket_info(bucket_id="Wauplin/first-bucket")
>>> info.id
'Wauplin/first-bucket'
>>> info.private
False
>>> info.created_at
datetime.datetime(2026, 2, 6, 17, 37, 57, tzinfo=datetime.timezone.utc)
>>> info.size
551879671
>>> info.total_files
12
```

#### cancel_access_request[[huggingface_hub.HfApi.cancel_access_request]]

```python
cancel_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10827)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي تريد إلغاء طلب الوصول إليه.

user (`str`, *اختياري*) : اسم المستخدم الذي يجب إلغاء طلب الوصول الخاص به. يجب تقديم بالضبط واحد من `user` أو `request_id`.

request_id (`str`, *اختياري*) : المعرّف الخاص بطلب الوصول الذي يجب إلغاؤه (انظر `AccessRequest`). مطلوب عند إعداد المستودع بحيث لا يتم مشاركة أسماء المستخدمين للمقدمين. يجب تقديم واحد فقط من `user` أو `request_id`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي تريد إلغاء طلب الوصول إليه. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا لم يكن المستخدم موجودًا على Hub.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا تعذّر العثور على طلب وصول المستخدم.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا كان طلب وصول المستخدم موجودًا بالفعل في قائمة الطلبات المعلّقة.

إلغاء طلب وصول من مستخدم لمستودع محكوم به معين.

ستعود الطلبات الملغاة إلى قائمة الطلبات المعلقة، وسيفقد المستخدم الوصول إلى المستودع.

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

#### cancel_job[[huggingface_hub.HfApi.cancel_job]]

```python
cancel_job(job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12762)

**المعاملات:**

job_id (`str`) : معرف المهمة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يعمل فيها Job. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

إلغاء مهمة حساب على بنية Hugging Face التحتية.

#### change_discussion_status[[huggingface_hub.HfApi.change_discussion_status]]

```python
change_discussion_status(repo_id: str, discussion_num: int, new_status: Literal['open', 'closed'], token: bool | str | None = None, comment: str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7761)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

new_status (`str`) : الحالة الجديدة للنقاش، إما `"open"` أو `"closed"`.

comment (`str`، *اختياري*) : تعليق اختياري للنشر مع تغيير الحالة.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [DiscussionStatusChange](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionStatusChange)

حدث تغيير الحالة

يُغلق نقاشًا أو طلب سحب أو يعيد فتحه.

أمثلة:
```python
>>> HfApi().change_discussion_status(
...     repo_id="username/repo_name",
...     discussion_num=34,
...     new_status="closed"
... )
# DiscussionStatusChange(id='deadbeef0000000', type='status-change', ...)

```

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### comment_discussion[[huggingface_hub.HfApi.comment_discussion]]

```python
comment_discussion(repo_id: str, discussion_num: int, comment: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7618)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

comment (`str`) : محتوى التعليق الذي سيتم إنشاؤه. تدعم التعليقات تنسيق Markdown.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [DiscussionComment](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionComment)

التعليق الذي تم إنشاؤه حديثاً

ينشئ تعليقًا جديدًا على المناقشة المحددة.

أمثلة:
```python

>>> comment = """
... Hello @otheruser!
...
... # This is a title
...
... **This is bold**, *this is italic* and ~this is strikethrough~
... And [this](http://url) is a link
... """

>>> HfApi().comment_discussion(
...     repo_id="username/repo_name",
...     discussion_num=34,
...     comment=comment
... )
# DiscussionComment(id='deadbeef0000000', type='comment', ...)

```

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### copy_files[[huggingface_hub.HfApi.copy_files]]

```python
copy_files(source: str, destination: str, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14415)

**المعاملات:**

source (`str`) : موقع المصدر على شكل `hf://` URI. يمكن أن يكون مسار دلو (مثل `"hf://buckets/my-bucket/path/to/file"`) أو مسار مستودع (مثل `"hf://username/my-model/weights.bin"`، `"hf://datasets/username/my-dataset/data/"`).

destination (`str`) : الموقع الوجهة على شكل `hf://` URI يشير إلى دلو (e.g. `"hf://buckets/my-bucket/target/path"`) أو مستودع (e.g. `"hf://username/my-model/target/path"`).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كانت عناوين URI للمصدر/الوجهة غير صالحة، أو عند النسخ من دلو إلى مستودع.

انسخ الملفات بين المواقع على Hub.

انسخ الملفات من دلو أو مستودع (نموذج، مجموعة بيانات، مساحة) إلى دلو أو مستودع آخر. يتم دعم الملفات الفردية والمجلدات الكاملة على حد سواء.

عند نسخ المجلدات، فإن وجود `/` في نهاية مسار المصدر يستخدم دلالات من نمط rsync: نسخ *المحتويات* الخاصة بالمجلد إلى الوجهة، دون تضمين مجلد المصدر نفسه. أما في حال عدم وجود `/` في النهاية، فيُضمَّن مجلد المصدر داخل الوجهة (مثل `cp -r`).

عند النسخ من مستودع إلى دلو، تُستبعد ملفات `.gitattributes` تلقائيًا لأنها بيانات وصفية خاصة بـ git ولا تنطبق في سياق الدلو.

تستخدم عمليات النسخ من مستودع إلى مستودع [CommitOperationCopy](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitOperationCopy) في الخلفية وتُنشئ التزامًا في المستودع الوجهة. ولا تُدعم عمليات النسخ من دلو إلى مستودع.

> [!WARNING]
> تعمل النسخ على جانب الخادم فقط ضمن [نطاق تخزين](https://huggingface.co/docs/hub/storage-regions) واحد.

مثال:
```python
>>> from huggingface_hub import copy_files

# Copy a single file between buckets
>>> copy_files("hf://buckets/my-bucket/data.bin", "hf://buckets/other-bucket/data.bin")

# Copy a folder into another bucket (nests: backup/models/...)
>>> copy_files("hf://buckets/my-bucket/models", "hf://buckets/other-bucket/backup/")

# Copy folder contents (trailing /): files go directly into backup/
>>> copy_files("hf://buckets/my-bucket/models/", "hf://buckets/other-bucket/backup/")

# Copy a file from a model repo to a bucket
>>> copy_files("hf://username/my-model/model.safetensors", "hf://buckets/my-bucket/")

# Copy an entire dataset to a bucket
>>> copy_files("hf://datasets/username/my-dataset/", "hf://buckets/my-bucket/datasets/")

# Copy files between repositories
>>> copy_files("hf://username/source-model/", "hf://username/dest-model/")

# Copy a file from one repo to another
>>> copy_files("hf://username/source-model/config.json", "hf://username/dest-model/config.json")
```

#### create_branch[[huggingface_hub.HfApi.create_branch]]

```python
create_branch(repo_id: str, branch: str, revision: str | None = None, token: bool | str | None = None, repo_type: str | None = None, exist_ok: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6968)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم إنشاء الفرع فيه. مثال: `"user/my-cool-model"`.

branch (`str`) : اسم الفرع الذي سيتم إنشاؤه.

revision (`str`, *اختياري*) : المراجعة (revision) في git التي سيتم إنشاء الفرع منها. يمكن أن يكون اسم فرع أو معرف OID/SHA لالتزام (commit) كنص سداسي عشري. القيمة الافتراضية هي رأس فرع `"main"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند إنشاء فرع على مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند وضع علامة على نموذج. القيمة الافتراضية هي `None`.

exist_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا ترفع خطأً إذا كان الفرع موجودًا مسبقًا.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- إذا كان المرجع غير صالح لفرع. مثال: `refs/pr/5` أو 'refs/foo/bar'.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- إذا كان الفرع موجودًا مسبقًا في المستودع (خطأ 409) وكان `exist_ok` مضبوطًا على `False`.

أنشئ فرعًا جديدًا لمستودع على Hub، بدءًا من المراجعة المحددة (الافتراضي هو `main`). للعثور على مراجعة تناسب احتياجاتك، يمكنك استخدام [list_repo_refs()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_repo_refs) أو [list_repo_commits()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_repo_commits).

#### create_bucket[[huggingface_hub.HfApi.create_bucket]]

```python
create_bucket(bucket_id: str, private: bool | None = None, visibility: Literal['public', 'private'] | None = None, resource_group_id: str | None = None, region: REPO_REGIONS | None = None, exist_ok: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13955)

**المعاملات:**

bucket_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم حاوية مفصولان بـ `/`. إذا لم تُقدَّم مساحة أسماء، فسيتم إنشاء الحاوية في مساحة أسماء المستخدم الحالي.

private (`bool`، *اختياري*) : ما إذا كان سيتم جعل الدلو خاصًا. إذا كان `None` (الافتراضي)، فسيكون الدلو عامًا ما لم يكن الافتراضي الخاص بالمنظمة هو الخاص. لا يمكن تمريره مع `visibility`.

visibility (`Literal["public", "private"]`, *اختياري*) : مدى ظهور الدلو. يمكن أن يكون `"public"` أو `"private"`. إذا كان `None` (الافتراضي)، فسيكون الدلو عامًا ما لم يكن الافتراضي الخاص بالمنظمة هو الخاص.

resource_group_id (`str`, *اختياري*) : مجموعة الموارد التي سيتم إنشاء الدلو فيها. مجموعات الموارد متاحة فقط لمنظمات Enterprise Hub، وتتيح تحديد أعضاء المنظمة الذين يمكنهم الوصول إلى المورد. يمكن العثور على معرّف مجموعة الموارد في عنوان URL لصفحة المورد على Hub (مثل `"66670e5163145ca562cb1988"`). لمعرفة المزيد حول مجموعات الموارد، راجع https://huggingface.co/docs/hub/en/security-resource-groups.

region (`Literal["us", "eu"]`, *اختياري*) : منطقة السحابة التي سيتم فيها إنشاء الدلو. يمكن أن تكون `"us"` أو `"eu"`. إذا لم يتم تحديد المنطقة، فسيتم إنشاء الدلو في المنطقة الافتراضية. يتطلب خطة فريق أو أعلى.

exist_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا يتم رفع خطأ إذا كان الدلو موجودًا مسبقًا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [BucketUrl](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketUrl)

رابط URL إلى الدلو (bucket) الذي تم إنشاؤه حديثًا ويحتوي على سمات مثل `endpoint` و`namespace` و`bucket_id`.

أنشئ دلو على Hub.

مثال:
```python
>>> from huggingface_hub import create_bucket

>>> url = create_bucket(bucket_id="my-bucket")
>>> url.bucket_id
'user/my-bucket'
>>> url.url
'https://huggingface.co/buckets/user/my-bucket'
>>> url.uri.to_uri()
'hf://buckets/user/my-bucket'

>>> create_bucket(bucket_id="my-bucket", private=True, exist_ok=True)
BucketUrl(...)

>>> create_bucket(bucket_id="my-bucket", region="us")
BucketUrl(...)
```

#### create_collection[[huggingface_hub.HfApi.create_collection]]

```python
create_collection(title: str, namespace: str | None = None, description: str | None = None, private: bool = False, resource_group_id: str | None = None, exists_ok: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10195)

**المعاملات:**

title (`str`) : عنوان المجموعة التي سيتم إنشاؤها. مثال: `"Recent models"`.

namespace (`str`، *اختياري*) : مساحة الاسم الخاصة بالمجموعة التي سيتم إنشاؤها (اسم المستخدم أو المنظمة). سيُستخدم اسم المالك افتراضيًا.

description (`str`، *اختياري*) : وصف المجموعة التي سيتم إنشاؤها. الحد الأقصى لحجم الوصف هو 150 حرفًا.

private (`bool`، *اختياري*) : ما إذا كان يجب أن تكون المجموعة خاصة أم لا. الافتراضي هو `False` (أي مجموعة عامة).

resource_group_id (`str`، *اختياري*) : إسناد المجموعة إلى مجموعة موارد تابعة للمنظمة المالكة. صالح فقط للمجموعات المملوكة للمنظمة. معرّف مجموعة الموارد هو نص سداسي عشري مكون من 24 حرفًا.

exists_ok (`bool`، *اختياري*) : إذا كان `True`، فلا ترفع خطأً إذا كان المجموعة موجودة بالفعل.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

أنشئ مجموعة جديدة على Hub.

يعيد: [Collection](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.Collection)

مثال:

```py
>>> from huggingface_hub import create_collection
>>> collection = create_collection(
...     title="ICCV 2023",
...     description="Portfolio of models, papers and demos I presented at ICCV 2023",
... )
>>> collection.slug
"username/iccv-2023-64f9a55bb3115b4f513ec026"
```

#### create_commit[[huggingface_hub.HfApi.create_commit]]

```python
create_commit(repo_id: str, operations: Iterable[CommitOperation], commit_message: str, commit_description: str | None = None, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, num_threads: int = 5, parent_commit: str | None = None, run_as_future: bool = False, _hot_reload: bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L5021)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم فيه إنشاء الالتزام، على سبيل المثال: `"username/custom_transformers"`

operations (`Iterable` من `~hf_api.CommitOperation`) : قابل للتكرار من العمليات التي يجب تضمينها في الالتزام، أي: - `~hf_api.CommitOperationAdd` لرفع ملف - `~hf_api.CommitOperationDelete` لحذف ملف - `~hf_api.CommitOperationCopy` لنسخ ملف  ستُعدَّل كائنات العمليات لتضمين معلومات تتعلق بالرفع. لا تعِد استخدام نفس الكائنات لالتزامات متعددة.

commit_message (`str`) : ملخص (السطر الأول) للالتزام الذي سيتم إنشاؤه.

commit_description (`str`، *اختياري*) : وصف الالتزام الذي سيتم إنشاؤه

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` أو `"kernel"` عند الرفع إلى مستودع مجموعة بيانات أو مساحة أو نواة، أو على `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

create_pr (`boolean`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب (Pull Request) مع ذلك الالتزام أم لا. القيمة الافتراضية هي `False`. إذا لم يتم تعيين `revision`، يُفتح طلب السحب ضد الفرع `"main"`. إذا تم تعيين `revision` وكان فرعًا، يُفتح طلب السحب ضد هذا الفرع. إذا تم تعيين `revision` ولم يكن اسم فرع (مثال: معرف التزام)، يُرجع الخادم `RevisionNotFoundError`.

num_threads (`int`, *اختياري*) : عدد الخيوط المتزامنة لرفع الملفات. القيمة الافتراضية هي 5. ضبطها على 2 يعني أن أقصى عدد من الملفات التي يمكن رفعها بالتزامن هو 2.

parent_commit (`str`, *اختياري*) : معرف OID / SHA للالتزام الأب، كسلسلة سداسية عشرية. يتم دعم الاختصارات (الأحرف السبعة الأولى) أيضًا. إذا تم تحديده وكان `create_pr` هو `False`، فسيفشل الالتزام إذا لم يشير `revision` إلى `parent_commit`. إذا تم تحديده وكان `create_pr` هو `True`، فسيتم إنشاء طلب السحب من `parent_commit`. يضمن تحديد `parent_commit` عدم تغيير المستودع قبل الالتزام بالتغييرات، وقد يكون مفيدًا بشكل خاص إذا تم تحديث المستودع / الالتزام به بشكل متزامن.

run_as_future (`bool`, *اختياري*) : ما إذا كان سيتم تنفيذ هذه الطريقة في الخلفية أم لا. تُنفَّذ مهام الخلفية بشكل تسلسلي دون تعطيل الخيط الرئيسي. تمرير `run_as_future=True` سيعيد كائن [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects). القيمة الافتراضية هي `False`.

**يعيد:** [CommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitInfo) أو `Future`

مثال من [CommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitInfo) يحتوي على معلومات حول الالتزام الجديد الذي تم إنشاؤه (تجزئة الالتزام، رابط الالتزام، رابط طلب الدمج، رسالة الالتزام، ...). إذا تم تمرير `run_as_future=True`، تُرجع كائن Future الذي سيحتوي على النتيجة عند التنفيذ.

**يرفع:** ``ValueError`` أو [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كانت رسالة الالتزام فارغة.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا لم يكن التثبيت الأب OID صالحًا.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا تم إرسال ملف README.md يحتوي على قسم بيانات وصفية غير صالح. في هذه الحالة، سيفشل الإرسال مبكرًا، قبل محاولة رفع أي ملف.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كان `create_pr` هو `True` وكان الإصدار (revision) ليس `None` وليس `"main"`.
- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.

ينشئ التزام في المستودع المحدد، مع حذف الملفات ورفعها حسب الحاجة.

> [!WARNING]
> سيتم تعديل قائمة الإدخال من `CommitOperation` أثناء عملية الالتزام. لا تعيد استخدام نفس الكائنات لعمليات التزام متعددة.

> [!WARNING]
> `create_commit` يفترض أن المستودع موجود مسبقًا على Hub. إذا واجهت خطأ Client 404، فتأكد من أنك مسجّل الدخول، وأن رمزك (token) يحمل الصلاحيات المطلوبة، وأن `repo_id` و`repo_type` مضبوطة بشكل صحيح. إذا لم يكن المستودع موجودًا، أنشئه أولًا باستخدام [create_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_repo).

> [!WARNING]
> `create_commit` محدود بـ 25 ألف ملف LFS وحجم حمولة يبلغ 1 جيجابايت للملفات العادية.

#### create_discussion[[huggingface_hub.HfApi.create_discussion]]

```python
create_discussion(repo_id: str, title: str, token: bool | str | None = None, description: str | None = None, repo_type: str | None = None, pull_request: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7445)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

title (`str`) : عنوان المناقشة. يمكن أن يصل طوله إلى 200 حرف، ويجب ألا يقل عن 3 أحرف. سيتم إزالة المسافات البيضاء في البداية والنهاية.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

description (`str`، *اختياري*) : وصف اختياري لطلب الدمج. القيمة الافتراضية هي `"Discussion opened with the huggingface_hub Python library"`

pull_request (`bool`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب أو نقاش. إذا كان `True`، يتم إنشاء طلب سحب. إذا كان `False`، يتم إنشاء نقاش. القيمة الافتراضية هي `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

ينشئ نقاشاً أو طلب سحب.

ستكون طلبات الدمج (Pull Requests) التي يتم إنشاؤها برمجياً في حالة `"draft"`.

يمكن أيضًا إنشاء طلب سحب يتضمن التغييرات دفعة واحدة باستخدام [HfApi.create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit).

يعيد: [DiscussionWithDetails](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionWithDetails)

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### create_inference_endpoint[[huggingface_hub.HfApi.create_inference_endpoint]]

```python
create_inference_endpoint(name: str, repository: str, framework: str, accelerator: str, instance_size: str, instance_type: str, region: str, vendor: str, account_id: str | None = None, private_link_account_id: str | None = None, private_link_region: str | None = None, min_replica: int = 1, max_replica: int = 1, scaling_metric: InferenceEndpointScalingMetric | None = None, scaling_threshold: float | None = None, scale_to_zero_timeout: int | None = None, revision: str | None = None, task: str | None = None, custom_image: dict | None = None, container_registry_username: str | None = None, container_registry_password: str | None = None, container_command: list[str] | None = None, container_args: list[str] | None = None, env: dict[str, str] | None = None, secrets: dict[str, str] | None = None, type: InferenceEndpointType | str = <InferenceEndpointType.AUTHENTICATED: 'authenticated'>, domain: str | None = None, path: str | None = None, cache_http_responses: bool | None = None, tags: list[str] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9210)

**المعاملات:**

name (`str`) : الاسم الفريد لنقطة الاستدلال الجديدة.

repository (`str`) : اسم مستودع النموذج المرتبط بنقطة الاستدلال (Inference Endpoint) (مثل `"gpt2"`).

framework (`str`) : إطار تعلّم الآلة المستخدم للنموذج (مثل `"custom"`).

accelerator (`str`) : مُسرِّع العتاد الذي سيتم استخدامه للاستدلال (مثل `"cpu"`).

instance_size (`str`) : حجم أو نوع المثيل الذي سيُستخدم لاستضافة النموذج (مثل `"x4"`).

instance_type (`str`) : نوع مثيل السحابة الذي سيتم نشر نقطة الاستدلال (Inference Endpoint) عليه (مثل `"intel-icl"`).

region (`str`) : منطقة السحابة التي سيتم فيها إنشاء نقطة النهاية للاستدلال (مثل `"us-east-1"`).

vendor (`str`) : مزوّد السحابة أو البائع الذي سيُستضاف عليه نقطة الاستدلال (Inference Endpoint) (مثلًا `"aws"`).

account_id (`str`، *اختياري*) : تم إيقاف استخدامه وتجاهله. استخدم `private_link_account_id` و`private_link_region` لإعداد AWS PrivateLink.

private_link_account_id (`str`، *اختياري*) : معرّف حساب AWS المسموح له بالوصول إلى نقطة النهاية للاستدلال عبر AWS PrivateLink. يتطلب `private_link_region`.

private_link_region (`str`, *اختياري*) : منطقة AWS لنقطة الدخول الخاصة بـ PrivateLink (`"us-east-1"` أو `"eu-west-1"`)، حيث سيتصل بها نقطة النهاية الخاصة بـ VPC الخاصة بـ `private_link_account_id`. وهي مستقلة عن منطقة `region` ومورّد `vendor` للحوسبة.

min_replica (`int`, *اختياري*) : الحد الأدنى لعدد النسخ (المهام) التي يجب إبقاؤها قيد التشغيل لنقطة الاستدلال. لتفعيل التوسع إلى الصفر، اضبط هذه القيمة على 0 وعدّل `scale_to_zero_timeout` وفقًا لذلك. القيمة الافتراضية هي 1.

max_replica (`int`، *اختياري*) : الحد الأقصى لعدد النسخ (المهام) التي يمكن التوسع إليها لنقطة الاستدلال. القيمة الافتراضية هي 1.

scaling_metric (`str` أو `InferenceEndpointScalingMetric `، *اختياري*) : مرجع المقياس للتوسع. إما "pendingRequests" أو "hardwareUsage" عند تقديمه. القيمة الافتراضية هي None (أي: اترك خدمة HF Endpoints تحدد المقياس).

scaling_threshold (`float`, *اختياري*) : عتبة مقياس التوسيع المستخدمة لتفعيل التوسيع. يتم تجاهلها عندما لا يُوفَّر مقياس التوسيع. القيمة الافتراضية هي None (أي: اترك خدمة HF Endpoints تحدد العتبة).

scale_to_zero_timeout (`int`, *اختياري*) : المدة بالدقائق قبل أن يُخفَّض الطرف غير النشط إلى صفر، أو لا يُخفَّض إلى صفر إذا تم تعيينه إلى None وكان `min_replica` غير 0. القيمة الافتراضية هي None.

revision (`str`، *اختياري*) : المراجعة المحددة للنموذج التي سيتم نشرها على نقطة الاستدلال (Inference Endpoint) (مثل `"6c0e6080953db56375760c0471a8c5f2929baf11"`).

task (`str`، *اختياري*) : المهمة التي سيتم نشر النموذج عليها (مثل `"text-classification"`).

custom_image (`dict`, *اختياري*) : صورة الحاوية التي سيتم تشغيلها. إما قاموس مفاتيحه هي نسخ الصور (مثل `{"vLLM": {"url": "vllm/vllm-openai:v0.23.0", "port": 8000}}`، وكذلك `sGLang`، `tgi`، `tei`، `llamacpp`، `hfServe`، ...)، والذي يُمرَّر كما هو، أو قاموس مسطّح يصف حاوية مخصصة (مثل `{"url": ..., "port": ...}`)، والذي يُرسل على شكل `{"custom": ...}` (انظر الأمثلة). القيمة الافتراضية هي الصورة المُدارة من قِبل Hugging Face.

container_registry_username (`str`، *اختياري*) : اسم المستخدم المستخدم للمصادقة مع السجل الذي يستضيف صورة حاوية مخصصة.

container_registry_password (`str`, *اختياري*) : كلمة المرور المستخدمة للمصادقة مع المستودع الذي يستضيف صورة حاوية مخصصة. يتطلب `container_registry_username`. يُستثنى من حمولة الواجهة البرمجية للتطبيقات (API payload) عند عدم تقديمه.

container_command (`list[str]`، *اختياري*) : تجاوز أمر نقطة الدخول للحاوية (يتوافق مع `model.command` في حمولة الواجهة البرمجية). يعمل مع صور المحركات المُدارة (مثل vLLM وSGLang) والصور المخصصة.

container_args (`list[str]`، *اختياري*) : الحُجج المُلحَقة بنقطة دخول الحاوية (تتوافق مع `model.args` في حمولة الواجهة البرمجية). تعمل مع صور المحركات المُدارة (مثل vLLM وSGLang) والصور المخصصة.

env (`dict[str, str]`، *اختياري*) : متغيرات بيئة غير سرية تُحقن في بيئة الحاوية.

secrets (`dict[str, str]`، *اختياري*) : قيم سرية تُحقن في بيئة الحاوية.

type ([`InferenceEndpointType]`، *اختياري*) : نوع نقطة الاستدلال (Inference Endpoint)، والذي يمكن أن يكون `"authenticated"` (افتراضيًا)، أو `"public"`، أو `"private"`.

domain (`str`، *اختياري*) : المجال المخصص لنشر نقطة الاستدلال، فإذا تم ضبطه ستكون نقطة الاستدلال متاحة عبر هذا المجال (مثلًا `"my-new-domain.cool-website.woof"`).

path (`str`، *اختياري*) : المسار المخصص للنموذج المُنفَّذ، يجب أن يبدأ بـ `/` (مثل `"/models/google-bert/bert-base-uncased"`).

cache_http_responses (`bool`، *اختياري*) : ما إذا كان سيتم تخزين استجابات HTTP من نقطة الاستدلال مؤقتًا. القيمة الافتراضية هي `False`.

tags (`list[str]`، *اختياري*) : قائمة بالوسوم التي سيتم ربطها بنقطة الاستدلال (Inference Endpoint).

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها إنشاء نقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة الاستدلال المحدّثة.

أنشئ نقطة استنتاج جديدة.

تعتمد قيم `accelerator` و`instance_size` و`instance_type` و`region` و`vendor` على بعضها البعض؛ استخدم [list_inference_endpoints_hardware()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_inference_endpoints_hardware) لعرض التوليفات الصالحة.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.create_inference_endpoint(
...     "my-endpoint-name",
...     repository="gpt2",
...     framework="pytorch",
...     task="text-generation",
...     accelerator="cpu",
...     vendor="aws",
...     region="us-east-1",
...     type="authenticated",
...     instance_size="x2",
...     instance_type="intel-icl",
... )
>>> endpoint
InferenceEndpoint(name='my-endpoint-name', status="pending",...)

# Run inference on the endpoint
>>> endpoint.client.text_generation(...)
"..."
```

```python
# Start an Inference Endpoint running Zephyr-7b-beta on TGI
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.create_inference_endpoint(
...     "aws-zephyr-7b-beta-0486",
...     repository="HuggingFaceH4/zephyr-7b-beta",
...     framework="pytorch",
...     task="text-generation",
...     accelerator="gpu",
...     vendor="aws",
...     region="us-east-1",
...     type="authenticated",
...     instance_size="x1",
...     instance_type="nvidia-a10g",
...     env={
...           "MAX_BATCH_PREFILL_TOKENS": "2048",
...           "MAX_INPUT_LENGTH": "1024",
...           "MAX_TOTAL_TOKENS": "1512",
...           "MODEL_ID": "/repository"
...         },
...     custom_image={
...         "healthRoute": "/health",
...         "url": "ghcr.io/huggingface/text-generation-inference:1.1.0",
...     },
...    secrets={"MY_SECRET_KEY": "secret_value"},
...    tags=["dev", "text-generation"],
... )
```

```python
# Start an Inference Endpoint running ProsusAI/finbert while scaling to zero in 15 minutes
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.create_inference_endpoint(
...     "finbert-classifier",
...     repository="ProsusAI/finbert",
...     framework="pytorch",
...     task="text-classification",
...     min_replica=0,
...     scale_to_zero_timeout=15,
...     accelerator="cpu",
...     vendor="aws",
...     region="us-east-1",
...     type="authenticated",
...     instance_size="x2",
...     instance_type="intel-icl",
... )
>>> endpoint.wait(timeout=300)
# Run inference on the endpoint
>>> endpoint.client.text_classification("The financial outlook is positive.")
```

#### create_inference_endpoint_from_catalog[[huggingface_hub.HfApi.create_inference_endpoint_from_catalog]]

```python
create_inference_endpoint_from_catalog(repo_id: str | None = None, recipe_id: str | None = None, name: str | None = None, accelerator: Literal['cpu', 'gpu', 'neuron'] | str | None = None, gguf_file: str | None = None, token: bool | str | None = None, namespace: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9506)

**المعاملات:**

repo_id (`str`، *اختياري*) : المعرّف الخاص بالنموذج في الكتالوج الذي سيتم نشره كنقطة استنتاج. يتعارض مع `recipe_id`.

recipe_id (`str`، *اختياري*) : المعرّف الخاص بوصفة الكتالوج التي سيتم نشرها (انظر [InferenceCatalogRecipe](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceCatalogRecipe)). يتعارض مع `repo_id`.

name (`str`، *اختياري*) : الاسم الفريد لنقطة الاستدلال الجديدة. إذا لم يُقدَّم، فسيتم توليد اسم عشوائي.

accelerator (`str`, *اختياري*) : مُسرِّع العتاد الذي سيُستخدم للاستدلال. تشمل القيم الممكنة `"cpu"`، و`"gpu"`، و`"neuron"`. إذا لم يُقدَّم، فسيستخدم الخادم قيمة افتراضية مناسبة للنموذج. صالح فقط مع `repo_id`.

gguf_file (`str`, *اختياري*) : ملف GGUF الذي سيتم نشره، وذلك للنماذج التي تحتوي على وصفة واحدة لكل كمية (e.g. `"Qwen2.5-Coder-32B-Instruct-Q4_K_M.gguf"`). صالح فقط مع `repo_id`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication).

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها إنشاء نقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة الاستدلال الجديدة.

أنشئ نقطة استنتاج جديدة من كتالوج الاستنتاج الخاص بـ Hugging Face.

يهدف كتالوج الاستدلال إلى تقديم قائمة مُنتقاة من النماذج المُحسّنة للاستدلال والتي تم اختبار الإعدادات الافتراضية لها. راجع https://endpoints.huggingface.co/catalog للاطلاع على قائمة النماذج المتاحة في الكتالوج.

يتم نشر كل نموذج في الكتالوج عبر *وصفة*: وهي مجموعة من العتاد ومحرك الاستدلال التي تم اختبارها لهذا النموذج. مرّر `repo_id` لنشر الوصفة الافتراضية للنموذج، مع إمكانية تضييق النطاق اختياريًا باستخدام `accelerator` و`gguf_file`، أو مرّر `recipe_id` لنشر وصفة محددة تمامًا من تلك التي تُعرض بواسطة [list_inference_catalog()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_inference_catalog).

> [!WARNING]
> `create_inference_endpoint_from_catalog` تجريبي. قد تتغير واجهته البرمجية (API) في المستقبل. يرجى تقديم ملاحظاتك إذا كان لديك أي اقتراحات أو طلبات.

#### create_pull_request[[huggingface_hub.HfApi.create_pull_request]]

```python
create_pull_request(repo_id: str, title: str, token: bool | str | None = None, description: str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7534)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

title (`str`) : عنوان المناقشة. يمكن أن يصل طوله إلى 200 حرف، ويجب ألا يقل عن 3 أحرف. سيتم إزالة المسافات البيضاء في البداية والنهاية.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

description (`str`، *اختياري*) : وصف اختياري لطلب الدمج. القيمة الافتراضية هي `"Discussion opened with the huggingface_hub Python library"`

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

ينشئ طلب سحب. تكون طلبات السحب التي يتم إنشاؤها برمجياً في حالة `"draft"`.

يمكن أيضًا إنشاء طلب سحب يتضمن التغييرات دفعة واحدة باستخدام [HfApi.create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit);

هذا غلاف حول [HfApi.create_discussion()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_discussion).

يعيد: [DiscussionWithDetails](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionWithDetails)

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### create_repo[[huggingface_hub.HfApi.create_repo]]

```python
create_repo(repo_id: str, token: str | bool | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, repo_type: str | None = None, exist_ok: bool = False, resource_group_id: str | None = None, region: REPO_REGIONS | None = None, space_sdk: str | None = None, space_hardware: SpaceHardware | None = None, space_sleep_time: int | None = None, space_secrets: list[dict[str, str]] | None = None, space_variables: list[dict[str, str]] | None = None, space_volumes: list[Volume] | None = None, space_template: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4581)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

private (`bool`، *اختياري*) : ما إذا كان سيتم جعل المستودع خاصًا. إذا كان `None` (الافتراضي)، فسيكون المستودع عامًا ما لم يكن الافتراضي للمنظمة هو الخاص. يتم تجاهل هذه القيمة إذا كان المستودع موجودًا بالفعل. لا يمكن تمريرها مع `visibility`.

visibility (`Literal["public", "private", "protected"]`، *اختياري*) : مدى ظهور المستودع. يمكن أن يكون `"public"` أو `"private"`، أو `"protected"` لـ Spaces. إذا كان `None` (الافتراضي)، فسيكون المستودع عامًا ما لم يكن الافتراضي للمنظمة خاصًا. يتم تجاهل هذه القيمة إذا كان المستودع موجودًا بالفعل.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

exist_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا يتم رفع خطأ إذا كان المستودع موجودًا مسبقًا.

resource_group_id (`str`, *اختياري*) : مجموعة الموارد التي سيتم إنشاء المستودع فيها. مجموعات الموارد متاحة فقط لمنظمات Enterprise Hub، وتتيح تحديد أعضاء المنظمة الذين يمكنهم الوصول إلى المورد. يمكن العثور على معرّف مجموعة الموارد في عنوان URL لصفحة المورد على Hub (مثل `"66670e5163145ca562cb1988"`). لمعرفة المزيد حول مجموعات الموارد، راجع https://huggingface.co/docs/hub/en/security-resource-groups.

region (`Literal["us", "eu"]`, *اختياري*) : منطقة السحابة التي سيتم فيها إنشاء المستودع. يمكن أن تكون `"us"` أو `"eu"`. إذا لم يتم تحديد منطقة، فسيتم إنشاء المستودع في المنطقة الافتراضية. يتطلب خطة Team أو أعلى.

space_sdk (`str`, *اختياري*) : اختيار SDK للاستخدام إذا كان repo_type هو "space". يمكن أن يكون "streamlit" أو "gradio" أو "docker" أو "static". مساحات `"static"` مجانية للجميع. أما SDKs الأخرى فتعمل على الحوسبة: على العتاد المجاني `cpu-basic`، تتطلب اشتراكًا (PRO للمستخدمين، أو Team أو Enterprise للمنظمات)، بينما يتطلب العتاد المدفوع فقط الفوترة (طريقة دفع وأرصدة مسبقة الدفع).

space_hardware (`SpaceHardware` أو `str`، *اختياري*) : اختيار العتاد إذا كان repo_type هو "space". راجع [SpaceHardware](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceHardware) للحصول على قائمة كاملة.

space_sleep_time (`int`، *اختياري*) : عدد ثوانٍ من عدم النشاط التي يجب انتظارها قبل وضع مساحة في وضع السكون. اضبط القيمة على `-1` إذا كنت لا تريد لمساحتك أن تدخل في وضع السكون (وهو السلوك الافتراضي للأجهزة المُحدَّثة). أما بالنسبة للأجهزة المجانية، فلا يمكنك ضبط وقت السكون (القيمة ثابتة عند 48 ساعة من عدم النشاط). راجع https://huggingface.co/docs/hub/spaces-gpus#sleep-time لمزيد من التفاصيل.

space_secrets (`list[dict[str, str]]`، *اختياري*) : قائمة بمفاتيح سرية يجب ضبطها في مساحتك. كل عنصر يكون على شكل `{"key": ..., "value": ..., "description": ...}` حيث يكون الوصف اختياريًا. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

space_variables (`list[dict[str, str]]`، *اختياري*) : قائمة بمتغيرات البيئة العامة التي يجب ضبطها في مساحتك. كل عنصر يكون على شكل `{"key": ..., "value": ..., "description": ...}` حيث يكون الوصف اختياريًا. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.

space_volumes (`list[Volume]`، *اختياري*) : قائمة من كائنات [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) لتثبيتها في المساحة عند الإنشاء. يحتوي كل حجم على `type` (`"bucket"` أو `"model"` أو `"dataset"` أو `"space"`)، و`source` (معرّف المستودع أو الدلو)، و`mount_path` (المسار داخل الحاوية)، وحقول اختيارية `revision` و`read_only` و`path`. ينطبق فقط إذا كان repo_type هو "space".

space_template (`str`, *اختياري*) : تهيئة المساحة الجديدة من قالب رسمي. يمكن أن يكون معرّف مستودع القالب (مثل `"SpacesExamples/jupyterlab"`) أو اسمه المختصر (مثل `"JupyterLab"`). استخدم [HfApi.list_space_templates()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_space_templates) لعرض القوالب المتاحة. ينطبق فقط إذا كان repo_type هو "space". إذا كان يُوصى بأن يكون القالب خاصاً ولم يتم تحديد مستوى الرؤية صراحةً، فسيتم إنشاء المساحة كخاصة.

**يعيد:** [RepoUrl](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.RepoUrl)

رابط إلى المستودع الذي تم إنشاؤه حديثاً. القيمة هي فئة فرعية من `str` تحتوي على سمات مثل `endpoint` و`repo_type` و`repo_id`.

أنشئ مستودعًا فارغًا على HuggingFace Hub.

#### create_scheduled_job[[huggingface_hub.HfApi.create_scheduled_job]]

```python
create_scheduled_job(image: str, command: list[str], schedule: str, suspend: bool | None = None, concurrency: bool | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13077)

**المعاملات:**

image (`str`) : صورة Docker التي سيتم استخدامها. أمثلة: `"ubuntu"`، `"python:3.12"`، `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`. مثال باستخدام صورة من Space: `"hf.co/spaces/lhoestq/duckdb"`.

command (`list[str]`) : الأمر الذي سيتم تنفيذه. مثال: `["echo", "hello"]`.

schedule (`str`) : أحد "@annually" أو "@yearly" أو "@monthly" أو "@weekly" أو "@daily" أو "@hourly"، أو تعبير جدولة CRON (مثل '0 9 * * 1' للساعة 9 صباحًا كل يوم اثنين).

suspend (`bool`، *اختياري*) : إذا كانت القيمة True، يتم تعليق (إيقاف مؤقت) المهمة المجدولة. القيمة الافتراضية هي False.

concurrency (`bool`، *اختياري*) : إذا كانت القيمة True، يمكن تشغيل عدة نسخ من هذا Job بالتوازي. القيمة الافتراضية هي False.

env (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة الخاصة بالمهمة.

secrets (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة السرية للعمل.

flavor (`str`، *اختياري*) : نوع العتاد. راجع `JobHardware` لمعرفة القيم الممكنة. القيمة الافتراضية هي `"cpu-basic"`.

timeout (`Union[int, float, str]`، *اختياري*) : الحد الأقصى لمدة المهمة: int مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام). مثال: `300` أو `"5m"` لمدة 5 دقائق.

attempts (`int`، *اختياري*) : الحد الأقصى لعدد المحاولات لكل تشغيل، بما في ذلك المحاولة الأولى. القيمة الافتراضية هي 1.

name (`str`, *اختياري*) : اسم للوظيفة المجدولة. يُخزَّن كوسم `name`. لا يمكن تمريره مع مفتاح `name` ضمن `labels`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم مشتق من الصورة والأمر (مع لاحقة تجزئة قصيرة).

labels (`dict[str, str]`، *اختياري*) : التسميات التي سيتم إرفاقها بالمهمة (أزواج مفتاح-قيمة).

volumes (`list[Volume]`، *اختياري*) : دلاء أو مستودعات Hugging Face لتثبيتها كمجلدات في حاوية المهمة. كل مجلد هو [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) مع `type` (`"bucket"`، `"model"`، `"dataset"`، أو `"space"`)، و`source` (مثل `"username/my-bucket"`)، و`mount_path` (مثل `"/data"`).

expose (`list[int]`، *اختياري*) : منصات الحاوية التي يجب كشفها عبر وكيل المهام. كل منصة مدرجة يمكن الوصول إليها عبر نطاق المهام العام (مثل `https://<job_id>--8000.hf.jobs`). يتطلب الوصول دائمًا رمز HF مع صلاحية القراءة في مساحة أسماء المهمة. استخدم `expose_public` للوصول دون مصادقة.

expose_public (`list[int]`، *اختياري*) : المنافذ التي يجب كشفها عبر وكيل Jobs دون مصادقة. لا يلزم إدراجها في `expose`.

resource_group_id (`str`, *اختياري*) : المعرّف لمجموعة الموارد التي سيتم إنشاء مهمة الجدولة فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق. إذا لم يُقدَّم، فسيتم إنشاء مهمة الجدولة خارج أي مجموعة موارد.

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها إنشاء المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

أنشئ مهام حساب مجدولة على بنية Hugging Face التحتية.

مثال:

أنشئ مهمة مجدولة أولى:

```python
>>> from huggingface_hub import create_scheduled_job
>>> create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], schedule="@hourly")
```

استخدم تعبير جدولة CRON:

```python
>>> from huggingface_hub import create_scheduled_job
>>> create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('this runs every 5min')"], schedule="*/5 * * * *")
```

إنشاء مهمة GPU مجدولة:

```python
>>> from huggingface_hub import create_scheduled_job
>>> image = "pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"
>>> command = ["python", "-c", "import torch; print(f'This code ran with the following GPU: {torch.cuda.get_device_name()}')"]
>>> create_scheduled_job(image=image, command=command, flavor="a10g-small", schedule="@hourly")
```

#### create_scheduled_uv_job[[huggingface_hub.HfApi.create_scheduled_uv_job]]

```python
create_scheduled_uv_job(script: str, script_args: list[str] | None = None, schedule: str, suspend: bool | None = None, concurrency: bool | None = None, dependencies: list[str] | None = None, python: str | None = None, image: str | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13556)

**المعاملات:**

script (`str`) : مسار أو عنوان URL لسكربت UV، أو أمر.

script_args (`list[str]`، *اختياري*) : الحُجج المراد تمريرها إلى السكربت أو الأمر.

schedule (`str`) : أحد "@annually" أو "@yearly" أو "@monthly" أو "@weekly" أو "@daily" أو "@hourly"، أو تعبير جدولة CRON (مثل '0 9 * * 1' للساعة 9 صباحًا كل يوم اثنين).

suspend (`bool`، *اختياري*) : إذا كانت القيمة True، يتم تعليق (إيقاف مؤقت) المهمة المجدولة. القيمة الافتراضية هي False.

concurrency (`bool`، *اختياري*) : إذا كانت القيمة True، يمكن تشغيل عدة نسخ من هذا Job بالتوازي. القيمة الافتراضية هي False.

dependencies (`list[str]`، *اختياري*) : التبعيات المستخدمة لتشغيل سكربت UV.

python (`str`، *اختياري*) : استخدم إصدارًا محددًا من بايثون. الافتراضي هو 3.12.

image (`str`، *اختياري*، القيمة الافتراضية هي "ghcr.io/astral-sh/uv --python3.12-bookworm"): استخدم صورة Docker مخصصة مع تثبيت `uv`.

env (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة الخاصة بالمهمة.

secrets (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة السرية للعمل.

flavor (`str`، *اختياري*) : نوع العتاد. راجع `JobHardware` لمعرفة القيم الممكنة. القيمة الافتراضية هي `"cpu-basic"`.

timeout (`Union[int, float, str]`، *اختياري*) : الحد الأقصى لمدة المهمة: int مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام). مثال: `300` أو `"5m"` لمدة 5 دقائق.

attempts (`int`، *اختياري*) : الحد الأقصى لعدد المحاولات لكل تشغيل، بما في ذلك المحاولة الأولى. القيمة الافتراضية هي 1.

name (`str`, *اختياري*) : اسم للوظيفة المجدولة. يُخزَّن كوسم `name`. لا يمكن تمريره مع مفتاح `name` ضمن `labels`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم مشتق من السكربت وحوامله (مع لاحقة تجزئة قصيرة).

labels (`dict[str, str]`، *اختياري*) : التسميات التي سيتم إرفاقها بالمهمة (أزواج مفتاح-قيمة).

volumes (`list[Volume]`، *اختياري*) : دلاء أو مستودعات Hugging Face لتثبيتها كمجلدات في حاوية المهمة. كل مجلد هو [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) مع `type` (`"bucket"`، `"model"`، `"dataset"`، أو `"space"`)، و`source` (مثل `"username/my-bucket"`)، و`mount_path` (مثل `"/data"`).

expose (`list[int]`، *اختياري*) : منصات الحاوية التي يجب كشفها عبر وكيل المهام. كل منصة مدرجة يمكن الوصول إليها عبر نطاق المهام العام (مثل `https://<job_id>--8000.hf.jobs`). يتطلب الوصول دائمًا رمز HF مع صلاحية القراءة في مساحة أسماء المهمة. استخدم `expose_public` للوصول دون مصادقة.

expose_public (`list[int]`، *اختياري*) : المنافذ التي يجب كشفها عبر وكيل Jobs دون مصادقة. لا يلزم إدراجها في `expose`.

resource_group_id (`str`, *اختياري*) : المعرّف لمجموعة الموارد التي سيتم إنشاء مهمة الجدولة فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق. إذا لم يُقدَّم، فسيتم إنشاء مهمة الجدولة خارج أي مجموعة موارد.

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها إنشاء المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

شغّل مهمة سكربت UV على بنية Hugging Face التحتية.

> [!WARNING]
> على عكس `hf jobs uv run`، يتجاهل هذا الأسلوب الجدول الاختياري `[tool.hf-jobs]` الذي يمكن أن يحمله سكربت UV في ترويسة PEP 723 الخاصة به (انظر [دليل الوظائف](../guides/jobs#ship-the-launch-config-with-the-script)): يجب تمرير إعداد الإطلاق هنا بشكل صريح.

مثال:

جدولة سكربت من عنوان URL:

```python
>>> from huggingface_hub import create_scheduled_uv_job
>>> script = "https://raw.githubusercontent.com/huggingface/trl/refs/heads/main/trl/scripts/sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small", schedule="@weekly")
```

جدولة سكربت محلي:

```python
>>> from huggingface_hub import create_scheduled_uv_job
>>> script = "my_sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small", schedule="@weekly")
```

جدولة أمر:

```python
>>> from huggingface_hub import create_scheduled_uv_job
>>> script = "lighteval"
>>> script_args= ["endpoint", "inference-providers", "model_name=openai/gpt-oss-20b,provider=auto", "lighteval|gsm8k|0|0"]
>>> create_scheduled_uv_job(script, script_args=script_args, dependencies=["lighteval"], flavor="a10g-small", schedule="@weekly")
```

#### create_tag[[huggingface_hub.HfApi.create_tag]]

```python
create_tag(repo_id: str, tag: str, tag_message: str | None = None, revision: str | None = None, token: bool | str | None = None, repo_type: str | None = None, exist_ok: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7100)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم وضع علامة على أحد التزامات فيه. مثال: `"user/my-cool-model"`.

tag (`str`) : اسم الوسم الذي سيتم إنشاؤه.

tag_message (`str`، *اختياري*) : وصف الوسم الذي سيتم إنشاؤه.

revision (`str`, *اختياري*) : المراجعة (revision) الخاصة بـ git التي سيتم وضع علامة عليها. يمكن أن يكون اسم فرع أو معرف OID/SHA لالتزام (commit)، كنص سداسي عشري. كما يتم دعم الاختصارات (أول 7 أحرف). القيمة الافتراضية هي رأس فرع `"main"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تضيف وسمًا لمجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تضيف وسمًا لنموذج. القيمة الافتراضية هي `None`.

exist_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا ترفع خطأً إذا كان الوسم موجودًا مسبقًا.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يتم العثور على المراجعة (خطأ 404) في المستودع.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- إذا كان الفرع موجودًا مسبقًا في المستودع (خطأ 409) وكان `exist_ok` مضبوطًا على `False`.

تعيين وسم لالتزام معين في مستودع على Hub.

#### create_webhook[[huggingface_hub.HfApi.create_webhook]]

```python
create_webhook(url: str | None = None, job_id: str | None = None, watched: list[dict | WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T] | None = None, secret: str | None = None, secrets: dict[str, str] | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11180)

**المعاملات:**

url (`str`) : عنوان URL لإرسال الحمولة إليه.

job_id (`str`) : معرّف مهمة المصدر التي سيتم تشغيلها عبر حمولة webhook في متغير البيئة WEBHOOK_PAYLOAD. تتوفر متغيرات بيئة إضافية لتسهيل الاستخدام: WEBHOOK_REPO_ID وWEBHOOK_REPO_TYPE وWEBHOOK_SECRET.

watched (`list[WebhookWatchedItem]`) : قائمة من [WebhookWatchedItem](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookWatchedItem) التي سيقوم الـ webhook بمراقبتها. يمكن أن تكون هذه العناصر مستخدمين أو منظمات أو نماذج أو مجموعات بيانات أو مساحات أو دلاءً. كما يمكن تقديم العناصر المراد مراقبتها كقواميس بسيطة.

domains (`list[Literal["repo", "discussion"]]`، اختياري) : قائمة بالمجالات المراد مراقبتها. يمكن أن تكون "repo" أو "discussion" أو كلاهما. الافتراضي هو كلاهما.

secret (`str`، اختياري) : سرّ لتوقيع الحمولة به.

secrets (`dict[str, str]`، اختياري) : متغيرات البيئة السرية للوظيفة التي يُطلقها خطاف الويب (على سبيل المثال `{"HF_TOKEN": "hf_***"}`). صالحة فقط مع `job_id`. لا تُنسخ أسرار الوظيفة المصدرية إلى خطاف الويب، لذا مرّرها هنا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [WebhookInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookInfo)

معلومات حول خطّ الواب (webhook) الذي تم إنشاؤه حديثًا.

إنشاء webhook جديد.

يمكن أن يرسل webhook حمولة إلى عنوان URL، أو أن يُطلق مهمة (Job) لتنفيذها على بنية Hugging Face التحتية. يجب استدعاء هذه الدالة بإحدى القيمتين `url` أو `job_id`، وليس بكلتاهما معاً.

مثال:

إنشاء خطاف ويب (webhook) يرسل حمولة (payload) إلى عنوان URL

```python
>>> from huggingface_hub import create_webhook
>>> payload = create_webhook(
...     watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}],
...     url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
...     domains=["repo", "discussion"],
...     secret="my-secret",
... )
>>> print(payload)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    job=None,
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=False,
)
```

تشغيل مهمة ثم إنشاء خطاف ويب (webhook) يُطلق هذه المهمة

```python
>>> from huggingface_hub import create_webhook, run_job
>>> job = run_job(
...     image="ubuntu",
...     command=["bash", "-c", r"echo An event occurred in $WEBHOOK_REPO_ID: $WEBHOOK_PAYLOAD"],
... )
>>> payload = create_webhook(
...     watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}],
...     job_id=job.id,
...     domains=["repo", "discussion"],
...     secret="my-secret",
... )
>>> print(payload)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    url=None,
    job=JobSpec(
        docker_image='ubuntu',
        space_id=None,
        command=['bash', '-c', 'echo An event occurred in $WEBHOOK_REPO_ID: $WEBHOOK_PAYLOAD'],
        arguments=[],
        environment={},
        secrets=[],
        flavor='cpu-basic',
        timeout=None,
        tags=None,
        arch=None
    ),
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=False,
)
```

#### dataset_info[[huggingface_hub.HfApi.dataset_info]]

```python
dataset_info(repo_id: str, revision: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: list[ExpandDatasetProperty_T] | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3224)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`، *اختياري*) : إصدار مستودع مجموعة البيانات الذي سيتم منه الحصول على المعلومات.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

files_metadata (`bool`، *اختياري*) : ما إذا كان سيتم استرداد البيانات الوصفية للملفات في المستودع (الحجم، البيانات الوصفية لـ LFS، إلخ). القيمة الافتراضية هي `False`.

expand (`list[ExpandDatasetProperty_T]`, *اختياري*) : خصائص القائمة التي يجب إرجاعها في الاستجابة. عند استخدامه، لن تُرجع سوى الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `files_metadata`. القيم الممكنة هي `"author"`، `"cardData"`، `"citation"`، `"createdAt"`، `"disabled"`، `"description"`، `"downloads"`، `"downloadsAllTime"`، `"gated"`، `"lastModified"`، `"likes"`، `"mainSize"`، `"paperswithcode_id"`، `"private"`، `"siblings"`، `"sha"`، `"tags"`، `"trendingScore"`، `"usedStorage"`، و`"resourceGroup"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [hf_api.DatasetInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DatasetInfo)

معلومات مستودع مجموعة البيانات.

احصل على معلومات حول مجموعة بيانات محددة على huggingface.co.

يمكن أن يكون Dataset خاصاً إذا مررت برمز (token) مقبول.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه. - [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) إذا تعذّر العثور على الإصدار الذي سيتم التنزيل منه.

#### delete_branch[[huggingface_hub.HfApi.delete_branch]]

```python
delete_branch(repo_id: str, branch: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7048)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم حذف فرع منه. مثال: `"user/my-cool-model"`.

branch (`str`) : اسم الفرع المراد حذفه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند إنشاء فرع على مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند وضع علامة على نموذج. القيمة الافتراضية هي `None`.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- عند محاولة حذف فرع محمي. مثال: لا يمكن حذف `main`.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- إذا حاولت حذف فرع غير موجود.

حذف فرع من مستودع على Hub.

#### delete_bucket[[huggingface_hub.HfApi.delete_bucket]]

```python
delete_bucket(bucket_id: str, missing_ok: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14162)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

missing_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا يتم رفع خطأ إذا لم يكن الحوض موجودًا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `BucketNotFoundError`

- `BucketNotFoundError` -- إذا تعذّر العثور على الدلو وكان `missing_ok` مضبوطًا على `False` (الافتراضي).

حذف دلو من Hub.

مثال:
```python
>>> from huggingface_hub import delete_bucket
>>> delete_bucket(bucket_id="Wauplin/first-bucket")
>>> delete_bucket(bucket_id="Wauplin/first-bucket", missing_ok=True)
```

#### delete_collection[[huggingface_hub.HfApi.delete_collection]]

```python
delete_collection(collection_slug: str, missing_ok: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10377)

**المعاملات:**

collection_slug (`str`) : الاسم المختصر (Slug) للمجموعة المراد حذفها. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

missing_ok (`bool`، *اختياري*) : إذا كان `True`، فلا يتم رفع خطأ إذا لم يكن المجموعة موجودة.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

حذف مجموعة على الـ Hub.

مثال:

```py
>>> from huggingface_hub import delete_collection
>>> collection = delete_collection("username/useless-collection-64f9a55bb3115b4f513ec026", missing_ok=True)
```

> [!WARNING]
> هذا إجراء غير قابل للتراجع. لا يمكن استعادة مجموعة محذوفة.

#### delete_collection_item[[huggingface_hub.HfApi.delete_collection_item]]

```python
delete_collection_item(collection_slug: str, item_object_id: str, missing_ok: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10552)

**المعاملات:**

collection_slug (`str`) : المعرّف المختصر (Slug) للمجموعة المراد تحديثها. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

item_object_id (`str`) : المعرّف الخاص بالعنصر في المجموعة. هذا ليس المعرّف الخاص بالعنصر على Hub (repo_id أو paper id). يجب استرداده من كائن [CollectionItem](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.CollectionItem). مثال: `collection.items[0].item_object_id`.

missing_ok (`bool`، *اختياري*) : إذا كان `True`، فلا يتم رفع خطأ إذا لم يكن العنصر موجودًا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

حذف عنصر من مجموعة.

مثال:

```py
>>> from huggingface_hub import get_collection, delete_collection_item

# Get collection first
>>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")

# Delete item based on its ID
>>> delete_collection_item(
...     collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026",
...     item_object_id=collection.items[-1].item_object_id,
... )
```

#### delete_file[[huggingface_hub.HfApi.delete_file]]

```python
delete_file(path_in_repo: str, repo_id: str, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6050)

**المعاملات:**

path_in_repo (`str`) : مسار الملف النسبي في المستودع، على سبيل المثال: `"checkpoints/1fec34a/weights.bin"`

repo_id (`str`) : المستودع الذي سيتم حذف الملف منه، على سبيل المثال: `"username/custom_transformers"`

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كان الملف في مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كان في نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

commit_message (`str`، *اختياري*) : الملخص / العنوان / السطر الأول للالتزام المولّد. القيمة الافتراضية هي `f"Delete {path_in_repo} with huggingface_hub"`.

commit_description (`str`، *اختياري*) : وصف التثبيت المولّد

create_pr (`boolean`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب (Pull Request) مع ذلك الالتزام أم لا. القيمة الافتراضية هي `False`. إذا لم يتم تعيين `revision`، يُفتح طلب السحب ضد الفرع `"main"`. إذا تم تعيين `revision` وكان فرعًا، يُفتح طلب السحب ضد هذا الفرع. إذا تم تعيين `revision` ولم يكن اسم فرع (مثال: معرف التزام)، يُرجع الخادم `RevisionNotFoundError`.

parent_commit (`str`, *اختياري*) : معرف OID / SHA للالتزام الأب، كسلسلة سداسية عشرية. يتم دعم الاختصارات (الأحرف السبعة الأولى) أيضًا. إذا تم تحديده وكان `create_pr` هو `False`، فسيفشل الالتزام إذا لم يشير `revision` إلى `parent_commit`. إذا تم تحديده وكان `create_pr` هو `True`، فسيتم إنشاء طلب السحب من `parent_commit`. يضمن تحديد `parent_commit` عدم تغيير المستودع قبل الالتزام بالتغييرات، وقد يكون مفيدًا بشكل خاص إذا تم تحديث المستودع / الالتزام به بشكل متزامن.

يحذف ملفًا في المستودع المحدد.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون ذلك بسبب عدم وجوده، أو لأنه مُعيَّن على أنه `private` ولا تملك صلاحية الوصول إليه. - [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) إذا تعذّر العثور على الإصدار الذي سيتم التنزيل منه. - [EntryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.EntryNotFoundError) إذا تعذّر العثور على الملف الذي سيتم تنزيله.

#### delete_files[[huggingface_hub.HfApi.delete_files]]

```python
delete_files(repo_id: str, delete_patterns: list[str], token: bool | str | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6140)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم حذف المجلد منه، على سبيل المثال: `"username/custom_transformers"`

delete_patterns (`list[str]`) : قائمة من الملفات أو المجلدات التي سيتم حذفها. يمكن أن يكون كل نص مسار ملف، أو مسار مجلد، أو نمط كروي. الأنماط هي كرويات قياسية (أنماط globbing) كما هو موثق [هنا](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). يعتمد مطابقة الأنماط على [`fnmatch`](https://docs.python.org/3/library/fnmatch.html). لاحظ أن `fnmatch` يطابق `*` عبر حدود المسار، على عكس كرويات Unix shell التقليدية. على سبيل المثال `["file.txt", "folder/", "data/*.parquet"]`

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`. إلى المحفوظ.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم حذف الملفات منه. يمكن أن يكون `"model"` أو `"dataset"` أو `"space"`. القيمة الافتراضية هي `"model"`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

commit_message (`str`، *اختياري*) : ملخص (السطر الأول) للالتزام المولّد. الافتراضي هو `f"Delete files using huggingface_hub"`.

commit_description (`str`، *اختياري*) : وصف التثبيت المُولَّد.

create_pr (`boolean`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب (Pull Request) مع ذلك الالتزام أم لا. القيمة الافتراضية هي `False`. إذا لم يتم تعيين `revision`، يُفتح طلب السحب ضد الفرع `"main"`. إذا تم تعيين `revision` وكان فرعًا، يُفتح طلب السحب ضد هذا الفرع. إذا تم تعيين `revision` ولم يكن اسم فرع (مثال: معرف التزام)، يُرجع الخادم `RevisionNotFoundError`.

parent_commit (`str`, *اختياري*) : معرف OID / SHA للالتزام الأب، كسلسلة سداسية عشرية. يتم دعم الاختصارات (الأحرف السبعة الأولى) أيضًا. إذا تم تحديده وكان `create_pr` هو `False`، فسيفشل الالتزام إذا لم يشير `revision` إلى `parent_commit`. إذا تم تحديده وكان `create_pr` هو `True`، فسيتم إنشاء طلب السحب من `parent_commit`. يضمن تحديد `parent_commit` عدم تغيير المستودع قبل الالتزام بالتغييرات، وقد يكون مفيدًا بشكل خاص إذا تم تحديث المستودع / الالتزام به بشكل متزامن.

حذف الملفات من مستودع على Hub.

إذا تم توفير مسار مجلد، يتم حذف المجلد بأكمله بالإضافة إلى جميع الملفات التي يحتويها.

#### delete_folder[[huggingface_hub.HfApi.delete_folder]]

```python
delete_folder(path_in_repo: str, repo_id: str, token: bool | str | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6219)

**المعاملات:**

path_in_repo (`str`) : مسار المجلد النسبي في المستودع، على سبيل المثال: `"checkpoints/1fec34a"`.

repo_id (`str`) : المستودع الذي سيتم حذف المجلد منه، على سبيل المثال: `"username/custom_transformers"`

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`. إلى المحفوظ.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كان المجلد في مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كان في نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

commit_message (`str`، *اختياري*) : الملخص / العنوان / السطر الأول للالتزام المولّد. القيمة الافتراضية هي `f"Delete folder {path_in_repo} with huggingface_hub"`.

commit_description (`str`، *اختياري*) : وصف التثبيت المُولَّد.

create_pr (`boolean`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب (Pull Request) مع ذلك الالتزام أم لا. القيمة الافتراضية هي `False`. إذا لم يتم تعيين `revision`، يُفتح طلب السحب ضد الفرع `"main"`. إذا تم تعيين `revision` وكان فرعًا، يُفتح طلب السحب ضد هذا الفرع. إذا تم تعيين `revision` ولم يكن اسم فرع (مثال: معرف التزام)، يُرجع الخادم `RevisionNotFoundError`.

parent_commit (`str`, *اختياري*) : معرف OID / SHA للالتزام الأب، كسلسلة سداسية عشرية. يتم دعم الاختصارات (الأحرف السبعة الأولى) أيضًا. إذا تم تحديده وكان `create_pr` هو `False`، فسيفشل الالتزام إذا لم يشير `revision` إلى `parent_commit`. إذا تم تحديده وكان `create_pr` هو `True`، فسيتم إنشاء طلب السحب من `parent_commit`. يضمن تحديد `parent_commit` عدم تغيير المستودع قبل الالتزام بالتغييرات، وقد يكون مفيدًا بشكل خاص إذا تم تحديث المستودع / الالتزام به بشكل متزامن.

يحذف مجلدًا في المستودع المحدد.

غلاف بسيط حول طريقة [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit).

#### delete_inference_endpoint[[huggingface_hub.HfApi.delete_inference_endpoint]]

```python
delete_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9898)

**المعاملات:**

name (`str`) : اسم نقطة الاستدلال (Inference Endpoint) المراد حذفها.

namespace (`str`، *اختياري*) : مساحة الاسم التي يقع فيها Inference Endpoint. الافتراضي هو المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

حذف نقطة استنتاج.

هذه العملية غير قابلة للعكس. إذا كنت لا ترغب في دفع رسوم لنقطة استنتاج (Inference Endpoint)، فمن الأفضل إيقافها مؤقتًا باستخدام [pause_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint) أو تقليل حجمها إلى الصفر باستخدام [scale_to_zero_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.scale_to_zero_inference_endpoint).

للسهولة، يمكنك أيضاً حذف نقطة استنتاج باستخدام [InferenceEndpoint.delete()](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.delete).

#### delete_repo[[huggingface_hub.HfApi.delete_repo]]

```python
delete_repo(repo_id: str, token: str | bool | None = None, repo_type: str | None = None, missing_ok: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4793)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج.

missing_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا يتم رفع خطأ إذا لم يكن المستودع موجودًا.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا تعذّر العثور على المستودع الذي يجب الحذف منه وتم ضبط `missing_ok` على False (الافتراضي).

احذف مستودعًا من HuggingFace Hub. تحذير: هذا الإجراء لا يمكن التراجع عنه.

#### delete_scheduled_job[[huggingface_hub.HfApi.delete_scheduled_job]]

```python
delete_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13329)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

حذف مهمة حساب مجدولة على بنية Hugging Face التحتية.

#### delete_space_secret[[huggingface_hub.HfApi.delete_space_secret]]

```python
delete_space_secret(repo_id: str, key: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8088)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

key (`str`) : المفتاح السري. مثال: `"GITHUB_API_KEY"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يحذف سراً من مساحة.

تتيح لك المفاتيح السرية تعيين مفاتيح أو رموز سرية لمساحة دون الحاجة إلى تضمينها في الكود. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

#### delete_space_variable[[huggingface_hub.HfApi.delete_space_variable]]

```python
delete_space_variable(repo_id: str, key: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8215)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

key (`str`) : مفتاح متغير. مثال: `"MODEL_REPO_ID"`

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يحذف متغيّرًا من مساحة.

تتيح المتغيرات تعيين متغيرات البيئة لمساحة دون الحاجة إلى ترميزها بشكل ثابت. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables

#### delete_space_volumes[[huggingface_hub.HfApi.delete_space_volumes]]

```python
delete_space_volumes(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9113)

**المعاملات:**

repo_id (`str`) : معرّف مساحة (Space) التي سيتم تحديثها. مثال: `"username/my-space"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `BadRequestError`

- `BadRequestError` -- إذا لم يكن لدى المساحة أي أحجام مرفقة.

إزالة جميع الأحجام من مساحة.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.delete_space_volumes("username/my-space")
```

#### delete_tag[[huggingface_hub.HfApi.delete_tag]]

```python
delete_tag(repo_id: str, tag: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7174)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم حذف وسم منه. مثال: `"user/my-cool-model"`.

tag (`str`) : اسم الوسم المراد حذفه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تضيف وسمًا لمجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تضيف وسمًا لنموذج. القيمة الافتراضية هي `None`.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يتم العثور على الوسم.

حذف وسم من مستودع على Hub.

#### delete_webhook[[huggingface_hub.HfApi.delete_webhook]]

```python
delete_webhook(webhook_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11534)

**المعاملات:**

webhook_id (`str`) : المعرّف الفريد لخطاف الويب (webhook) المراد حذفه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `None`

حذف خطاف ويب.

مثال:
```python
>>> from huggingface_hub import delete_webhook
>>> delete_webhook("654bbbc16f2ec14d77f109cc")
```

#### disable_space_dev_mode[[huggingface_hub.HfApi.disable_space_dev_mode]]

```python
disable_space_dev_mode(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8502)

**المعاملات:**

repo_id (`str`) : معرّف مساحة (Space) لتعطيل وضع التطوير. مثال: `"Salesforce/BLIP2"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل الخاصة بمساحتك.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) أو [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على مساحتك (خطأ 404). على الأرجح أن معرف المستودع repo_id خاطئ، أو أن مساحتك خاصة وأنت غير مصادق.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: لا يمكن سوى مالك مساحة (Space) تحديد وضع التطوير. إذا كنت ترغب في التعامل مع مساحة لا تملكها، فاطلب من المالك ذلك من خلال فتح نقاش (Discussion) أو انسخ المساحة.
- [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- إذا كان مساحتك مساحة ثابتة. المساحات الثابتة تعمل دائمًا ولا تُفرض عليها أي رسوم. إذا كنت ترغب في إخفاء مساحة ثابتة، يمكنك تعيينها كخاصة.

تعطيل وضع التطوير على مساحة.

يسهّل وضع التطوير في Spaces عملية تصحيح أخطاء تطبيقك ويجعل تكرار العمل على Spaces أسرع من خلال السماح لك بإعادة تشغيل تطبيقك دون إيقاف حاوية Space نفسها. يتطلب تفعيل وضع التطوير اشتراكًا بخطة PRO أو Team & Enterprise، لكن تعطيله مسموح دائمًا (مثلًا بعد انتهاء صلاحية الاشتراك). راجع https://huggingface.co/docs/hub/spaces-dev-mode لمزيد من التفاصيل.

#### disable_webhook[[huggingface_hub.HfApi.disable_webhook]]

```python
disable_webhook(webhook_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11481)

**المعاملات:**

webhook_id (`str`) : المعرّف الفريد لخطاف الويب (webhook) الذي سيتم تعطيله.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [WebhookInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookInfo)

معلومات حول خطاف الويب المعطّل.

تعطيل خطاف ويب (يجعله "معطلاً").

مثال:
```python
>>> from huggingface_hub import disable_webhook
>>> disabled_webhook = disable_webhook("654bbbc16f2ec14d77f109cc")
>>> disabled_webhook
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    jon=None,
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=True,
)
```

#### download_bucket_files[[huggingface_hub.HfApi.download_bucket_files]]

```python
download_bucket_files(bucket_id: str, files: list[tuple[str | BucketFile, str | Path]], raise_on_missing_files: bool = False, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L15074)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

files (`list[tuple[Union[str, BucketFile], Union[str, Path]]]`) : الملفات التي سيتم تنزيلها كقائمة من السجلات (المصدر، الوجهة). راجع الوصف أعلاه لمعرفة تفاصيل التنسيق.

raise_on_missing_files (`bool`, *اختياري*) : إذا كان `True`، فسيتم رفع `EntryNotFoundError` عندما لا يوجد الملف المطلوب في الدلو. إذا كان `False` (الافتراضي)، يتم تجاوز الملفات المفقودة مع تحذير.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

تنزيل الملفات من الدلو.

مدخل Files هو قائمة من أزواج `(remote file, local file)` حيث يكون `remote file` إما مسار الملف داخل الدلو أو كائن [BucketFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketFile)، ويكون `local file` هو مسار الوجهة على نظام الملفات المحلي. عند تمرير كائن [BucketFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketFile) (المحصل من [list_bucket_tree()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_bucket_tree))، سيتخطى هذا الإجراء خطوة جلب البيانات الوصفية وينزل الملفات مباشرة.

مثال:
```python
>>> from huggingface_hub import download_bucket_files

>>> download_bucket_files(
...     bucket_id="username/my-bucket",
...     files=[
...         ("models/model.safetensors", "./local/model.safetensors"),
...         ("config.json", "./local/config.json"),
...     ],
... )
```

```python
>>> from huggingface_hub import download_bucket_files

>>> parquet_files = [file for file in list_bucket_tree(bucket_id="username/my-bucket") if file.path.endswith(".parquet")]
>>> download_bucket_files(
...     bucket_id="username/my-bucket",
...     files=[(file, f"./local/{file.path}") for file in parquet_files],
... )
```

#### duplicate_repo[[huggingface_hub.HfApi.duplicate_repo]]

```python
duplicate_repo(from_id: str, to_id: str | None = None, repo_type: str | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, token: bool | str | None = None, exist_ok: bool = False, resource_group_id: str | None = None, space_hardware: SpaceHardware | None = None, space_sleep_time: int | None = None, space_secrets: list[dict[str, str]] | None = None, space_variables: list[dict[str, str]] | None = None, space_volumes: list[Volume] | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8868)

**المعاملات:**

from_id (`str`) : معرّف المستودع الذي سيتم نسخه. مثال: `"openai/gdpval"`.

to_id (`str`, *اختياري*) : معرف المستودع الجديد. مثال: `"myorg/my-gdpval"`. إذا لم يُقدَّم، فسيحمل المستودع الجديد نفس اسم المستودع الأصلي، لكن في حسابك.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تنسخ مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تنسخ نموذجًا. القيمة الافتراضية هي `None`.

private (`bool`، *اختياري*) : ما إذا كان يجب أن يكون المستودع الجديد خاصًا أم لا. الافتراضي هو نفس مستوى الخصوصية للمستودع الأصلي. لا يمكن تمريره مع `visibility`.

visibility (`Literal["public", "private", "protected"]`, *اختياري*) : مدى ظهور المستودع الجديد. يمكن أن يكون `"public"` أو `"private"`، أو `"protected"` لـ Spaces. القيمة الافتراضية هي نفس مدى ظهور المستودع الأصلي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

exist_ok (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فلا يتم رفع خطأ إذا كان المستودع موجودًا مسبقًا.

resource_group_id (`str`, *اختياري*) : مجموعة الموارد التي سيتم إنشاء المستودع الجديد فيها. مجموعات الموارد متاحة فقط لمنظمات Enterprise Hub، وتتيح تحديد أعضاء المنظمة الذين يمكنهم الوصول إلى المورد. يمكن العثور على معرّف مجموعة الموارد في عنوان URL لصفحة المورد على Hub (مثل `"66670e5163145ca562cb1988"`). لمعرفة المزيد حول مجموعات الموارد، راجع https://huggingface.co/docs/hub/en/security-resource-groups.

space_hardware (`SpaceHardware` أو `str`، *اختياري*) : اختيار العتاد إذا كان repo_type هو "space". مثال: `"t4-medium"`. راجع [SpaceHardware](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceHardware) للحصول على قائمة كاملة.

space_sleep_time (`int`, *اختياري*) : عدد ثوانٍ من عدم النشاط التي يجب انتظارها قبل وضع مساحة في وضع السكون. اضبطها على `-1` إذا لم ترغب في أن تدخل مساحتك في وضع السكون (السلوك الافتراضي للأجهزة المُحدَّثة). بالنسبة للأجهزة المجانية، لا يمكنك ضبط وقت السكون (القيمة ثابتة عند 48 ساعة من عدم النشاط). ينطبق فقط إذا كان repo_type هو "space". راجع https://huggingface.co/docs/hub/spaces-gpus#sleep-time لمزيد من التفاصيل.

space_secrets (`list[dict[str, str]]`، *اختياري*) : قائمة بمفاتيح سرية يجب ضبطها في مساحتك. كل عنصر يكون على شكل `{"key": ..., "value": ..., "description": ...}` حيث يكون الوصف اختياريًا. ينطبق هذا فقط إذا كان repo_type هو "space". لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

space_variables (`list[dict[str, str]]`، *اختياري*) : قائمة بمتغيرات البيئة العامة التي يجب ضبطها في مساحتك. كل عنصر يكون على شكل `{"key": ..., "value": ..., "description": ...}` حيث يكون الوصف اختياريًا. ينطبق هذا فقط إذا كان repo_type هو "space". لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.

space_volumes (`list[Volume]`، *اختياري*) : قائمة من كائنات [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) لتثبيتها في المساحة (Space) عند وقت التكرار. يحتوي كل حجم على `type` (`"bucket"`، `"model"`، `"dataset"`، أو `"space"`)، و`source` (معرّف المستودع أو الدلو)، و`mount_path` (المسار داخل الحاوية)، وحقول اختيارية `revision`، `read_only`، و`path`. ينطبق فقط إذا كان repo_type هو "space".

**يعيد:** [DuplicatedRepoUrl](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DuplicatedRepoUrl)

رابط إلى المستودع الذي تم إنشاؤه حديثاً. القيمة هي فئة فرعية من [RepoUrl](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.RepoUrl) (ومن `str`) تحتوي على سمات مثل `endpoint`، `repo_type`، `repo_id` و`files_copy_pending`.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو `HfHubHTTPError`

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا تعذّر العثور على أحد `from_id` أو `to_id`. قد يكون السبب عدم وجوده، أو كونه مضبوطًا على `private` ولا تملك صلاحية الوصول إليه.
- `HfHubHTTPError` -- إذا أعادت واجهة HuggingFace البرمجية خطأ

نسخ مستودع على الهاب (نموذج، مجموعة بيانات، أو مساحة).

يؤدي هذا إلى نسخ على جانب الخادم يحافظ على سجل git الكامل وكائنات LFS دون الحاجة إلى دورة تنزيل/رفع محلية.

يتم نسخ سجل git على الفور، لكن ملفات LFS/Xet قد لا تزال تُنسخ في الخلفية بعد عودة هذه الطريقة. في هذه الحالة، تكون قيمة `files_copy_pending` في القيمة المُعادة `True`، وقد يفشل تنزيل هذه الملفات من المستودع الجديد حتى يكتمل النسخ.

مثال:
```python
>>> from huggingface_hub import duplicate_repo

# Duplicate a model to your account
>>> repo_url = duplicate_repo("google/gemma-7b")
>>> repo_url
RepoUrl('https://huggingface.co/nateraw/gemma-7b',...)
>>> repo_url.files_copy_pending
True

# Duplicate a dataset with a custom name
>>> duplicate_repo("openai/gdpval", to_id="myorg/my-gdpval", repo_type="dataset")
RepoUrl('https://huggingface.co/datasets/myorg/my-gdpval',...)

# Duplicate a Space with custom hardware
>>> duplicate_repo("multimodalart/dreambooth-training", repo_type="space", space_hardware="t4-medium")
RepoUrl('https://huggingface.co/spaces/nateraw/dreambooth-training',...)
```

#### edit_discussion_comment[[huggingface_hub.HfApi.edit_discussion_comment]]

```python
edit_discussion_comment(repo_id: str, discussion_num: int, comment_id: str, new_content: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7888)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

comment_id (`str`) : المعرّف الخاص بالتعليق الذي تريد تحريره.

new_content (`str`) : المحتوى الجديد للتعليق. تدعم التعليقات تنسيق Markdown.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [DiscussionComment](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionComment)

التعليق المُعدَّل

يُحرّر تعليقًا على نقاش / طلب سحب.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### enable_space_dev_mode[[huggingface_hub.HfApi.enable_space_dev_mode]]

```python
enable_space_dev_mode(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8463)

**المعاملات:**

repo_id (`str`) : معرّف مساحة (Space) لتفعيل وضع التطوير. مثال: `"Salesforce/BLIP2"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل الخاصة بمساحتك.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) أو [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على مساحتك (خطأ 404). على الأرجح أن معرف المستودع repo_id خاطئ، أو أن مساحتك خاصة وأنت غير مصادق.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: لا يمكن سوى مالك مساحة (Space) تحديد وضع التطوير. إذا كنت ترغب في التعامل مع مساحة لا تملكها، فاطلب من المالك ذلك من خلال فتح نقاش (Discussion) أو انسخ المساحة.
- [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- إذا كان مساحتك مساحة ثابتة. المساحات الثابتة تعمل دائمًا ولا تُفرض عليها أي رسوم. إذا كنت ترغب في إخفاء مساحة ثابتة، يمكنك تعيينها كخاصة.

تفعيل وضع التطوير على مساحة.

يسهّل وضع التطوير في Spaces عملية تصحيح أخطاء تطبيقك ويجعل تكرار العمل على Spaces أسرع من خلال السماح لك بإعادة تشغيل تطبيقك دون إيقاف حاوية Space نفسها. يتوفر هذا المكوّن كجزء من خطة PRO أو خطة Team & Enterprise. راجع https://huggingface.co/docs/hub/spaces-dev-mode لمزيد من التفاصيل.

#### enable_webhook[[huggingface_hub.HfApi.enable_webhook]]

```python
enable_webhook(webhook_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11428)

**المعاملات:**

webhook_id (`str`) : المعرّف الفريد لخطاف الويب (webhook) الذي سيتم تفعيله.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [WebhookInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookInfo)

معلومات حول خطاف الويب المُفعّل.

تفعيل خطاف ويب (يجعله "نشطًا").

مثال:
```python
>>> from huggingface_hub import enable_webhook
>>> enabled_webhook = enable_webhook("654bbbc16f2ec14d77f109cc")
>>> enabled_webhook
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    job=None,
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo", "discussion"],
    secret="my-secret",
    disabled=False,
)
```

#### fetch_job_logs[[huggingface_hub.HfApi.fetch_job_logs]]

```python
fetch_job_logs(job_id: str, namespace: str | None = None, follow: bool = False, tail: int | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12332)

**المعاملات:**

job_id (`str`) : معرف المهمة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يعمل فيها Job. الافتراضي هو مساحة اسم المستخدم الحالي.

follow (`bool`، *اختياري*) : إذا كان `True`، يتم بث السجلات في الوقت الفعلي حتى اكتمال المهمة (مع الحجب). إذا كان `False` (الافتراضي)، يتم جلب السجلات المتاحة حاليًا فقط والعودة فورًا (بدون حجب).

tail (`int`, *اختياري*) : الحد الأقصى لعدد الأسطر التي تُعاد من السجلات. عند دمجه مع `follow=True`، يبدأ من آخر N أسطر ويستمر في بث السجلات الجديدة. عند `follow=False`، يعيد فقط آخر N أسطر من السجلات المتاحة حاليًا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

جلب جميع السجلات من مهمة حوسبة على بنية Hugging Face التحتية.

مثال:

```python
>>> from huggingface_hub import fetch_job_logs, run_job
>>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"])
>>> for log in fetch_job_logs(job_id=job.id):
...     print(log)
Hello from HF compute!

>>> # Non-blocking: fetch only currently available logs
>>> for log in fetch_job_logs(job_id=job.id, follow=False):
...     print(log)

>>> # Stream logs starting from the last 100 lines
>>> for log in fetch_job_logs(job_id=job.id, follow=True, tail=100):
...     print(log)
```

#### fetch_job_metrics[[huggingface_hub.HfApi.fetch_job_metrics]]

```python
fetch_job_metrics(job_id: str, namespace: str | None = None, follow: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12412)

**المعاملات:**

job_id (`str`) : معرف المهمة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يعمل فيها Job. الافتراضي هو مساحة اسم المستخدم الحالي.

follow (`bool`، *اختياري*) : إذا كان `True`، يتم بث المقاييس في الوقت الفعلي حتى اكتمال المهمة (مع الحجب). إذا كان `False` (الافتراضي)، يتم جلب المقاييس الحالية فقط والعودة (بدون حجب).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

جلب المقاييس الحية من مهمة حساب على بنية Hugging Face التحتية.

مثال:

```python
>>> from huggingface_hub import fetch_job_metrics, run_job
>>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], flavor="a10g-small")
>>> for metrics in fetch_job_metrics(job_id=job.id):
...     print(metrics)
{
    "cpu_usage_pct": 0,
    "cpu_millicores": 3500,
    "memory_used_bytes": 1306624,
    "memory_total_bytes": 15032385536,
    "rx_bps": 0,
    "tx_bps": 0,
    "gpus": {
        "882fa930": {
            "utilization": 0,
            "memory_used_bytes": 0,
            "memory_total_bytes": 22836000000
        }
    },
    "replica": "57vr7"
}

>>> # Stream metrics until the job completes
>>> for metrics in fetch_job_metrics(job_id=job.id, follow=True):
...     print(metrics)
```

#### fetch_space_logs[[huggingface_hub.HfApi.fetch_space_logs]]

```python
fetch_space_logs(repo_id: str, build: bool = False, follow: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8742)

**المعاملات:**

repo_id (`str`) : معرّف المساحة. مثال: `"bigcode/in-the-stack"`.

build (`bool`، *اختياري*، الافتراضي `False`) : إذا كان `True`، يتم جلب سجلات بناء الحاوية (مفيد عندما يكون المساحة عالقة في `BUILD_ERROR`). إذا كان `False` (الافتراضي)، يتم جلب سجلات التشغيل، أي stdout/stderr للتطبيق قيد التشغيل.

follow (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، يتم بث السجلات في الوقت الفعلي (مع الحجب) حتى يغلق الخادم البث أو يتم رفع `KeyboardInterrupt`. إذا كانت `False` (الافتراضي)، يتم جلب السجلات المخزنة مؤقتًا حاليًا فقط والعودة فورًا (بدون حجب، مثل `docker logs`).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. الافتراضي هو رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** `Iterable[str]`

مولّد يُنتج أسطر السجلات (log lines) كلما أصبحت متاحة.

جلب سجلات التشغيل أو البناء لمساحة على Hub.

يُفيد في تصحيح أخطاء مساحة (Space) تفشل في البناء أو تنهار أثناء التشغيل، لا سيما عند العمل من سكربت أو سير عمل وكيلي (agentic workflow) حيث لا يكون قراءة السجلات في المتصفح خيارًا متاحًا.

مثال:

```python
>>> from huggingface_hub import fetch_space_logs
>>> # Non-blocking: print currently available run logs and exit.
>>> for line in fetch_space_logs("username/my-space"):
...     print(line, end="")

>>> # Debug a build failure:
>>> for line in fetch_space_logs("username/my-space", build=True):
...     print(line, end="")

>>> # Stream run logs until the server closes the stream.
>>> for line in fetch_space_logs("username/my-space", follow=True):
...     print(line, end="")
```

#### file_exists[[huggingface_hub.HfApi.file_exists]]

```python
file_exists(repo_id: str, filename: str, repo_type: str | None = None, revision: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3773)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

filename (`str`) : اسم الملف الذي يجب التحقق منه، على سبيل المثال: `"config.json"`

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تستخرج معلومات المستودع من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تستخرج معلومات المستودع من نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة (revision) للمستودع الذي سيتم منه جلب المعلومات. القيمة الافتراضية هي الفرع `"main"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:**

صحيح إذا كان الملف موجودًا، وإلا فخطأ.

يتحقق من وجود ملف في مستودع على Hugging Face Hub.

أمثلة:
```py
>>> from huggingface_hub import file_exists
>>> file_exists("bigcode/starcoder", "config.json")
True
>>> file_exists("bigcode/starcoder", "not-a-file")
False
>>> file_exists("bigcode/not-a-repo", "config.json")
False
```

#### get_bucket_file_metadata[[huggingface_hub.HfApi.get_bucket_file_metadata]]

```python
get_bucket_file_metadata(bucket_id: str, remote_path: str, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L15015)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

remote_path (`str`) : مسار الملف في الدلو.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [BucketFileMetadata](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketFileMetadata)

ملف البيانات الوصفية الذي يحتوي على حجم المعلومات وxet.

جلب بيانات الوصف الخاصة بملف في دلو.

مثال:
```python
>>> from huggingface_hub import get_bucket_file_metadata
>>> metadata = get_bucket_file_metadata(
...     bucket_id="username/my-bucket",
...     remote_path="models/model.safetensors",
... )
>>> metadata.size
42000
```

#### get_bucket_paths_info[[huggingface_hub.HfApi.get_bucket_paths_info]]

```python
get_bucket_paths_info(bucket_id: str, paths: Iterable[str], token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14361)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

paths (`Iterable[str]`) : المسارات التي سيتم الحصول على معلومات عنها. إذا لم يكن المسار موجودًا، يتم تجاهله دون رفع استثناء. يتم دعم مسارات الملفات فقط.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[BucketFile]`

معلومات حول المسارات، كقابلة للتكرار من كائنات [BucketFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketFile).

احصل على معلومات حول مسارات الدلو.

تتم الاستدعاءات على دفعات من 1000 مسار. وتُقدَّم النتائج فور استلامها.

مثال:
```py
>>> from huggingface_hub import get_bucket_paths_info
>>> paths_info = get_bucket_paths_info("username/my-bucket", ["file.txt", "checkpoints/model.safetensors"])
>>> for info in paths_info:
...     print(info)
BucketFile(type='file', path='file.txt', size=2379, xet_hash='96e637d9665bd35477b1908a23f2e254edfba0618dbd2d62f90a6baee7d139cf', mtime=datetime.datetime(2024, 9, 25, 15, 31, 2, 346000, tzinfo=datetime.timezone.utc))
BucketFile(type='file', path='checkpoints/model.safetensors', size=2408828, xet_hash='3ed0e9fefe788ddd61d1e26eba67057e9740a064b009256fbafadf6bb95785ca', mtime=datetime.datetime(2024, 9, 25, 15, 31, 2, 346000, tzinfo=datetime.timezone.utc))
```

#### get_collection[[huggingface_hub.HfApi.get_collection]]

```python
get_collection(collection_slug: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10156)

**المعاملات:**

collection_slug (`str`) : اسم مجموعة (Slug) على Hub. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يحصل على معلومات حول مجموعة على Hub.

يعيد: [Collection](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.Collection)

مثال:

```py
>>> from huggingface_hub import get_collection
>>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")
>>> collection.title
'Recent models'
>>> len(collection.items)
37
>>> collection.items[0]
CollectionItem(
    item_object_id='651446103cd773a050bf64c2',
    item_id='TheBloke/U-Amethyst-20B-AWQ',
    item_type='model',
    position=88,
    note=None
)
```

#### get_dataset_leaderboard[[huggingface_hub.HfApi.get_dataset_leaderboard]]

```python
get_dataset_leaderboard(repo_id: str, base_model_only: bool | None = None, token: bool | str | None = None, timeout: float | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3294)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`. على سبيل المثال: `"allenai/olmOCR-bench"`.

base_model_only (`bool` أو `None`، *اختياري*) : بشكل افتراضي، تتضمن لوحة الصدارة فقط النماذج التي لا تملك علاقة `base_model` معلنة (أي المستودعات الأصلية/الجذرية)، بما يتوافق مع عرض لوحة الصدارة الافتراضي في Hub. تُستبعد المستودعات المُحسَّنة أو المشتقة التي تعلن عن نموذج أب. مرّر `base_model_only=False` لتعطيل هذا المرشّح وإدراج كل نتيجة مُرسَلة، بغضّ النظر عما إذا كان النموذج يعلن عن علاقة نموذج أساسي أم لا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. الافتراضي هو رمز المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

**يعيد:** `list[DatasetLeaderboardEntry]`

قائمة من كائنات [DatasetLeaderboardEntry](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DatasetLeaderboardEntry) تمثل إدخالات لوحة الصدارة، مرتبة حسب الترتيب.

احصل على لوحة الصدارة لمجموعة بيانات على Hub.

ترتّب لوحة الصدارة النماذج بناءً على درجات تقييمها على مجموعة البيانات المرجعية المحددة. لا تتوفر لوحات صدارة لجميع مجموعات البيانات — بل فقط لتلك المجموعات المرجعية التي تم إرسال نتائج تقييم إليها. وهذا يمنح منظوراً يركّز على مجموعة البيانات لعرض الدرجات؛ أما للحصول على منظور يركّز على النموذج، فاستخدم [model_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.model_info) مع `expand=["evalResults"]`.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع. قد يكون ذلك بسبب عدم وجوده، أو لأنه مُعيّن على أنه `private` ولا تملك صلاحية الوصول إليه. - [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) إذا لم يكن للمجموعة بيانات لوحة صدارة.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> leaderboard = api.get_dataset_leaderboard("allenai/olmOCR-bench")
>>> leaderboard[0].model_id
'datalab-to/chandra-ocr-2'
>>> leaderboard[0].rank
1

# Include fine-tuned / derivative models too
>>> full_leaderboard = api.get_dataset_leaderboard("allenai/olmOCR-bench", base_model_only=False)
```

#### get_dataset_tags[[huggingface_hub.HfApi.get_dataset_tags]]

```python
get_dataset_tags()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2306)

قائمة جميع وسوم البيانات الصالحة ككائن مساحة أسماء متداخلة.

#### get_discussion_details[[huggingface_hub.HfApi.get_discussion_details]]

```python
get_discussion_details(repo_id: str, discussion_num: int, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7369)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يجلب تفاصيل المناقشة / طلب الدمج من Hub.

يعيد: [DiscussionWithDetails](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionWithDetails)

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### get_full_repo_name[[huggingface_hub.HfApi.get_full_repo_name]]

```python
get_full_repo_name(model_id: str, organization: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7223)

**المعاملات:**

model_id (`str`) : اسم النموذج.

organization (`str`، *اختياري*) : إذا تم تمريره، فسيكون اسم المستودع ضمن مساحة اسم المنظمة بدلاً من مساحة اسم المستخدم.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `str`

اسم المستودع في مساحة اسم المستخدم ({username}/{model_id}) إذا لم يتم تمرير أي منظمة، وفي مساحة اسم المنظمة ({organization}/{model_id}) في حال العكس.

يعيد اسم المستودع لمعرّف نموذج معيّن ومنظمة اختيارية.

#### get_hf_file_metadata[[huggingface_hub.HfApi.get_hf_file_metadata]]

```python
get_hf_file_metadata(url: str, token: bool | str | None = None, timeout: float | None = 10)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6290)

**المعاملات:**

url (`str`) : عنوان الملف، مثل ما يُعاد بواسطة [hf_hub_url()](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.hf_hub_url).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

timeout (`float`، *اختياري*، القيمة الافتراضية 10) : عدد الثواني التي يجب انتظارها حتى يرسل الخادم البيانات الوصفية قبل التوقف عن المحاولة.

**يعيد:**

كائن [HfFileMetadata](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.HfFileMetadata) يحتوي على بيانات وصفية مثل الموقع وetag والحجم وcommit_hash.

جلب بيانات الوصف (metadata) لملف مُنظَّم بالإصدارات على Hub لعنوان URL معيّن.

#### get_inference_endpoint[[huggingface_hub.HfApi.get_inference_endpoint]]

```python
get_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9663)

**المعاملات:**

name (`str`) : اسم نقطة الاستدلال (Inference Endpoint) التي سيتم استرداد المعلومات عنها.

namespace (`str`، *اختياري*) : مساحة الاسم التي يقع فيها Inference Endpoint. الافتراضي هو المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة الاستدلال المطلوبة.

احصل على معلومات حول نقطة استنتاج.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> endpoint = api.get_inference_endpoint("my-text-to-image")
>>> endpoint
InferenceEndpoint(name='my-text-to-image', ...)

# Get status
>>> endpoint.status
'running'
>>> endpoint.url
'https://my-text-to-image.region.vendor.endpoints.huggingface.cloud'

# Run inference
>>> endpoint.client.text_to_image(...)
```

#### get_model_tags[[huggingface_hub.HfApi.get_model_tags]]

```python
get_model_tags()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2297)

قائمة جميع علامات النموذج الصالحة ككائن مساحة أسماء متداخلة

#### get_organization_overview[[huggingface_hub.HfApi.get_organization_overview]]

```python
get_organization_overview(organization: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11752)

**المعاملات:**

organization (`str`) : اسم المنظمة التي تريد الحصول على نظرة عامة عنها.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Organization`

كائن `Organization` يحتوي على نظرة عامة على المنظمة.

**يرفع:** ``HTTPError``

- [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) -- خطأ HTTP 404 إذا لم تكن المنظمة موجودة على Hub.

احصل على نظرة عامة على منظمة في Hub.

#### get_paths_info[[huggingface_hub.HfApi.get_paths_info]]

```python
get_paths_info(repo_id: str, paths: list[str] | str, expand: bool = False, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4274)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

paths (`Union[list[str], str]`، *اختياري*) : المسارات التي سيتم الحصول على معلومات عنها. إذا لم يكن المسار موجودًا، يتم تجاهله دون رفع استثناء.

expand (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان يجب جلب مزيد من المعلومات حول المسارات (مثل آخر التزامن ونتائج فحص أمان الملفات). هذه العملية أكثر تكلفة على الخادم، لذا تُعاد 50 نتيجة فقط لكل صفحة (بدلاً من 1000). بما أن ترقيم الصفحات مُنفَّذ في `huggingface_hub`، فإن الأمر شفاف بالنسبة لك باستثناء الوقت الذي يستغرقه الحصول على النتائج.

revision (`str`، *اختياري*) : المراجعة (revision) للمستودع الذي سيتم منه جلب المعلومات. القيمة الافتراضية هي الفرع `"main"`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم منه جلب المعلومات (`"model"` أو `"dataset"` أو `"space"`. القيمة الافتراضية هي `"model"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `list[Union[RepoFile, RepoFolder]]`

معلومات حول المسارات، كقائمة من كائنات [RepoFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.RepoFile) و`RepoFolder`.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يتم العثور على المراجعة (خطأ 404) في المستودع.

احصل على معلومات حول مسارات المستودع.

مثال:
```py
>>> from huggingface_hub import get_paths_info
>>> paths_info = get_paths_info("allenai/c4", ["README.md", "en"], repo_type="dataset")
>>> paths_info
[
    RepoFile(path='README.md', size=2379, blob_id='f84cb4c97182890fc1dbdeaf1a6a468fd27b4fff', lfs=None, last_commit=None, security=None),
    RepoFolder(path='en', tree_id='dc943c4c40f53d02b31ced1defa7e5f438d5862e', last_commit=None)
]
```

#### get_repo_discussions[[huggingface_hub.HfApi.get_repo_discussions]]

```python
get_repo_discussions(repo_id: str, author: str | None = None, discussion_type: constants.DiscussionTypeFilter | None = None, discussion_status: constants.DiscussionStatusFilter | None = None, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7261)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

author (`str`, *اختياري*) : مرر قيمةً لتصفية حسب مؤلف المناقشة. تعني `None` عدم وجود تصفية. القيمة الافتراضية هي `None`.

discussion_type (`str`, *اختياري*) : اضبطه على `"pull_request"` لجلب طلبات الدمج فقط، أو على `"discussion"` لجلب المناقشات فقط. اضبطه على `"all"` أو `None` لجلب كليهما. القيمة الافتراضية هي `None`.

discussion_status (`str`, *اختياري*) : اضبطه على `"open"` (أو `"closed"`) لجلب المناقشات المفتوحة فقط (أو المغلقة فقط). اضبطه على `"all"` أو `None` لجلب كلا النوعين. القيمة الافتراضية هي `None`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تستخرج من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تستخرج من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterator[Discussion]`

مُتكرِّر (iterator) من كائنات [Discussion](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.Discussion).

يجلب النقاشات وطلبات الدمج للمستودع المحدد.

مثال:

جمع جميع مناقشات المستودع في قائمة:

```python
>>> from huggingface_hub import get_repo_discussions
>>> discussions_list = list(get_repo_discussions(repo_id="bert-base-uncased"))
```

التكرار على مناقشات مستودع:

```python
>>> from huggingface_hub import get_repo_discussions
>>> for discussion in get_repo_discussions(repo_id="bert-base-uncased"):
...     print(discussion.num, discussion.title)
```

#### get_safetensors_metadata[[huggingface_hub.HfApi.get_safetensors_metadata]]

```python
get_safetensors_metadata(repo_id: str, repo_type: str | None = None, revision: str | None = None, token: bool | str | None = None, timeout: float | None = 10)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6674)

**المعاملات:**

repo_id (`str`) : اسم مستخدم أو منظمة واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كان الملف في مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كان في نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة الخاصة بـ git لجلب الملف منها. يمكن أن تكون اسم فرع، أو وسم، أو تجزئة commit. الافتراضي هو رأس فرع `"main"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

timeout (`float`، *اختياري*، القيمة الافتراضية 10) : عدد الثواني التي يجب انتظارها حتى يرسل الخادم البيانات قبل التوقف، وتُمرَّر إلى كل طلب يجلب ترويسة ملف safetensors. اضبطها على `None` لتعطيل مهلة الانتهاء (غير موصى به، إذ قد يؤدي اتصال متوقف إلى تعليق الاستدعاء إلى ما لا نهاية).

**يعيد:** `SafetensorsRepoMetadata`

معلومات تتعلق بمستودع safetensors.

**يرفع:** `NotASafetensorsRepoError` أو `SafetensorsParsingError`

- `NotASafetensorsRepoError` -- إذا لم يكن المستودع مستودع safetensors، أي أنه لا يحتوي على ملف `model.safetensors` أو ملف `model.safetensors.index.json`.
- `SafetensorsParsingError` -- إذا تعذّر تحليل ترويسة ملف safetensors بشكل صحيح.

تحليل البيانات الوصفية لمستودع safetensors على Hub.

نبدأ أولاً بالتحقق مما إذا كان المستودع يحتوي على ملف safetensors واحد أو مستودع safetensors مقسّم إلى أجزاء. إذا كان ملف safetensors واحدًا، فإننا نحلل البيانات الوصفية من هذا الملف. أما إذا كان مستودع safetensors مقسّمًا إلى أجزاء، فإننا نحلل البيانات الوصفية من ملف الفهرس ثم نحلل البيانات الوصفية من كل جزء.

لتحليل البيانات الوصفية من ملف safetensors واحد، استخدم [parse_safetensors_file_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.parse_safetensors_file_metadata). للحصول على ترويسة كل شريحة من نموذج مقسّم على `main` في طلب واحد، استخدم [get_sharded_safetensors_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_sharded_safetensors_metadata).

لمزيد من التفاصيل حول صيغة safetensors، راجع https://huggingface.co/docs/safetensors/index#format.

مثال:
```py
# Parse repo with single weights file
>>> metadata = get_safetensors_metadata("bigscience/bloomz-560m")
>>> metadata
SafetensorsRepoMetadata(
    metadata=None,
    sharded=False,
    weight_map={'h.0.input_layernorm.bias': 'model.safetensors', ...},
    files_metadata={'model.safetensors': SafetensorsFileMetadata(...)}
)
>>> metadata.files_metadata["model.safetensors"].metadata
{'format': 'pt'}

# Parse repo with sharded model
>>> metadata = get_safetensors_metadata("bigscience/bloom")
Parse safetensors files: 100%|██████████████████████████████████████████| 72/72 [00:12<00:00,  5.78it/s]
>>> metadata
SafetensorsRepoMetadata(metadata={'total_size': 352494542848}, sharded=True, weight_map={...}, files_metadata={...})
>>> len(metadata.files_metadata)
72  # All safetensors files have been fetched

# Parse repo with sharded model
>>> get_safetensors_metadata("runwayml/stable-diffusion-v1-5")
NotASafetensorsRepoError: 'runwayml/stable-diffusion-v1-5' is not a safetensors repo. Couldn't find 'model.safetensors.index.json' or 'model.safetensors' files.
```

#### get_sharded_safetensors_metadata[[huggingface_hub.HfApi.get_sharded_safetensors_metadata]]

```python
get_sharded_safetensors_metadata(repo_id: str, filename: str = 'model.safetensors.index.json', token: bool | str | None = None, timeout: float | None = 10)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6829)

**المعاملات:**

repo_id (`str`) : اسم مستخدم أو منظمة واسم مستودع مفصولان بـ `/`.

filename (`str`، *اختياري*) : مسار ملف فهرس safetensors في المستودع. القيمة الافتراضية هي `"model.safetensors.index.json"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

timeout (`float`، *اختياري*، القيمة الافتراضية 10) : عدد الثواني التي يجب انتظارها حتى يرسل الخادم البيانات قبل التوقف. اضبطها على `None` لتعطيل مهلة الانتظار (غير موصى به، إذ قد يؤدي اتصال متوقف إلى تعليق الاستدعاء بشكل غير محدود).

**يعيد:** `SafetensorsRepoMetadata`

نفس البيانات الوصفية الموجودة في [get_safetensors_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata).

احصل على بيانات الوصف لكل شريحة من نموذج safetensors المقسّم على `main` من Hugging Face Hub في طلب واحد، بدلاً من أن يقوم [get_safetensors_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata) بتحليل ترويسة كل شريحة على حدة. متوفر على Hugging Face Hub فقط.

مثال:
```py
>>> metadata = get_sharded_safetensors_metadata("HuggingFaceH4/zephyr-7b-beta")
>>> len(metadata.files_metadata)
8
```

#### get_space_runtime[[huggingface_hub.HfApi.get_space_runtime]]

```python
get_space_runtime(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8244)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل حول مساحة (Space) تتضمن مرحلة المساحة (Space stage) والأجهزة (hardware).

يحصل على معلومات وقت التشغيل الخاصة بمساحة.

#### get_space_secrets[[huggingface_hub.HfApi.get_space_secrets]]

```python
get_space_secrets(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8114)

**المعاملات:**

repo_id (`str`) : معرّف المستودع المطلوب الاستعلام عنه. مثال: `"bigcode/in-the-stack"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `dict[str, SpaceSecret]`

قاموس من كائنات `SpaceSecret` مفهرس باسم السر.

يحصل على جميع الأسرار من مساحة.

القيم السرية قابلة للكتابة فقط ولا يمكن قراءتها مرة أخرى. يتم إرجاع المفتاح والوصف ووقت آخر تحديث فقط.

تتيح لك المفاتيح السرية تعيين مفاتيح أو رموز سرية لمساحة دون الحاجة إلى تضمينها في الكود. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.get_space_secrets("username/my-space")
{'HF_TOKEN': SpaceSecret(key='HF_TOKEN', description='...', updated_at=datetime.datetime(...))}
```

#### get_space_variables[[huggingface_hub.HfApi.get_space_variables]]

```python
get_space_variables(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8151)

**المعاملات:**

repo_id (`str`) : معرّف المستودع المطلوب الاستعلام عنه. مثال: `"bigcode/in-the-stack"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

يحصل على جميع المتغيرات من مساحة.

تتيح المتغيرات تعيين متغيرات البيئة لمساحة دون الحاجة إلى ترميزها بشكل ثابت. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables

#### get_user_overview[[huggingface_hub.HfApi.get_user_overview]]

```python
get_user_overview(username: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11726)

**المعاملات:**

username (`str`) : اسم المستخدم الذي تريد الحصول على نظرة عامة عنه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `User`

كائن [User](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.User) يحتوي على نظرة عامة على المستخدم.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` --  HTTP 404 إذا لم يوجد المستخدم على Hub.

احصل على نظرة عامة على مستخدم في Hub.

#### get_webhook[[huggingface_hub.HfApi.get_webhook]]

```python
get_webhook(webhook_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11076)

**المعاملات:**

webhook_id (`str`) : المعرّف الفريد لخطاف الويب (webhook) المطلوب جلبه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [WebhookInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookInfo)

معلومات حول خطاف الويب.

احصل على webhook باستخدام المعرّف الخاص به.

مثال:
```python
>>> from huggingface_hub import get_webhook
>>> webhook = get_webhook("654bbbc16f2ec14d77f109cc")
>>> print(webhook)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    job=None,
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    secret="my-secret",
    domains=["repo", "discussion"],
    disabled=False,
)
```

#### get_zero_gpu_quota[[huggingface_hub.HfApi.get_zero_gpu_quota]]

```python
get_zero_gpu_quota(token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8288)

**المعاملات:**

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). يجب أن يكون رمز الوصول الدقيق (fine-grained) مُنحًا إذن "Billing > Read billing usage and payment method status"، وأن يكون رمز OAuth مُنحًا نطاق `read-billing`.

**يعيد:** [ZeroGpuQuota](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.ZeroGpuQuota)

حصة ZeroGPU للمستخدم الموثّق.

احصل على حصة ZeroGPU للمستخدم الموثّق.

يُفيد في تتبع استخدام ZeroGPU عند استدعاء مساحات ZeroGPU برمجياً (على سبيل المثال، من تطبيق أو وكيل أو خادم MCP). راجع https://huggingface.co/docs/hub/spaces-zerogpu لمزيد من التفاصيل.

مثال:
```py
>>> from huggingface_hub import get_zero_gpu_quota
>>> quota = get_zero_gpu_quota()
>>> quota
ZeroGpuQuota(base=2400, remaining=1810, resets_at=datetime.datetime(2026, 9, 30, 9, 12, 3, tzinfo=datetime.timezone.utc), overquota_used=0)
>>> print(f"{quota.remaining / 60:.1f} minutes left")
30.2 minutes left
```

#### grant_access[[huggingface_hub.HfApi.grant_access]]

```python
grant_access(repo_id: str, user: str, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11021)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي سيتم منح الوصول إليه.

user (`str`) : اسم المستخدم الخاص بالمستخدم الذي سيتم منحُه الوصول.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم منح الوصول إليه. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 400 إذا كان لدى المستخدم بالفعل وصول إلى المستودع.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا لم يكن المستخدم موجودًا على Hub.

منح الوصول إلى مستخدمٍ مستودعٍ محكومٍ محدد.

لا يتطلب منح الوصول أن يرسل المستخدم طلب وصول بنفسه. يُضاف المستخدم تلقائيًا إلى قائمة المقبولين، مما يعني أنه يمكنه تنزيل الملفات. يمكنك إلغاء الوصول الممنوح في أي وقت باستخدام [cancel_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) أو [reject_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request).

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

#### hf_hub_download[[huggingface_hub.HfApi.hf_hub_download]]

```python
hf_hub_download(repo_id: str, filename: str, subfolder: str | None = None, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_dir: str | Path | None = None, force_download: bool = False, etag_timeout: float = 10, token: bool | str | None = None, local_files_only: bool = False, tqdm_class: type[base_tqdm] | None = None, dry_run: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6369)

**المعاملات:**

repo_id (`str`) : اسم مستخدم أو منظمة واسم مستودع مفصولان بـ `/`.

filename (`str`) : اسم الملف في المستودع.

subfolder (`str`، *اختياري*) : قيمة اختيارية تتوافق مع مجلد داخل المستودع.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنتَ تقوم بتنزيل من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنتَ تقوم بتنزيل من نموذج. القيمة الافتراضية هي `None`.

revision (`str`, *اختياري*) : معرف اختيارية لمراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.

cache_dir (`str`، `Path`، *اختياري*) : المسار إلى المجلد الذي تُخزَّن فيه الملفات المؤقتة.

local_dir (`str` أو `Path`، *اختياري*) : إذا تم تقديمه، فسيتم وضع الملف المُحمَّل تحت هذا المجلد.

force_download (`bool`، *اختياري*، الافتراضي `False`) : ما إذا كان يجب تنزيل الملف حتى لو كان موجودًا مسبقًا في ذاكرة التخزين المؤقت المحلية.

etag_timeout (`float`، *اختياري*، القيمة الافتراضية `10`) : عند جلب ETag، عدد الثواني التي يجب انتظارها حتى يرسل الخادم البيانات قبل التوقف، وهي القيمة التي تُمرَّر إلى `httpx2.request`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

local_files_only (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فتجنّب تنزيل الملف وعُدّ مسار الملف المخزّن محليًا إذا كان موجودًا.

tqdm_class (`tqdm`، *اختياري*) : إذا تم توفيره، يتجاوز السلوك الافتراضي لشريط التقدم. يجب أن يرث الحُجج المُمرَّرة من `tqdm.auto.tqdm` أو يحاكي سلوكه على الأقل. الافتراضي هو شريط تقدم مخصص من HF يمكن تعطيله عن طريق تعيين متغير البيئة `HF_HUB_DISABLE_PROGRESS_BARS`.

dry_run (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، يتم تنفيذ تشغيل تجريبي دون تنزيل الملف فعليًا. يعيد كائن [DryRunFileInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DryRunFileInfo) يحتوي على معلومات حول ما كان سيُتنزَّل.

**يعيد:** `str` أو [DryRunFileInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DryRunFileInfo)

- إذا كان `dry_run=False`: المسار المحلي للملف أو، إذا كانت الشبكة معطلة، آخر نسخة من الملف المخزنة مؤقتًا على القرص.
- إذا كان `dry_run=True`: كائن [DryRunFileInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DryRunFileInfo) يحتوي على معلومات التحميل.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) أو `~utils.RemoteEntryNotFoundError` أو [LocalEntryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.LocalEntryNotFoundError) أو ``EnvironmentError`` أو ``OSError`` أو ``ValueError``

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مضبوطًا على `private` ولا تملك صلاحية الوصول إليه.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا تعذّر العثور على المراجعة التي يجب التحميل منها.
- `~utils.RemoteEntryNotFoundError` -- إذا تعذّر العثور على الملف المطلوب تنزيله.
- [LocalEntryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.LocalEntryNotFoundError) -- إذا كان الاتصال بالشبكة معطلاً أو غير متاح ولم يتم العثور على الملف في ذاكرة التخزين المؤقت.
- [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- إذا كان `token=True` لكن تعذّر العثور على الرمز.
- [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) -- إذا تعذّر تحديد ETag.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كانت قيمة بعض المعاملات غير صالحة.

تنزيل ملف محدد إذا لم يكن موجودًا مسبقًا في ذاكرة التخزين المؤقت المحلية.

يبدو تخطيط ملف الكاش الجديد على النحو التالي:
- تحتوي مجلد التخزين المؤقت على مجلد فرعي واحد لكل repo_id (مُقسَّم حسب نوع المستودع)
- داخل كل مجلد مستودع:
  - refs هو قائمة بأحدث أزواج المراجعة المعروفة => commit_hash
  - يحتوي blobs على ملفات blobs الفعلية (المُعرَّفة بـ git-sha أو sha256، اعتمادًا على ما إذا كانت ملفات LFS أم لا)
  - تحتوي snapshots على مجلد فرعي واحد لكل commit، ويحتوي كل "commit" على مجموعة فرعية من الملفات التي تم حلّها عند ذلك commit بالتحديد. كل اسم ملف هو رابط رمزي إلى blob عند ذلك commit بالتحديد.

```
[  96]  .
└── [ 160]  models--julien-c--EsperBERTo-small
    ├── [ 160]  blobs
    │   ├── [321M]  403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
    │   ├── [ 398]  7cb18dc9bafbfcf74629a4b760af1b160957a83e
    │   └── [1.4K]  d7edf6bd2a681fb0175f7735299831ee1b22b812
    ├── [  96]  refs
    │   └── [  40]  main
    └── [ 128]  snapshots
        ├── [ 128]  2439f60ef33a0d46d85da5001d52aeda5b00ce9f
        │   ├── [  52]  README.md -> ../../blobs/d7edf6bd2a681fb0175f7735299831ee1b22b812
        │   └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
        └── [ 128]  bbc77c8132af1cc5cf678da3f1ddf2de43606d48
            ├── [  52]  README.md -> ../../blobs/7cb18dc9bafbfcf74629a4b760af1b160957a83e
            └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
```

إذا تم تقديم `local_dir`، فسيتم تكرار هيكل الملفات من المستودع في هذا الموقع. عند استخدام هذا الخيار، لن يتم استخدام `cache_dir` وسيتم إنشاء مجلد `.cache/huggingface/` في جذر `local_dir` لتخزين بعض البيانات الوصفية المتعلقة بالملفات التي تم تنزيلها. على الرغم من أن هذا الآلية ليست قوية مثل نظام الكاش الرئيسي، إلا أنها مُحسّنة لسحب أحدث إصدار من المستودع بانتظام.

#### hide_discussion_comment[[huggingface_hub.HfApi.hide_discussion_comment]]

```python
hide_discussion_comment(repo_id: str, discussion_num: int, comment_id: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7945)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

comment_id (`str`) : المعرّف الخاص بالتعليق الذي تريد تحريره.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [DiscussionComment](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionComment)

التعليق المخفي

يخفي تعليقًا على نقاش / طلب سحب.

> [!WARNING]
> لا يمكن استرجاع محتوى التعليقات المخفية بعد الآن. إخفاء التعليق إجراء غير قابل للتراجع.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### inspect_job[[huggingface_hub.HfApi.inspect_job]]

```python
inspect_job(job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12568)

**المعاملات:**

job_id (`str`) : معرف المهمة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يعمل فيها Job. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

فحص مهمة حساب على بنية Hugging Face التحتية.

مثال:

```python
>>> from huggingface_hub import inspect_job, run_job
>>> job = run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"])
>>> inspect_job(job_id=job.id)
JobInfo(
    id='68780d00bbe36d38803f645f',
    created_at=datetime.datetime(2025, 7, 16, 20, 35, 12, 808000, tzinfo=datetime.timezone.utc),
    docker_image='python:3.12',
    space_id=None,
    command=['python', '-c', "print('Hello from HF compute!')"],
    arguments=[],
    environment={},
    secrets={},
    flavor='cpu-basic',
    status=JobStatus(stage='RUNNING', message=None)
)
```

#### inspect_scheduled_job[[huggingface_hub.HfApi.inspect_scheduled_job]]

```python
inspect_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13290)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

فحص مهمة حساب مجدولة على بنية Hugging Face التحتية.

مثال:

```python
>>> from huggingface_hub import inspect_scheduled_job, create_scheduled_job
>>> scheduled_job = create_scheduled_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"], schedule="@hourly")
>>> inspect_scheduled_job(scheduled_job_id=scheduled_job.id)
```

#### kernel_info[[huggingface_hub.HfApi.kernel_info]]

```python
kernel_info(repo_id: str, revision: str | None = None, timeout: float | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3434)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`، *اختياري*) : إصدار مستودع النواة الذي سيتم منه جلب المعلومات.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [ModelInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.ModelInfo)

معلومات مستودع النواة.

احصل على معلومات حول نواة محددة على huggingface.co.

#### list_accepted_access_requests[[huggingface_hub.HfApi.list_accepted_access_requests]]

```python
list_accepted_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10673)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي تريد الحصول على طلبات الوصول إليه.

repo_type (`str`, *اختياري*) : نوع المستودع الذي تريد الحصول على طلبات الوصول له. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[AccessRequest]`

قابلة للتكرار من كائنات `AccessRequest`. يحتوي كل عنصر على سمات `username` و`request_id` و`email` و`status` و`timestamp`. إذا كان المستودع المحمي يحتوي على نموذج مخصص، فسيتم ملء سمة `fields` بإجابات المستخدم.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.

احصل على طلبات الوصول المقبولة لمستودع محكوم الوصول محدد.

تعني الطلب المقبول أن المستخدم قد طلب الوصول إلى المستودع وتم قبول الطلب. يمكن للمستخدم تنزيل أي ملف من المستودع. إذا كان وضع الموافقة تلقائيًا، فيجب أن تحتوي هذه القائمة افتراضيًا على جميع الطلبات. يمكن إلغاء الطلبات المقبولة أو رفضها في أي وقت باستخدام [cancel_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request) و [reject_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request). سيعود الطلب الملغي إلى قائمة الطلبات المعلّقة بينما ينتقل الطلب المرفوض إلى قائمة الطلبات المرفوضة. في الحالتين، سيفقد المستخدم الوصول إلى المستودع.

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

مثال:
```py
>>> from huggingface_hub import list_accepted_access_requests

>>> requests = list(list_accepted_access_requests("meta-llama/Llama-2-7b"))
>>> len(requests)
411
>>> requests[0]
[
    AccessRequest(
        username='clem',
        request_id='655f3a1c9e6b2d4f8a7c1e05',
        fullname='Clem 🤗',
        email='***',
        timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
        status='accepted',
        fields=None,
    ),
    ...
]
```

#### list_bucket_tree[[huggingface_hub.HfApi.list_bucket_tree]]

```python
list_bucket_tree(bucket_id: str, prefix: str | None = None, recursive: bool | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14306)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

prefix (`str`، *اختياري*) : تصفية النتائج إلى الملفات التي يبدأ مسارها بهذا البادئة.

recursive (`bool`, *اختياري*) : إذا كان `True`، تُستعرض الملفات بشكل متكرر. إذا كان `False` (الافتراضي)، تُستعرض الملفات والمجلدات في الجذر فقط.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[Union[BucketFile, BucketFolder]]`

قابلة للتكرار من كائنات [BucketFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketFile) و`BucketFolder` تحتوي على معلومات الملفات والمجلدات (المسار، وما إلى ذلك).

قائمة الملفات في الدلو.

مثال:
```python
>>> from huggingface_hub import list_bucket_tree
>>> for file_info in list_bucket_tree(bucket_id="username/my-bucket"):
...     print(file_info.path)

>>> # Filter by prefix
>>> for file_info in list_bucket_tree(bucket_id="username/my-bucket", prefix="models/"):
...     print(file_info.path)
```

#### list_buckets[[huggingface_hub.HfApi.list_buckets]]

```python
list_buckets(namespace: str | None = None, search: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14113)

**المعاملات:**

namespace (`str`، *اختياري*) : قائمة الدلاء (buckets) الموجودة تحت هذا الاسم (المستخدم أو المؤسسة). الافتراضي هو عرض دلاء المستخدم.

search (`str`، *اختياري*) : نص بحثي لتصفية أسماء الدلاء.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[BucketInfo]`

قابلة للتكرار من كائنات [BucketInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.BucketInfo).

قائمة الدلاء على Hub ضمن مساحة أسماء معينة.

مثال:
```python
>>> from huggingface_hub import list_buckets
>>> for bucket in list_buckets(): # lists buckets in the user's namespace
...     print(bucket)

>>> for bucket in list_buckets(namespace="huggingface"): # lists buckets in the "huggingface" organization
...     print(bucket)

>>> for bucket in list_buckets(search="my-prefix"): # filter buckets by name
...     print(bucket)
```

#### list_collections[[huggingface_hub.HfApi.list_collections]]

```python
list_collections(owner: list[str] | str | None = None, item: list[str] | str | None = None, sort: CollectionSort_T | None = None, limit: int | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10100)

**المعاملات:**

owner (`list[str]` أو `str`، *اختياري*) : تصفية حسب اسم مستخدم المالك.

item (`list[str]` أو `str`، *اختياري*) : تصفية المجموعات التي تحتوي على عناصر محددة. مثال: `"models/teknium/OpenHermes-2.5-Mistral-7B"`، `"datasets/squad"` أو `"papers/2311.12983"`.

sort (`Literal["lastModified", "trending", "upvotes"]`، *اختياري*) : ترتيب المجموعات حسب آخر تعديل، أو الاتجاهات الرائجة، أو الأصوات الإيجابية.

limit (`int`, *اختياري*) : الحد الأقصى لعدد المجموعات التي سيتم إرجاعها.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[Collection]`

قابلة للتكرار من كائنات [Collection](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.Collection).

قائمة المجموعات على Huggingface Hub، مع مراعاة بعض عوامل التصفية.

> [!WARNING]
> عند سرد المجموعات، يتم اقتصاص قائمة العناصر لكل مجموعة إلى 4 عناصر كحد أقصى. لاسترجاع جميع العناصر من مجموعة، يجب عليك استخدام [get_collection()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_collection).

#### list_daily_papers[[huggingface_hub.HfApi.list_daily_papers]]

```python
list_daily_papers(date: str | None = None, token: bool | str | None = None, week: str | None = None, month: str | None = None, submitter: str | None = None, sort: DailyPapersSort_T | None = None, p: int | None = None, limit: int | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11983)

**المعاملات:**

date (`str`، *اختياري*) : التاريخ بتنسيق ISO (YYYY-MM-DD) الذي سيتم جلب الأوراق اليومية بناءً عليه. الافتراضي هو أحدث الأوراق.

token (Union[bool, str, None], *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا. لتعطيل المصادقة، مرر `False`.

week (`str`، *اختياري*) : الأسبوع بتنسيق ISO (YYYY-Www) الذي سيتم جلب الأوراق اليومية له. مثال، `2025-W09`.

month (`str`، *اختياري*) : الشهر بتنسيق ISO (YYYY-MM) الذي سيتم جلب الأوراق اليومية له. مثال، `2025-02`.

submitter (`str`، *اختياري*) : اسم المستخدم الخاص بالمُقدِّم لتصفية الأوراق اليومية.

sort (`Literal["publishedAt", "trending"]`, *اختياري*) : ترتيب الفرز للأوراق اليومية. يمكن أن يكون إما حسب `publishedAt` أو حسب `trending`. القيمة الافتراضية هي `"publishedAt"`

p (`int`، *اختياري*) : رقم الصفحة للتقسيم إلى صفحات. القيمة الافتراضية هي 0.

limit (`int`, *اختياري*) : الحد الأقصى لعدد الأوراق التي سيتم جلبها. القيمة الافتراضية هي 50.

**يعيد:** `Iterable[PaperInfo]`

قابلة للتكرار من كائنات `huggingface_hub.hf_api.PaperInfo`.

قائمة الأوراق اليومية المنشورة في تاريخ معيّن على Hugging Face Hub.

مثال:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()
>>> list(api.list_daily_papers(date="2025-10-29"))
```

#### list_dataset_parquet_files[[huggingface_hub.HfApi.list_dataset_parquet_files]]

```python
list_dataset_parquet_files(repo_id: str, config: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2712)

**المعاملات:**

repo_id (`str`) : معرّف مستودع مجموعة البيانات (مثل `"username/dataset-name"`).

config (`str`، *اختياري*) : تصفية حسب اسم الإعداد/المجموعة الفرعية المحددة. عند تقديمه، تُعاد ملفات parquet الخاصة بذلك الإعداد فقط.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `list[DatasetParquetEntry]`

قائمة من كائنات `DatasetParquetEntry` تحتوي على الإعداد (config) والجزء (split) والرابط (url) والحجم (size) لكل ملف parquet.

قائمة ملفات parquet المتاحة لمجموعة بيانات على Hub.

تُحوَّل جميع مجموعات البيانات المستضافة على Hub تلقائيًا إلى Parquet بواسطة [Dataset Viewer](https://huggingface.co/docs/dataset-viewer/parquet). تُعيد هذه الطريقة قائمة ملفات parquet مع عناوينها (URLs) وإعداداتها (configs) وقسماتها (splits) وأحجامها.

مثال:
```python
>>> from huggingface_hub import list_dataset_parquet_files
>>> list_dataset_parquet_files("lhoestq/demo1")
>>> entries[0]
DatasetParquetEntry(config='default', split='train', url='https://huggingface.co/...', size=5038)
```

#### list_datasets[[huggingface_hub.HfApi.list_datasets]]

```python
list_datasets(filter: str | Iterable[str] | None = None, author: str | None = None, benchmark: Literal[True] | Literal['official'] | str | None = None, dataset_name: str | None = None, gated: bool | None = None, language_creators: str | list[str] | None = None, language: str | list[str] | None = None, multilinguality: str | list[str] | None = None, size_categories: str | list[str] | None = None, task_categories: str | list[str] | None = None, task_ids: str | list[str] | None = None, search: str | None = None, sort: DatasetSort_T | None = None, limit: int | None = None, expand: list[ExpandDatasetProperty_T] | None = None, full: bool | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2507)

**المعاملات:**

filter (`str` أو `Iterable[str]`، *اختياري*) : نص أو قائمة من النصوص لتصفية مجموعات البيانات على الحاضنة.

author (`str`، *اختياري*) : نص يحدد مؤلف مجموعات البيانات المُعادَة.

benchmark (`True`، `"official"`، `str`، *اختياري*) : تصفية مجموعات البيانات حسب المعيار. يمكن أن يكون `True` أو `"official"` لإرجاع مجموعات بيانات المعايير الرسمية. ولتوافق مع المستقبل، يمكن أن يكون أيضًا نصًا يمثل اسم المعيار (حاليًا، يُدعم "official" فقط).

dataset_name (`str`, *اختياري*) : نص أو قائمة نصوص يمكن استخدامه لتحديد مجموعات البيانات على Hub باسمها، مثل `SQAC` أو `wikineural`

gated (`bool`, *اختياري*) : قيمة منطقية لتصفية مجموعات البيانات على Hub التي تكون محمية أو غير محمية. افتراضيًا، تُعاد جميع مجموعات البيانات. إذا تم تمرير `gated=True`، تُعاد فقط مجموعات البيانات المحمية. إذا تم تمرير `gated=False`، تُعاد فقط مجموعات البيانات غير المحمية.

language_creators (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص يمكن استخدامها لتحديد مجموعات البيانات على Hub بطريقة تجميع البيانات، مثل `crowdsourced` أو `machine_generated`.

language (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص تمثل لغة من حرفين لتصفية مجموعات البيانات على Hub.

multilinguality (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص تمثل مرشحًا للبيانات التي تحتوي على لغات متعددة.

size_categories (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص يمكن استخدامها لتحديد مجموعات البيانات على Hub حسب حجم مجموعة البيانات، مثل `100K<n<1M` أو `1M<n<10M`.

task_categories (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص يمكن استخدامها لتحديد مجموعات البيانات على Hub حسب المهمة المصممة، مثل `audio_classification` أو `named_entity_recognition`.

task_ids (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص يمكن استخدامها لتحديد مجموعات البيانات على Hub بناءً على المهمة المحددة مثل `speech_emotion_recognition` أو `paraphrase`.

search (`str`، *اختياري*) : نص سيُدرج في مجموعات البيانات المُعادَة.

sort (`DatasetSort_T`، *اختياري*) : المفتاح الذي يُستخدم لفرز مجموعات البيانات الناتجة. القيم الممكنة هي "created_at" و"downloads" و"last_modified" و"likes" و"trending_score".

limit (`int`، *اختياري*) : الحد الأقصى لعدد مجموعات البيانات التي يتم جلبها. إذا تُركت هذه الخانة `None`، فسيتم جلب جميع مجموعات البيانات.

expand (`list[ExpandDatasetProperty_T]`، *اختياري*) : خصائص القائمة التي يجب إرجاعها في الاستجابة. عند الاستخدام، لن تُرجع سوى الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `full`. القيم الممكنة هي `"author"`، `"cardData"`، `"citation"`، `"createdAt"`، `"disabled"`، `"description"`، `"downloads"`، `"downloadsAllTime"`، `"gated"`، `"lastModified"`، `"likes"`، `"mainSize"`، `"paperswithcode_id"`، `"private"`، `"siblings"`، `"sha"`، `"tags"`، `"trendingScore"`، `"usedStorage"`، و`"resourceGroup"`.

full (`bool`، *اختياري*) : ما إذا كان سيتم جلب جميع بيانات مجموعة البيانات، بما في ذلك `last_modified` و`card_data` والملفات. قد تحتوي على معلومات مفيدة مثل معرّف PapersWithCode.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[DatasetInfo]`

قابلة للتكرار من كائنات [huggingface_hub.hf_api.DatasetInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DatasetInfo).

قائمة مجموعات البيانات المستضافة على Huggingface Hub، مع مراعاة بعض عوامل التصفية.

مثال على الاستخدام مع الحجة `filter`:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all datasets
>>> api.list_datasets()

# List only the text classification datasets
>>> api.list_datasets(filter="task_categories:text-classification")

# List only the datasets in russian for language modeling
>>> api.list_datasets(
...     filter=("language:ru", "task_ids:language-modeling")
... )

# List FiftyOne datasets (identified by the tag "fiftyone" in dataset card)
>>> api.list_datasets(filter="fiftyone")
```

مثال على الاستخدام مع الحجة `search`:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all datasets with "text" in their name
>>> api.list_datasets(search="text")

# List all datasets with "text" in their name made by google
>>> api.list_datasets(search="text", author="google")
```

#### list_inference_catalog[[huggingface_hub.HfApi.list_inference_catalog]]

```python
list_inference_catalog(accelerator: Literal['cpu', 'gpu', 'neuron'] | str | None = None, engine: Literal['llamacpp', 'sglang', 'tei', 'vllm'] | str | None = None, license: str | None = None, task: str | None = None, search: str | None = None, limit: int | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9591)

**المعاملات:**

accelerator (`str`، *اختياري*) : إرجاع النماذج التي لديها وصفة لهذا المعجِّل (`"cpu"` أو `"gpu"` أو `"neuron"`) فقط.

engine (`str`, *اختياري*) : إرجاع النماذج التي لديها وصفة لهذا محرك الاستدلال فقط (مثل `"vllm"`، `"llamacpp"`، `"tei"`، `"sglang"`).

license (`str`، *اختياري*) : إرجاع النماذج الموجودة تحت هذا الترخيص فقط (مثل `"Apache 2.0"`).

task (`str`، *اختياري*) : إرجاع النماذج الخاصة بهذه المهمة فقط (مثل `"text-generation"`).

search (`str`، *اختياري*) : إرجاع النماذج المطابقة لهذا الاستعلام فقط.

limit (`int`، *اختياري*) : الحد الأقصى لعدد النماذج التي يجب إرجاعها.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication).

**يعيد:** `list[InferenceCatalogModel]`

النماذج المتاحة في الكتالوج، كلٌّ منها مع وصفاته المُختبَرة.

قائمة النماذج المتاحة في كتالوج الاستدلال الخاص بـ Hugging Face.

يهدف كتالوج الاستدلال إلى تقديم قائمة مُنتقاة من النماذج المُحسّنة للاستدلال والتي تم اختبار الإعدادات الافتراضية لها. راجع https://endpoints.huggingface.co/catalog للاطلاع على قائمة النماذج المتاحة في الكتالوج.

استخدم [create_inference_endpoint_from_catalog()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_inference_endpoint_from_catalog) لنشر نموذج أو وصفة من الكتالوج.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> catalog = api.list_inference_catalog(task="text-generation", accelerator="neuron")
>>> [(model.repo_id, [recipe.id for recipe in model.recipes]) for model in catalog]
[('meta-llama/Llama-3.1-8B-Instruct', ['sizzling-biryani-g4xsi1ac', 'artisanal-quinoa-yz9ynamx']), ...]
```

> [!WARNING]
> `list_inference_catalog` تجريبي. قد تتغير واجهته البرمجية (API) في المستقبل. يرجى تقديم ملاحظاتك إذا كان لديك أي اقتراحات أو طلبات.

#### list_inference_endpoints[[huggingface_hub.HfApi.list_inference_endpoints]]

```python
list_inference_endpoints(namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9152)

**المعاملات:**

namespace (`str`, *اختياري*) : مساحة الأسماء التي سيتم سرد نقاط النهاية الخاصة بها. الافتراضي هو المستخدم الحالي. اضبطها على `"*"` لسرد جميع نقاط النهاية من جميع مساحات الأسماء (أي مساحة الاسم الشخصية وجميع المنظمات التي ينتمي إليها المستخدم).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** قائمة [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

قائمة بجميع نقاط الاستدلال (inference endpoints) للمساحة الاسم (namespace) المحددة.

يُدرج جميع نقاط الاستدلال (inference endpoints) للمساحة الاسم (namespace) المحددة.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.list_inference_endpoints()
[InferenceEndpoint(name='my-endpoint', ...), ...]
```

#### list_inference_endpoints_hardware[[huggingface_hub.HfApi.list_inference_endpoints_hardware]]

```python
list_inference_endpoints_hardware(namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10042)

**المعاملات:**

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم سرد الحواسيب المتاحة وحصة المعالج التسريعي الخاصة بها. الافتراضي هو المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication).

**يعيد:** `list[InferenceEndpointHardware]`

الأجهزة المتوفرة لدى كل مزوّد ومنطقة، بما في ذلك الأجهزة غير المتوفرة حاليًا أو المتوقفة عن الدعم.

list_hardware

تحتوي كل سجل على القيم الدقيقة لـ`vendor` و`region` و`accelerator` و`instance_type` و`instance_size` التي يتوقعها [create_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_inference_endpoint)، إلى جانب سعر الحصة المخصصة للمسرِّح ضمن مساحة الاسم.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> hardware = api.list_inference_endpoints_hardware()
>>> [hw.id for hw in hardware if hw.accelerator == "gpu" and hw.status == "available"]
['aws-us-east-1-nvidia-l4-x1', 'aws-us-east-1-nvidia-l4-x4', ...]
```

#### list_jobs[[huggingface_hub.HfApi.list_jobs]]

```python
list_jobs(status: list[JobStage | str] | JobStage | str | None = None, labels: dict[str, str] | None = None, timeout: int | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12492)

**المعاملات:**

status (`JobStage`، `str` أو `list`، *اختياري*) : إرجاع المهام التي تحمل الحالة المحددة فقط، مثل `"RUNNING"` أو `[JobStage.RUNNING, JobStage.SCHEDULING]`. راجع [JobStage](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobStage) لمعرفة القيم الممكنة.

labels (`dict[str, str]`، *اختياري*) : إرجاع المهام التي تحمل جميع التسميات المحددة بالصيغة `key=value` فقط، على سبيل المثال `{"env": "prod", "team": "ml"}`.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

namespace (`str`، *اختياري*) : مساحة الاسم التي تُستخرج منها قائمة المهام. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** `Iterable[JobInfo]`

قابلة للتكرار من كائنات [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo).

قائمة مهام الحساب على بنية Hugging Face التحتية.

#### list_jobs_hardware[[huggingface_hub.HfApi.list_jobs_hardware]]

```python
list_jobs_hardware(token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12540)

**يعيد:** `list[JobHardwareInfo]`

قائمة بتكوينات الأجهزة المتاحة.

قائمة خيارات الأجهزة المتاحة للمهام على بنية Hugging Face التحتية.

مثال:

```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> hardware_list = api.list_jobs_hardware()
>>> hardware_list[0]
JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ephemeral_storage='20 GB', accelerator=None, unit_cost_micro_usd=167, unit_cost_usd=0.000167, unit_label='minute')
>>> hardware_list[0].name
'cpu-basic'

# Filter GPU options
>>> gpu_hardware = [hw for hw in hardware_list if hw.accelerator is not None]
>>> gpu_hardware[0].accelerator.model
'T4'
```

#### list_lfs_files[[huggingface_hub.HfApi.list_lfs_files]]

```python
list_lfs_files(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4431)

**المعاملات:**

repo_id (`str`) : المستودع الذي تُدرج ملفات LFS الخاصة به.

repo_type (`str`, *اختياري*) : نوع المستودع. اضبطه على `"dataset"` أو `"space"` عند الإدراج من مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الإدراج من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[LFSFileInfo]`

مُتكرِّر (iterator) من كائنات `LFSFileInfo`.

List all LFS files in a repo on the Hub.

يكون هذا مفيدًا بشكل رئيسي لقياس مقدار التخزين الذي تستخدمه المستودع، ولتنظيف الملفات الكبيرة في النهاية باستخدام [permanently_delete_lfs_files()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.permanently_delete_lfs_files). لاحظ أن هذا إجراء دائم سيؤثر على جميع الالتزامات التي تشير إلى هذه الملفات المحذوفة، ولا يمكن التراجع عنه.

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> lfs_files = api.list_lfs_files("username/my-cool-repo")

# Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`.
# e.g. select only LFS files in the "checkpoints" folder
>>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/"))

# Permanently delete LFS files
>>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete)
```

#### list_liked_repos[[huggingface_hub.HfApi.list_liked_repos]]

```python
list_liked_repos(user: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2993)

**المعاملات:**

user (`str`، *اختياري*) : اسم المستخدم الذي تريد جلب الإعجابات الخاصة به.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [UserLikes](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.UserLikes)

كائن يحتوي على اسم المستخدم وقوائم معرفات المستودعات الثلاث (قائمة واحدة للنماذج، وقائمة واحدة للمجموعات البيانات، وقائمة واحدة للمساحات).

**يرفع:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا لم يتم تمرير `user` ولم يتم العثور على رمز (سواءً من الحجة أو من الجهاز).

list_public_repos

هذا القوائم عامة، لذا فإن الرمز اختياري. إذا لم يُمرَّر `user`، فسيُستخدم المستخدم المسجَّل حاليًا افتراضيًا.

انظر أيضًا إلى [unlike()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.unlike).

مثال:
```python
>>> from huggingface_hub import list_liked_repos

>>> likes = list_liked_repos("julien-c")

>>> likes.user
"julien-c"

>>> likes.models
["osanseviero/streamlit_1.15", "Xhaheen/ChatGPT_HF", ...]
```

#### list_models[[huggingface_hub.HfApi.list_models]]

```python
list_models(filter: str | Iterable[str] | None = None, author: str | None = None, apps: str | list[str] | None = None, gated: bool | None = None, inference: Literal['warm'] | None = None, inference_provider: Literal['all'] | PROVIDER_T | list[PROVIDER_T] | None = None, trained_dataset: str | list[str] | None = None, search: str | None = None, pipeline_tag: str | None = None, num_parameters: str | None = None, emissions_thresholds: tuple[float, float] | None = None, sort: ModelSort_T | None = None, limit: int | None = None, expand: list[ExpandModelProperty_T] | None = None, full: bool | None = None, cardData: bool = False, fetch_config: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2315)

**المعاملات:**

filter (`str` أو `Iterable[str]`، *اختياري*) : نص أو قائمة من النصوص لتصفية النماذج على Hub. يمكن تصفية النماذج حسب المكتبة، واللغة، والمهمة، والوسوم، وغيرها.

author (`str`، *اختياري*) : نص يحدد مؤلف (مستخدم أو منظمة) النماذج المُعادَة.

apps (`str` أو `List`، *اختياري*) : نص أو قائمة من النصوص لتصفية النماذج على Hub التي تدعم التطبيقات المحددة. تتضمن القيم النموذجية `"ollama"` أو `["ollama", "vllm"]`.

gated (`bool`, *اختياري*) : قيمة منطقية لتصفية النماذج على Hub التي تكون محمية أو غير محمية. افتراضيًا، تُعاد جميع النماذج. إذا تم تمرير `gated=True`، تُعاد النماذج المحمية فقط. إذا تم تمرير `gated=False`، تُعاد النماذج غير المحمية فقط.

inference (`Literal["warm"]`، *اختياري*) : إذا كانت القيمة "warm"، يتم تصفية النماذج على Hub التي يقدّمها حاليًا مزوّد واحد على الأقل.

inference_provider (`Literal["all"]` أو `str`، *اختياري*) : نصٌ لتصفية النماذج على Hub التي تُقدَّم بواسطة مزوّد معيّن. مرّر `"all"` للحصول على جميع النماذج التي تُقدَّم بواسطة مزوّد واحد على الأقل.

trained_dataset (`str` أو `List`، *اختياري*) : وسم نصي أو قائمة من الوسوم النصية للمجموعة التدريبية لنموذج على Hub.

search (`str`، *اختياري*) : نص سيُدرج في معرّفات النماذج المُعادَة.

pipeline_tag (`str`، *اختياري*) : وسم خط أنابيب نصي لتصفية النماذج على Hub، مثل `summarization`.

num_parameters (`str`، *اختياري*) : تصفية النماذج حسب عدد المعاملات. يقبل نفس صيغة النطاق كما في واجهة Hub وواجهة API، على سبيل المثال `"min:6B,max:128B"`، `"min:6B"` أو `"max:128B"`.

emissions_thresholds (`Tuple`, *اختياري*) : مجموعة مرتبة من عددين صحيحين أو عشريين تمثل الحد الأدنى والحد الأقصى لالبصمة الكربونية، وذلك لتصفية النماذج الناتجة، بوحدة الغرام.

sort (`ModelSort_T`، *اختياري*) : المفتاح الذي يُستخدم لفرز النماذج الناتجة. القيم الممكنة هي "created_at" و"downloads" و"last_modified" و"likes" و"trending_score".

limit (`int`، *اختياري*) : الحد الأقصى لعدد النماذج التي يتم جلبها. إذا تُركت هذه الخانة `None`، فسيتم جلب جميع النماذج.

expand (`list[ExpandModelProperty_T]`، *اختياري*) : خصائص قائمة للإرجاع في الاستجابة. عند الاستخدام، لن تُرجع سوى الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `full` أو `cardData` أو `fetch_config`. القيم الممكنة هي `"author"`، `"cardData"`، `"config"`، `"createdAt"`، `"disabled"`، `"downloads"`، `"downloadsAllTime"`، `"evalResults"`، `"gated"`، `"gguf"`، `"inference"`، `"inferenceProviderMapping"`، `"lastModified"`، `"library_name"`، `"likes"`، `"mask_token"`، `"model-index"`، `"pipeline_tag"`، `"private"`، `"safetensors"`، `"sha"`، `"siblings"`، `"spaces"`، `"tags"`، `"transformersInfo"`، `"trendingScore"`، `"widgetData"`، و`"resourceGroup"`.

full (`bool`, *اختياري*) : ما إذا كان سيتم جلب جميع بيانات النموذج، بما في ذلك `last_modified`، و`sha`، والملفات و`tags`. يتم تعيين هذا إلى `True` افتراضيًا عند استخدام مرشح.

cardData (`bool`، *اختياري*) : ما إذا كان سيتم جلب بيانات الوصف الخاصة بالنموذج أيضًا. قد تحتوي على معلومات مفيدة مثل انبعاثات الكربون، والمقاييس، ومجموعات البيانات التي تم التدريب عليها.

fetch_config (`bool`, *اختياري*) : ما إذا كان سيتم جلب إعدادات النموذج أيضًا. هذا غير مشمول في `full` بسبب حجمه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[ModelInfo]`

قابلة للتكرار من كائنات [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.ModelInfo).

قائمة النماذج المستضافة على Huggingface Hub، مع مراعاة بعض عوامل التصفية.

مثال:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all models
>>> api.list_models()

# List text classification models
>>> api.list_models(filter="text-classification")

# List models from the KerasHub library
>>> api.list_models(filter="keras-hub")

# List models served by Cohere
>>> api.list_models(inference_provider="cohere")

# List models with "bert" in their name
>>> api.list_models(search="bert")

# List models with "bert" in their name and pushed by google
>>> api.list_models(search="bert", author="google")

# List models with 6B to 128B parameters
>>> api.list_models(num_parameters="min:6B,max:128B", sort="likes")
```

#### list_organization_followers[[huggingface_hub.HfApi.list_organization_followers]]

```python
list_organization_followers(organization: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11779)

**المعاملات:**

organization (`str`) : اسم المنظمة التي تريد الحصول على متابعيها.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[User]`

قائمة من كائنات [User](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.User) تتضمن متابعي المنظمة.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` --  HTTP 404 إذا لم تكن المنظمة موجودة على Hub.

قائمة متابعي منظمة على Hub.

#### list_organization_members[[huggingface_hub.HfApi.list_organization_members]]

```python
list_organization_members(organization: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11808)

**المعاملات:**

organization (`str`) : اسم المنظمة التي تريد الحصول على أعضائها.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[User]`

قائمة من كائنات [User](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.User) بأعضاء المنظمة.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` --  HTTP 404 إذا لم تكن المنظمة موجودة على Hub.

قائمة بأعضاء منظمة على الـ Hub.

#### list_papers[[huggingface_hub.HfApi.list_papers]]

```python
list_papers(query: str | None = None, limit: int | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11892)

**المعاملات:**

query (`str`، *اختياري*) : سلسلة نصية للاستعلام عن البحث للعثور على الأوراق. إذا تم تقديمها، تُرجع الأوراق التي تطابق الاستعلام.

limit (`int`، *اختياري*) : الحد الأقصى لعدد الأوراق التي يجب إرجاعها.

token (Union[bool, str, None], *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[PaperInfo]`

قابلة للتكرار من كائنات `huggingface_hub.hf_api.PaperInfo`.

قائمة الأوراق اليومية على Hugging Face Hub بناءً على استعلام بحث.

مثال:

```python
>>> from huggingface_hub import HfApi

>>> api = HfApi()

# List all papers with "attention" in their title
>>> api.list_papers(query="attention")
```

#### list_pending_access_requests[[huggingface_hub.HfApi.list_pending_access_requests]]

```python
list_pending_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10608)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي تريد الحصول على طلبات الوصول إليه.

repo_type (`str`, *اختياري*) : نوع المستودع الذي تريد الحصول على طلبات الوصول له. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[AccessRequest]`

قابلة للتكرار من كائنات `AccessRequest`. يحتوي كل عنصر على سمات `username` و`request_id` و`email` و`status` و`timestamp`. إذا كان المستودع المحمي يحتوي على نموذج مخصص، فسيتم ملء سمة `fields` بإجابات المستخدم.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.

احصل على طلبات الوصول المعلّقة لمستودع محكوم الوصول معيّن.

تعني الطلب المعلّق أن المستخدم قد طلب الوصول إلى المستودع لكن الطلب لم تتم معالجته بعد. إذا كان وضع الموافقة تلقائيًا، فيجب أن تكون هذه القائمة فارغة. يمكن قبول الطلبات المعلّقة أو رفضها باستخدام [accept_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) و [reject_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.reject_access_request).

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

مثال:
```py
>>> from huggingface_hub import list_pending_access_requests, accept_access_request

# List pending requests
>>> requests = list(list_pending_access_requests("meta-llama/Llama-2-7b"))
>>> len(requests)
411
>>> requests[0]
[
    AccessRequest(
        username='clem',
        request_id='655f3a1c9e6b2d4f8a7c1e05',
        fullname='Clem 🤗',
        email='***',
        timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
        status='pending',
        fields=None,
    ),
    ...
]

# Accept Clem's request
>>> accept_access_request("meta-llama/Llama-2-7b", "clem")
```

#### list_rejected_access_requests[[huggingface_hub.HfApi.list_rejected_access_requests]]

```python
list_rejected_access_requests(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10736)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي تريد الحصول على طلبات الوصول إليه.

repo_type (`str`, *اختياري*) : نوع المستودع الذي تريد الحصول على طلبات الوصول له. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[AccessRequest]`

قابلة للتكرار من كائنات `AccessRequest`. يحتوي كل عنصر على سمات `username` و`request_id` و`email` و`status` و`timestamp`. إذا كان المستودع المحمي يحتوي على نموذج مخصص، فسيتم ملء سمة `fields` بإجابات المستخدم.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.

احصل على طلبات الوصول المرفوضة المستلمة لمتخزن محدد محمي.

تعني طلب مرفوض أن المستخدم قد طلب الوصول إلى المستودع وتم رفض الطلب صراحةً من قِبل مالك المستودع (سواء كنتَ أنت أو مستخدمًا آخر من مؤسستك). لا يمكن للمستخدم تنزيل أي ملف من المستودع. يمكن قبول الطلبات المرفوضة أو إلغاؤها في أي وقت باستخدام [accept_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) و [cancel_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request). سيعود الطلب الملغى إلى قائمة الطلبات المعلّقة بينما سينتقل الطلب المقبول إلى قائمة الطلبات المقبولة.

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

مثال:
```py
>>> from huggingface_hub import list_rejected_access_requests

>>> requests = list(list_rejected_access_requests("meta-llama/Llama-2-7b"))
>>> len(requests)
411
>>> requests[0]
[
    AccessRequest(
        username='clem',
        request_id='655f3a1c9e6b2d4f8a7c1e05',
        fullname='Clem 🤗',
        email='***',
        timestamp=datetime.datetime(2023, 11, 23, 18, 4, 53, 828000, tzinfo=datetime.timezone.utc),
        status='rejected',
        fields=None,
    ),
    ...
]
```

#### list_repo_commits[[huggingface_hub.HfApi.list_repo_commits]]

```python
list_repo_commits(repo_id: str, repo_type: str | None = None, token: bool | str | None = None, revision: str | None = None, formatted: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4188)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند سرد الالتزامات من مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند السرد من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

formatted (`bool`) : ما إذا كان يجب إرجاع العنوان والوصف بتنسيق HTML للالتزامات. القيمة الافتراضية هي False.

**يعيد:** list[[GitCommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.GitCommitInfo)]

قائمة من الكائنات تحتوي على معلومات حول التسميات (commits) لمستودع على Hub.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يتم العثور على المراجعة (خطأ 404) في المستودع.

احصل على قائمة التزامات (commits) لإصدار (revision) معين في مستودع على Hub.

تُرتَّب الالتزامات حسب التاريخ (أحدث التزام أولاً).

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()

# Commits are sorted by date (last commit first)
>>> initial_commit = api.list_repo_commits("gpt2")[-1]

# Initial commit is always a system commit containing the `.gitattributes` file.
>>> initial_commit
GitCommitInfo(
    commit_id='9b865efde13a30c13e0a33e536cf3e4a5a9d71d8',
    authors=['system'],
    created_at=datetime.datetime(2019, 2, 18, 10, 36, 15, tzinfo=datetime.timezone.utc),
    title='initial commit',
    message='',
    formatted_title=None,
    formatted_message=None
)

# Create an empty branch by deriving from initial commit
>>> api.create_branch("gpt2", branch="new_empty_branch", revision=initial_commit.commit_id)
```

#### list_repo_files[[huggingface_hub.HfApi.list_repo_files]]

```python
list_repo_files(repo_id: str, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3834)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`، *اختياري*) : إصدار المستودع الذي سيتم منه جلب المعلومات.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `list[str]`

قائمة الملفات في مستودع معيّن.

احصل على قائمة الملفات في مستودع معيّن.

#### list_repo_likers[[huggingface_hub.HfApi.list_repo_likers]]

```python
list_repo_likers(repo_id: str, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3110)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم استرجاعه. مثال: `"user/my-cool-model"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

**يعيد:** `Iterable[User]`

قابلة للتكرار من كائنات [huggingface_hub.hf_api.User](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.User).

قائمة بجميع المستخدمين الذين أعجبوا بمستودع معين على hugging Face Hub.

انظر أيضًا إلى [list_liked_repos()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_liked_repos).

#### list_repo_refs[[huggingface_hub.HfApi.list_repo_refs]]

```python
list_repo_refs(repo_id: str, repo_type: str | None = None, include_pull_requests: bool = False, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4116)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` أو `"kernel"` عند سرد المراجع من مجموعة بيانات أو مساحة أو نواة، أو `None` أو `"model"` عند السرد من نموذج. القيمة الافتراضية هي `None`.

include_pull_requests (`bool`، *اختياري*) : ما إذا كان يجب تضمين مراجع من طلبات السحب في القائمة. القيمة الافتراضية هي `False`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [GitRefs](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.GitRefs)

كائن يحتوي على جميع المعلومات المتعلقة بالفروع والوسوم لمستودع على Hub.

احصل على قائمة مراجع مستودع معيّن (الوسوم والفروع معًا).

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> api.list_repo_refs("gpt2")
GitRefs(branches=[GitRefInfo(name='main', ref='refs/heads/main', target_commit='e7da7f221d5bf496a48136c0cd264e630fe9fcc8')], converts=[], tags=[])

>>> api.list_repo_refs("bigcode/the-stack", repo_type='dataset')
GitRefs(
    branches=[
        GitRefInfo(name='main', ref='refs/heads/main', target_commit='18edc1591d9ce72aa82f56c4431b3c969b210ae3'),
        GitRefInfo(name='v1.1.a1', ref='refs/heads/v1.1.a1', target_commit='f9826b862d1567f3822d3d25649b0d6d22ace714')
    ],
    converts=[],
    tags=[
        GitRefInfo(name='v1.0', ref='refs/tags/v1.0', target_commit='c37a8cd1e382064d8aced5e05543c5f7753834da')
    ]
)
```

#### list_repo_tree[[huggingface_hub.HfApi.list_repo_tree]]

```python
list_repo_tree(repo_id: str, path_in_repo: str | None = None, recursive: bool = False, expand: bool = False, revision: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3871)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

path_in_repo (`str`, *اختياري*) : المسار النسبي للشجرة (المجلد) في المستودع، على سبيل المثال: `"checkpoints/1fec34a/results"`. سيُستخدم المسار الجذري للشجرة (المجلد) للمستودع افتراضيًا.

recursive (`bool`، *اختياري*، الافتراضي `False`) : ما إذا كان سيتم سرد ملفات ومجلدات الشجرة بشكل تكراري.

expand (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان يجب جلب مزيد من المعلومات حول ملفات ومجلدات الشجرة (مثل آخر التزامن ونتائج فحص الأمان للملفات). هذه العملية أكثر تكلفة على الخادم، لذا تُعاد 50 نتيجة فقط لكل صفحة (بدلاً من 1000). بما أن ترقيم الصفحات مُنفَّذ في `huggingface_hub`، فإن الأمر شفاف بالنسبة لك باستثناء الوقت الذي يستغرقه الحصول على النتائج.

revision (`str`، *اختياري*) : المراجعة (revision) للمستودع الذي سيتم منه جلب الشجرة. القيمة الافتراضية هي الفرع `"main"`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم منه جلب الشجرة (`"model"`، `"dataset"`، `"space"` أو `"kernel"`). القيمة الافتراضية هي `"model"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[Union[RepoFile, RepoFolder]]`

معلومات حول ملفات ومجلدات الشجرة، على شكل قابل للتكرار من كائنات [RepoFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.RepoFile) و`RepoFolder`. لا يُكفَل ترتيب الملفات والمجلدات.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) أو `~utils.RemoteEntryNotFoundError`

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يتم العثور على المراجعة (خطأ 404) في المستودع.
- `~utils.RemoteEntryNotFoundError` -- إذا لم يكن الشجرة (المجلد) موجودًا (خطأ 404) في المستودع.

list الملفات والمجلدات في شجرة المستودع والحصول على معلومات عنها.

أمثلة:

احصل على معلومات عن شجرة المستودع.

```py
>>> from huggingface_hub import list_repo_tree
>>> repo_tree = list_repo_tree("lysandre/arxiv-nlp")
>>> repo_tree
<generator object HfApi.list_repo_tree at 0x7fa4088e1ac0>
>>> list(repo_tree)
[
    RepoFile(path='.gitattributes', size=391, blob_id='ae8c63daedbd4206d7d40126955d4e6ab1c80f8f', lfs=None, last_commit=None, security=None),
    RepoFile(path='README.md', size=391, blob_id='43bd404b159de6fba7c2f4d3264347668d43af25', lfs=None, last_commit=None, security=None),
    RepoFile(path='config.json', size=554, blob_id='2f9618c3a19b9a61add74f70bfb121335aeef666', lfs=None, last_commit=None, security=None),
    RepoFile(
        path='flax_model.msgpack', size=497764107, blob_id='8095a62ccb4d806da7666fcda07467e2d150218e',
        lfs={'size': 497764107, 'sha256': 'd88b0d6a6ff9c3f8151f9d3228f57092aaea997f09af009eefd7373a77b5abb9', 'pointer_size': 134}, last_commit=None, security=None
    ),
    RepoFile(path='merges.txt', size=456318, blob_id='226b0752cac7789c48f0cb3ec53eda48b7be36cc', lfs=None, last_commit=None, security=None),
    RepoFile(
        path='pytorch_model.bin', size=548123560, blob_id='64eaa9c526867e404b68f2c5d66fd78e27026523',
        lfs={'size': 548123560, 'sha256': '9be78edb5b928eba33aa88f431551348f7466ba9f5ef3daf1d552398722a5436', 'pointer_size': 134}, last_commit=None, security=None
    ),
    RepoFile(path='vocab.json', size=898669, blob_id='b00361fece0387ca34b4b8b8539ed830d644dbeb', lfs=None, last_commit=None, security=None)]
]
```

احصل على مزيد من المعلومات حول شجرة المستودع (آخر التزام ونتائج فحص أمان الملفات)

```py
>>> from huggingface_hub import list_repo_tree
>>> repo_tree = list_repo_tree("prompthero/openjourney-v4", expand=True)
>>> list(repo_tree)
[
    RepoFolder(
        path='feature_extractor',
        tree_id='aa536c4ea18073388b5b0bc791057a7296a00398',
        last_commit={
            'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
            'title': 'Upload diffusers weights (#48)',
            'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc)
        }
    ),
    RepoFolder(
        path='safety_checker',
        tree_id='65aef9d787e5557373fdf714d6c34d4fcdd70440',
        last_commit={
            'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
            'title': 'Upload diffusers weights (#48)',
            'date': datetime.datetime(2023, 3, 21, 9, 5, 27, tzinfo=datetime.timezone.utc)
        }
    ),
    RepoFile(
        path='model_index.json',
        size=582,
        blob_id='d3d7c1e8c3e78eeb1640b8e2041ee256e24c9ee1',
        lfs=None,
        last_commit={
            'oid': 'b195ed2d503f3eb29637050a886d77bd81d35f0e',
            'title': 'Fix deprecation warning by changing `CLIPFeatureExtractor` to `CLIPImageProcessor`. (#54)',
            'date': datetime.datetime(2023, 5, 15, 21, 41, 59, tzinfo=datetime.timezone.utc)
        },
        security={
            'safe': True,
            'av_scan': {'virusFound': False, 'virusNames': None},
            'pickle_import_scan': None
        }
    )
    ...
]
```

#### list_scheduled_jobs[[huggingface_hub.HfApi.list_scheduled_jobs]]

```python
list_scheduled_jobs(labels: dict[str, str] | None = None, timeout: int | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13236)

**المعاملات:**

labels (`dict[str, str]`، *اختياري*) : إرجاع مهام Jobs المجدولة فقط التي تحمل جميع التسميات `key=value` المحددة، على سبيل المثال `{"env": "prod", "team": "ml"}`.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

namespace (`str`، *اختياري*) : مساحة الاسم التي تُستخرج منها قائمة المهام. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** `list[ScheduledJobInfo]`

قائمة من كائنات `ScheduledJobInfo`.

قائمة مهام الحوسبة المجدولة على بنية Hugging Face التحتية.

#### list_space_templates[[huggingface_hub.HfApi.list_space_templates]]

```python
list_space_templates(token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4553)

**المعاملات:**

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `list[SpaceTemplate]`

قالبات Space المتاحة.

قائمة قوالب Space الرسمية المتاحة على Hub.

يمكن تمرير `repo_id` للقالب المُعاد (أو `name` المختصر الخاص به) كـ`space_template` إلى [HfApi.create_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_repo) لإنشاء مساحة جديدة من ذلك القالب.

مثال:
```py
>>> from huggingface_hub import list_space_templates
>>> templates = list_space_templates()
>>> templates[0]
SpaceTemplate(name='Streamlit', repo_id='streamlit/streamlit-template-space', sdk='docker', preferred_private=False)
```

#### list_spaces[[huggingface_hub.HfApi.list_spaces]]

```python
list_spaces(filter: str | Iterable[str] | None = None, author: str | None = None, search: str | None = None, datasets: str | Iterable[str] | None = None, models: str | Iterable[str] | None = None, linked: bool = False, sort: SpaceSort_T | None = None, limit: int | None = None, expand: list[ExpandSpaceProperty_T] | None = None, full: bool | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2779)

**المعاملات:**

filter (`str` أو `Iterable`، *اختياري*) : وسم نصي أو قائمة من الوسوم يمكن استخدامها لتحديد المساحات (Spaces) على Hub.

author (`str`، *اختياري*) : نص يحدد مؤلف المساحات المُعادَة.

search (`str`، *اختياري*) : نص سيُدرج في مساحات Spaces المُعادَة.

datasets (`str` أو `Iterable`، *اختياري*) : ما إذا كان يجب إرجاع المساحات التي تستخدم مجموعة بيانات. يمكن تمرير اسم مجموعة بيانات محددة كسلسلة نصية.

models (`str` أو `Iterable`، *اختياري*) : ما إذا كان يجب إرجاع المساحات (Spaces) التي تستخدم نموذجًا. يمكن تمرير اسم نموذج محدد كسلسلة نصية.

linked (`bool`، *اختياري*) : ما إذا كان يجب إرجاع المساحات التي تستخدم نموذجًا أو مجموعة بيانات.

sort (`SpaceSort_T`، *اختياري*) : المفتاح الذي يُستخدم لفرز المساحات الناتجة. القيم الممكنة هي "created_at" و"last_modified" و"likes" و"trending_score".

limit (`int`، *اختياري*) : الحد الأقصى لعدد مساحات العمل (Spaces) التي يتم جلبها. إذا تُركت هذه الخانة عند `None`، فسيتم جلب جميع مساحات العمل.

expand (`list[ExpandSpaceProperty_T]`، *اختياري*) : خصائص قائمة للإرجاع في الاستجابة. عند الاستخدام، لن تُرجع إلا الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `full`. القيم الممكنة هي `"author"`، `"cardData"`، `"datasets"`، `"disabled"`، `"lastModified"`، `"createdAt"`، `"likes"`، `"models"`، `"private"`، `"region"`، `"runtime"`، `"sdk"`، `"siblings"`، `"sha"`، `"subdomain"`، `"tags"`، `"trendingScore"`، `"usedStorage"`، `"visibility"`، و`"resourceGroup"`.

full (`bool`, *اختياري*) : ما إذا كان سيتم جلب جميع بيانات Spaces، بما في ذلك الحقول `last_modified` و`siblings` و`card_data`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[SpaceInfo]`

قابلة للتكرار من كائنات [huggingface_hub.hf_api.SpaceInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.SpaceInfo).

قائمة المساحات المستضافة على Huggingface Hub، مع مراعاة بعض عوامل التصفية.

#### list_spaces_hardware[[huggingface_hub.HfApi.list_spaces_hardware]]

```python
list_spaces_hardware(token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8265)

**يعيد:** `list[JobHardwareInfo]`

قائمة بتكوينات الأجهزة المتاحة.

قائمة خيارات الأجهزة المتاحة للمساحات.

مثال:

```python
>>> from huggingface_hub import list_spaces_hardware
>>> hardware_list = list_spaces_hardware()
>>> hardware_list[0]
JobHardwareInfo(name='cpu-basic', pretty_name='CPU Basic', cpu='2 vCPU', ram='16 GB', ...)
>>> hardware_list[0].name
'cpu-basic'
```

#### list_user_followers[[huggingface_hub.HfApi.list_user_followers]]

```python
list_user_followers(username: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11836)

**المعاملات:**

username (`str`) : اسم المستخدم الذي تريد الحصول على متابعيه.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[User]`

قائمة من كائنات [User](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.User) تمثل متابعي المستخدم.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` --  HTTP 404 إذا لم يوجد المستخدم على Hub.

احصل على قائمة متابعي مستخدم على Hub.

#### list_user_following[[huggingface_hub.HfApi.list_user_following]]

```python
list_user_following(username: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11864)

**المعاملات:**

username (`str`) : اسم المستخدم الذي تريد معرفة المستخدمين الذين يتابعهم.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[User]`

قائمة من كائنات [User](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.User) تمثل المستخدمين الذين يتابعهم المستخدم.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` --  HTTP 404 إذا لم يوجد المستخدم على Hub.

احصل على قائمة المستخدمين الذين يتابعهم مستخدم على Hub.

#### list_user_repos[[huggingface_hub.HfApi.list_user_repos]]

```python
list_user_repos(namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3070)

**المعاملات:**

namespace (`str`، *اختياري*) : اسم المنظمة. إذا لم يُقدَّم، تُدرَج المستودعات الخاصة بالمستخدم الموثَّق.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. الافتراضي هو المحفوظ محليًا.

**يعيد:** `Iterable[RepoStorageInfo]`

قائمة قابلة للتكرار من كائنات `RepoStorageInfo`.

list جميع المستودعات (النماذج، مجموعات البيانات، المساحات، الدلاء) لمستخدم أو منظمة مع معلومات التخزين.

يستخدم نقطة النهاية `/api/settings/repositories` للمستخدم المصادَق أو `/api/organizations/{namespace}/settings/repositories` لمنظمة.

مثال:
```python
>>> from huggingface_hub import list_user_repos

>>> repos = list(list_user_repos())
>>> repos[0]
RepoStorageInfo(id='username/my-model', type='model', ...)

>>> # List repos from an organization
>>> repos = list(list_user_repos(namespace="my-org"))
```

#### list_webhooks[[huggingface_hub.HfApi.list_webhooks]]

```python
list_webhooks(token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11129)

**المعاملات:**

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `list[WebhookInfo]`

قائمة كائنات معلومات خطاف الويب.

list_webhooks

مثال:
```python
>>> from huggingface_hub import list_webhooks
>>> webhooks = list_webhooks()
>>> len(webhooks)
2
>>> webhooks[0]
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    url="https://webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    secret="my-secret",
    domains=["repo", "discussion"],
    disabled=False,
)
```

#### merge_pull_request[[huggingface_hub.HfApi.merge_pull_request]]

```python
merge_pull_request(repo_id: str, discussion_num: int, token: bool | str | None = None, comment: str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7835)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

comment (`str`، *اختياري*) : تعليق اختياري للنشر مع تغيير الحالة.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [DiscussionStatusChange](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionStatusChange)

حدث تغيير الحالة

يدمج طلب سحب.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### model_info[[huggingface_hub.HfApi.model_info]]

```python
model_info(repo_id: str, revision: str | None = None, timeout: float | None = None, securityStatus: bool | None = None, files_metadata: bool = False, expand: list[ExpandModelProperty_T] | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3149)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`، *اختياري*) : إصدار مستودع النموذج الذي سيتم منه جلب المعلومات.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

securityStatus (`bool`، *اختياري*) : ما إذا كان سيتم استرداد حالة الأمان من مستودع النموذج أيضًا. ستُعاد حالة الأمان في حقل `security_repo_status`.

files_metadata (`bool`، *اختياري*) : ما إذا كان سيتم استرداد البيانات الوصفية للملفات في المستودع (الحجم، البيانات الوصفية لـ LFS، إلخ). القيمة الافتراضية هي `False`.

expand (`list[ExpandModelProperty_T]`، *اختياري*) : خصائص قائمة للإرجاع في الاستجابة. عند الاستخدام، لن تُرجع إلا الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `securityStatus` أو `files_metadata`. القيم الممكنة هي `"author"`، `"baseModels"`، `"cardData"`، `"childrenModelCount"`، `"config"`، `"createdAt"`، `"disabled"`، `"downloads"`، `"downloadsAllTime"`، `"evalResults"`، `"gated"`، `"gguf"`، `"inference"`، `"inferenceProviderMapping"`، `"lastModified"`، `"library_name"`، `"likes"`، `"mask_token"`، `"model-index"`، `"pipeline_tag"`، `"private"`، `"safetensors"`، `"sha"`، `"siblings"`، `"spaces"`، `"tags"`، `"transformersInfo"`، `"trendingScore"`، `"widgetData"`، `"usedStorage"`، و`"resourceGroup"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.ModelInfo)

معلومات مستودع النموذج.

احصل على معلومات حول نموذج محدد على huggingface.co

يمكن أن يكون النموذج خاصًا إذا مررت برمز مقبول أو كنت مسجّل الدخول.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه. - [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) إذا تعذّر العثور على الإصدار الذي سيتم التنزيل منه.

#### move_bucket[[huggingface_hub.HfApi.move_bucket]]

```python
move_bucket(from_id: str, to_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14204)

**المعاملات:**

from_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم دلو مفصولان بـ `/`. معرّف الدلو الأصلي (مثل `"username/my-bucket"`).

to_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم دلو مفصولان بـ `/`. المعرّف النهائي للدلّو (مثل `"username/new-bucket-name"` أو `"organization/my-bucket"`).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `BucketNotFoundError`

- `BucketNotFoundError` -- إذا تعذّر العثور على الدلو المصدر. قد يكون السبب عدم وجوده، أو كونه مضبوطًا على `private` ولا تملك صلاحية الوصول إليه.

نقل دلو من namespace1/repo_name1 إلى namespace2/repo_name2

لاحظ أن هناك قيودًا معينة. لمزيد من المعلومات حول نقل المستودعات، يرجى الاطلاع على https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo.

مثال:
```python
>>> from huggingface_hub import move_bucket

>>> # Rename a bucket within the same namespace
>>> move_bucket(from_id="username/old-name", to_id="username/new-name")

>>> # Transfer a bucket to an organization
>>> move_bucket(from_id="username/my-bucket", to_id="my-org/my-bucket")
```

#### move_repo[[huggingface_hub.HfApi.move_repo]]

```python
move_repo(from_id: str, to_id: str, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4923)

**المعاملات:**

from_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`. معرّف المستودع الأصلي.

to_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`. المعرّف النهائي للمستودع.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

نقل مستودع من namespace1/repo_name1 إلى namespace2/repo_name2

لاحظ أن هناك قيودًا معينة. لمزيد من المعلومات حول نقل المستودعات، يرجى الاطلاع على https://hf.co/docs/hub/repositories-settings#renaming-or-transferring-a-repo.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### paper_info[[huggingface_hub.HfApi.paper_info]]

```python
paper_info(id: str)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11943)

**المعاملات:**

id (`str`، **اختياري**) : معرّف ArXiv للورقة.

**يعيد:** `PaperInfo`

كائن `PaperInfo`.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 404 إذا لم يكن البحث موجودًا على Hub.

احصل على معلومات عن ورقة بحثية على الـ Hub.

#### parse_safetensors_file_metadata[[huggingface_hub.HfApi.parse_safetensors_file_metadata]]

```python
parse_safetensors_file_metadata(repo_id: str, filename: str, repo_type: str | None = None, revision: str | None = None, token: bool | str | None = None, timeout: float | None = 10)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6887)

**المعاملات:**

repo_id (`str`) : اسم مستخدم أو منظمة واسم مستودع مفصولان بـ `/`.

filename (`str`) : اسم الملف في المستودع.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كان الملف في مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كان في نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة الخاصة بـ git لجلب الملف منها. يمكن أن تكون اسم فرع، أو وسم، أو تجزئة commit. الافتراضي هو رأس فرع `"main"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

timeout (`float`، *اختياري*، القيمة الافتراضية 10) : عدد الثواني التي يجب انتظارها حتى يرسل الخادم البيانات قبل التوقف. اضبطها على `None` لتعطيل مهلة الانتظار (غير موصى به، إذ قد يؤدي اتصال متوقف إلى تعليق الاستدعاء بشكل غير محدود).

**يعيد:** `SafetensorsFileMetadata`

معلومات متعلقة بملف safetensors.

**يرفع:** `NotASafetensorsRepoError` أو `SafetensorsParsingError`

- `NotASafetensorsRepoError` -- إذا لم يكن المستودع مستودع safetensors، أي أنه لا يحتوي على ملف `model.safetensors` أو ملف `model.safetensors.index.json`.
- `SafetensorsParsingError` -- إذا تعذّر تحليل ترويسة ملف safetensors بشكل صحيح.

تحليل البيانات الوصفية من ملف safetensors على Hub.

لحل بيانات الوصف من جميع ملفات safetensors في المستودع دفعة واحدة، استخدم [get_safetensors_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata).

لمزيد من التفاصيل حول صيغة safetensors، راجع https://huggingface.co/docs/safetensors/index#format.

#### pause_inference_endpoint[[huggingface_hub.HfApi.pause_inference_endpoint]]

```python
pause_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9926)

**المعاملات:**

name (`str`) : اسم نقطة الاستدلال (Inference Endpoint) التي سيتم إيقافها مؤقتًا.

namespace (`str`، *اختياري*) : مساحة الاسم التي يقع فيها Inference Endpoint. الافتراضي هو المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة النهاية للاستدلال المتوقفة مؤقتًا.

إيقاف نقطة استنتاج مؤقتًا.

لن يتم فرض أي رسوم على نقطة استنتاج (Inference Endpoint) متوقفة مؤقتًا. يمكن استئنافها في أي وقت باستخدام [resume_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.resume_inference_endpoint). وهذا يختلف عن تصفير نقطة الاستنتاج باستخدام [scale_to_zero_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.scale_to_zero_inference_endpoint)، حيث يتم إعادة تشغيلها تلقائيًا عند إرسال طلب إليها.

للسهولة، يمكنك أيضاً إيقاف نقطة استنتاج مؤقتاً باستخدام [pause_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint).

#### pause_space[[huggingface_hub.HfApi.pause_space]]

```python
pause_space(repo_id: str, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8424)

**المعاملات:**

repo_id (`str`) : معرّف المساحة (Space) التي سيتم إيقافها مؤقتًا. مثال: `"Salesforce/BLIP2"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل الخاصة بمساحتك بما في ذلك `stage=PAUSED` والأجهزة المطلوبة.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) أو [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على مساحتك (خطأ 404). على الأرجح أن معرف المستودع repo_id خاطئ، أو أن مساحتك خاصة وأنت غير مصادق.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- 403 Forbidden: لا يمكن إيقاف مساحة مؤقتًا إلا من قِبل مالكها. إذا كنت ترغب في إدارة مساحة لا تملكها، فاطلب من المالك ذلك من خلال فتح نقاش، أو انسخ المساحة.
- [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- إذا كان مساحتك مساحة ثابتة. المساحات الثابتة تعمل دائمًا ولا تُفرض عليها أي رسوم. إذا كنت ترغب في إخفاء مساحة ثابتة، يمكنك تعيينها كخاصة.

أوقف مساحة عملك مؤقتًا.

يتوقف المساحة الموقوفة عن التنفيذ حتى يعيد مالكها تشغيلها يدويًا. وهذا يختلف عن حالة السكون التي تدخل فيها المساحات المجانية بعد 48 ساعة من عدم النشاط. لا تُحتسب مدة الإيقاف في حسابك بغض النظر عن العتاد الذي اخترته. لإعادة تشغيل مساحتك، استخدم [restart_space()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.restart_space) وانتقل إلى صفحة إعدادات مساحتك.

لمزيد من التفاصيل، يرجى زيارة [التوثيق](https://huggingface.co/docs/hub/spaces-gpus#pause).

#### permanently_delete_lfs_files[[huggingface_hub.HfApi.permanently_delete_lfs_files]]

```python
permanently_delete_lfs_files(repo_id: str, lfs_files: Iterable[LFSFileInfo], rewrite_history: bool = True, repo_type: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4485)

**المعاملات:**

repo_id (`str`) : المستودع الذي تُدرج ملفات LFS الخاصة به.

lfs_files (`Iterable[LFSFileInfo]`) : قابل للتكرار من عناصر `LFSFileInfo` لحذفها نهائيًا من المستودع. استخدم [list_lfs_files()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_lfs_files) لعرض جميع ملفات LFS من مستودع.

rewrite_history (`bool`، *اختياري*، الافتراضي `True`) : ما إذا كان يجب إعادة كتابة سجل المستودع لإزالة مؤشرات الملفات التي تشير إلى ملفات LFS المحذوفة (موصى به).

repo_type (`str`, *اختياري*) : نوع المستودع. اضبطه على `"dataset"` أو `"space"` عند الإدراج من مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الإدراج من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

احذف ملفات LFS بشكل دائم من مستودع على Hub.

> [!WARNING]
> هذا إجراء دائم سيؤثر على جميع الالتزامات التي تشير إلى الملفات المحذوفة وقد يُتلف مستودعك. هذه عملية غير قابلة للتراجع. استخدمها فقط إذا كنت تعرف ما تفعله.

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> lfs_files = api.list_lfs_files("username/my-cool-repo")

# Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`.
# e.g. select only LFS files in the "checkpoints" folder
>>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/"))

# Permanently delete LFS files
>>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete)
```

#### preupload_lfs_files[[huggingface_hub.HfApi.preupload_lfs_files]]

```python
preupload_lfs_files(repo_id: str, additions: Iterable[CommitOperationAdd], token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, num_threads: int = 5, free_memory: bool = True, gitignore_content: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L5316)

**المعاملات:**

repo_id (`str`) : المستودع الذي ستُحدِّث فيه الملفات، على سبيل المثال: `"username/custom_transformers"`.

additions (`Iterable` من [CommitOperationAdd](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitOperationAdd)) : قائمة الملفات التي سيتم رفعها. تحذير: سيتم تعديل الكائنات الموجودة في هذه القائمة لإدراج معلومات تتعلق بالرفع. لا تعِد استخدام الكائنات نفسها لعمليات التزامن المتعددة.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم الرفع إليه (مثلًا `"model"` -الافتراضي-، `"dataset"`، `"space"` أو `"kernel"`).

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

create_pr (`boolean`، *اختياري*) : ما إذا كنت تخطط لإنشاء طلب سحب (Pull Request) بهذا الالتزام. القيمة الافتراضية هي `False`.

num_threads (`int`, *اختياري*) : عدد الخيوط المتزامنة لرفع الملفات. القيمة الافتراضية هي 5. ضبطها على 2 يعني أن أقصى عدد من الملفات التي يمكن رفعها بالتزامن هو 2.

free_memory (`bool`، *اختياري*، القيمة الافتراضية `True`) : إذا كانت `True`، يتم استبدال خاصية `path_or_fileobj` لكل `CommitOperationAdd` بكائن `bytes` فارغ بعد الرفع لتوفير الذاكرة. اضبطها على `False` إذا كنت بحاجة إلى إعادة استخدام كائنات العملية خارج استدعاء [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit) اللاحق.

gitignore_content (`str`, *اختياري*) : محتوى ملف `.gitignore` لمعرفة الملفات التي يجب تجاهلها. ترتيب الأولوية هو أولاً التحقق مما إذا تم تمرير `gitignore_content`، ثم التحقق مما إذا كان ملف `.gitignore` موجوداً في قائمة الملفات المراد التثبيت، وأخيراً افتراض استخدام ملف `.gitignore` المضيف مسبقاً على Hub (إن وُجد).

ارفع ملفات LFS إلى S3 مسبقًا استعدادًا لالتزام مستقبلي.

تُعدّ هذه الطريقة مفيدة إذا كنتَ تولّد الملفات للرفع على الفور ولا تريد تخزينها في الذاكرة قبل رفعها دفعةً واحدة.

> [!WARNING]
> هذه طريقة مخصصة للمستخدمين المتقدمين. لا ينبغي أن تحتاج إلى استدعائها مباشرةً لإنشاء التزام (commit) عادي. استخدم [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit) مباشرةً بدلاً من ذلك.

> [!WARNING]
> ستتغير عمليات الالتزام أثناء العملية. على وجه الخصوص، سيتم حذف `path_or_fileobj` المرفق بعد الرفع لتوفير الذاكرة (ويعوّض بموضوع `bytes` فارغ). لا تعِد استخدام نفس المواضيع إلا لتسليمها إلى [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit). إذا كنت لا تريد إزالة المحتوى المرفق من موضوع عملية الالتزام، فمرّر `free_memory=False`.

مثال:
```py
>>> from huggingface_hub import CommitOperationAdd, preupload_lfs_files, create_commit, create_repo

>>> repo_id = create_repo("test_preupload").repo_id

# Generate and preupload LFS files one by one
>>> operations = [] # List of all `CommitOperationAdd` objects that will be generated
>>> for i in range(5):
...     content = ... # generate binary content
...     addition = CommitOperationAdd(path_in_repo=f"shard_{i}_of_5.bin", path_or_fileobj=content)
...     preupload_lfs_files(repo_id, additions=[addition]) # upload + free memory
...     operations.append(addition)

# Create commit
>>> create_commit(repo_id, operations=operations, commit_message="Commit all shards")
```

#### read_paper[[huggingface_hub.HfApi.read_paper]]

```python
read_paper(id: str)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11963)

**المعاملات:**

id (`str`) : معرّف ArXiv للورقة.

**يعيد:** `str`

محتوى صفحة الورقة البحثية بصيغة Markdown.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 404 إذا لم يكن البحث موجودًا على Hub.

احصل على محتوى صفحة ورقة بحثية بصيغة Markdown على Hub.

#### reject_access_request[[huggingface_hub.HfApi.reject_access_request]]

```python
reject_access_request(repo_id: str, user: str | None = None, request_id: str | None = None, repo_type: str | None = None, rejection_reason: str | None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10929)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي تريد رفض طلب الوصول إليه.

user (`str`، *اختياري*) : اسم المستخدم الذي يجب رفض طلب الوصول الخاص به. يجب تقديم بالضبط واحد من `user` أو `request_id`.

request_id (`str`, *اختياري*) : المعرّف الخاص بطلب الوصول الذي سيتم رفضه (انظر `AccessRequest`). مطلوب عندما يتم تكوين المستودع بحيث لا يتم مشاركة أسماء المستخدمين للمقدمين. يجب تقديم بالضبط واحد من `user` أو `request_id`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم رفض طلب الوصول إليه. يجب أن يكون أحد `model` أو `dataset` أو `space`. القيمة الافتراضية هي `model`.

rejection_reason (`str`، *اختياري*) : سبب الرفض الاختياري الذي سيظهر للمستخدم (بحد أقصى 200 حرف).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `HfHubHTTPError`

- `HfHubHTTPError` -- خطأ HTTP 400 إذا لم يكن المستودع محميًا.
- `HfHubHTTPError` -- خطأ HTTP 403 إذا كان لديك وصول للقراءة فقط إلى المستودع. قد يحدث ذلك إذا لم تكن لديك دور `write` أو `admin` في المنظمة التي ينتمي إليها المستودع، أو إذا قمت بتمرير رمز `read`.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا لم يكن المستخدم موجودًا على Hub.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا تعذّر العثور على طلب وصول المستخدم.
- `HfHubHTTPError` -- خطأ HTTP 404 إذا كان طلب وصول المستخدم موجودًا بالفعل في قائمة المرفوضين.

رفض طلب وصول من مستخدم لمتخزن محكوم محدد.

تُحوَّل أي طلب مرفوض إلى قائمة المرفوضين. ولا يستطيع المستخدم تنزيل أي ملف من المستودع. يمكن قبول الطلبات المرفوضة أو إلغاؤها في أي وقت باستخدام [accept_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.accept_access_request) و [cancel_access_request()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.cancel_access_request). يعود الطلب الملغى إلى قائمة قيد الانتظار، بينما ينتقل الطلب المقبول إلى قائمة المقبولين.

لمزيد من المعلومات حول المستودعات المُقيَّدة، راجع https://huggingface.co/docs/hub/models-gated.

#### rename_discussion[[huggingface_hub.HfApi.rename_discussion]]

```python
rename_discussion(repo_id: str, discussion_num: int, new_title: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L7694)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

discussion_num (`int`) : رقم المناقشة أو طلب الدمج. يجب أن يكون عددًا صحيحًا موجبًا تمامًا.

new_title (`str`) : العنوان الجديد للنقاش

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند الرفع إلى مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [DiscussionTitleChange](/docs/huggingface_hub/main/ar/package_reference/community#huggingface_hub.DiscussionTitleChange)

حدث تغيير العنوان

يُعيد تسمية نقاش.

أمثلة:
```python
>>> new_title = "New title, fixing a typo"
>>> HfApi().rename_discussion(
...     repo_id="username/repo_name",
...     discussion_num=34,
...     new_title=new_title
... )
# DiscussionTitleChange(id='deadbeef0000000', type='title-change', ...)

```

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. وقد يكون السبب في ذلك عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه.

#### repo_exists[[huggingface_hub.HfApi.repo_exists]]

```python
repo_exists(repo_id: str, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3682)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تستخرج معلومات المستودع من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تستخرج معلومات المستودع من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:**

صحيح إذا كان المستودع موجودًا، وإلا فخطأ.

يتحقق من وجود مستودع على Hugging Face Hub.

أمثلة:
```py
>>> from huggingface_hub import repo_exists
>>> repo_exists("google/gemma-7b")
True
>>> repo_exists("google/not-a-repo")
False
```

#### repo_info[[huggingface_hub.HfApi.repo_info]]

```python
repo_info(repo_id: str, revision: str | None = None, repo_type: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: ExpandModelProperty_T | ExpandDatasetProperty_T | ExpandSpaceProperty_T | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3474)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`، *اختياري*) : إصدار المستودع الذي سيتم منه جلب المعلومات.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تستخرج معلومات المستودع من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تستخرج معلومات المستودع من نموذج. القيمة الافتراضية هي `None`.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

expand (`ExpandModelProperty_T` أو `ExpandDatasetProperty_T` أو `ExpandSpaceProperty_T`، *اختياري*) : قائمة بالخصائص التي يجب إرجاعها في الاستجابة. عند استخدامه، لن تُرجع إلا الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `files_metadata`. للحصول على قائمة شاملة بالخصائص المتاحة، راجع [model_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.model_info) أو [dataset_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) أو [space_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.space_info).

files_metadata (`bool`، *اختياري*) : ما إذا كان سيتم استرداد البيانات الوصفية للملفات في المستودع (الحجم، البيانات الوصفية لـ LFS، إلخ). القيمة الافتراضية هي `False`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Union[SpaceInfo, DatasetInfo, ModelInfo]`

معلومات المستودع، كائن من نوع [huggingface_hub.hf_api.DatasetInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DatasetInfo) أو [huggingface_hub.hf_api.ModelInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.ModelInfo) أو [huggingface_hub.hf_api.SpaceInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.SpaceInfo).

احصل على كائن المعلومات لمستودع معيّن من نوع معيّن.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه. - [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) إذا تعذّر العثور على الإصدار الذي سيتم التنزيل منه.

#### request_space_hardware[[huggingface_hub.HfApi.request_space_hardware]]

```python
request_space_hardware(repo_id: str, hardware: SpaceHardware, token: bool | str | None = None, sleep_time: int | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8328)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

hardware (`str` أو [SpaceHardware](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceHardware)) : العتاد الذي سيتم تشغيل المساحة عليه. مثال: `"t4-medium"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

sleep_time (`int`، *اختياري*) : عدد ثوانٍ من عدم النشاط التي يجب انتظارها قبل وضع مساحة في وضع السكون. اضبط القيمة على `-1` إذا كنت لا تريد لمساحتك أن تدخل في وضع السكون (وهو السلوك الافتراضي للأجهزة المُحدَّثة). أما بالنسبة للأجهزة المجانية، فلا يمكنك ضبط وقت السكون (القيمة ثابتة عند 48 ساعة من عدم النشاط). راجع https://huggingface.co/docs/hub/spaces-gpus#sleep-time لمزيد من التفاصيل.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل حول مساحة (Space) تتضمن مرحلة المساحة (Space stage) والأجهزة (hardware).

طلب أجهزة جديدة لمساحة.

> [!TIP]
> كما يمكن طلب العتاد مباشرةً عند إنشاء مستودع Space! راجع [create_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_repo) للتفاصيل.

#### rerun_job[[huggingface_hub.HfApi.rerun_job]]

```python
rerun_job(job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12733)

**المعاملات:**

job_id (`str`) : معرّف المهمة التي سيتم إعادة تشغيلها.

namespace (`str`، *اختياري*) : مساحة الاسم الخاصة بالمهمة. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول المستخدم. الافتراضي هو المحفوظ محليًا.

**يعيد:** [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo)

المهمة التي تم تشغيلها حديثاً.

شغّل مهمة جديدة باستخدام مواصفات المهمة الحالية، بما في ذلك إعدادات إعادة المحاولة والموارد.

#### resolve_revision[[huggingface_hub.HfApi.resolve_revision]]

```python
resolve_revision(repo_id: str, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_files_only: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3549)

**المعاملات:**

repo_id (`str`) : اسم مستخدم أو منظمة واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` أو `"kernel"` إذا كان المستودع مستودع بيانات أو مساحة أو نواة، أو على `None` أو `"model"` إذا كان نموذجًا. القيمة الافتراضية هي `None`.

revision (`str`, *اختياري*) : المراجعة التي سيتم حلها. يمكن أن تكون اسم فرع، أو وسم، أو مرجع طلب دمج، أو تجزئة التزام. الافتراضي هو الفرع الافتراضي. إذا تم تمرير [ResolvedRevision](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.ResolvedRevision)، يُعاد كما هو - ما لم يتم حله مقابل مستودع آخر، وفي هذه الحالة يتم حل المراجعة التي طُلبت في البداية مرة أخرى.

cache_dir (`str`، `Path`، *اختياري*) : المسار إلى المجلد الذي تُخزَّن فيه الملفات المؤقتة. القيمة الافتراضية هي قيمة `HF_HUB_CACHE`.

local_files_only (`bool`، *اختياري*، الافتراضي `False`) : إذا كان `True`، يتم تحديد الإصدار من ذاكرة التخزين المؤقت المحلية فقط، دون الاتصال بـ Hub.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [ResolvedRevision](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.ResolvedRevision)

فئة فرعية من `str` تحتفظ بكل من المراجعة المطلوبة والتجزئة (hash) للالتزام التي تُحلّ إليها.

**يرفع:** [RevisionResolutionError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionResolutionError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) أو [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [RevisionResolutionError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionResolutionError) -- إذا تعذّر تحديد المراجعة: تعذّر الوصول إلى Hub ولا يوجد أي شيء مخزّن محليًا.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يكن الإصدار موجودًا على Hub.
- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا تعذّر العثور على المستودع. قد يكون السبب عدم وجوده، أو كونه مضبوطًا على `private` ولا تملك صلاحية الوصول إليه.

حلّ نسخة (فرع، وسم، مرجع طلب دمج) إلى تجزئة التزام.

يُعدّ هذا الأمر مخصصًا للمكتبات التي تقوم بتنزيل وتحميل عدة مكوّنات من مستودع بشكل منفصل (الإعدادات، الأوزان، المُرمّز، ...). إن حلّ المراجعة مرة واحدة ثم تمرير [ResolvedRevision](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.ResolvedRevision) المُعاد يضمن أن كل استدعاء تالٍ يستهدف نفس الالتزام (commit) بالضبط، حتى لو تم تحديث المستودع في غضون ذلك. كما أنه يوفر استدعاءات HTTP، إذ يمكن تقديم التنزيلات المنجزة باستخدام تجزئة الالتزام (commit hash) من ذاكرة التخزين المؤقت المحلية دون الحاجة إلى التواصل مع Hub.

يتم تخزين إسناد `revision` -> `commit hash` على القرص (في مجلد `refs/` ضمن المجلد المؤقت) على أساس أفضل جهد ممكن. إذا تعذّر الوصول إلى Hub لاحقًا (وضع عدم الاتصال، خطأ في الاتصال، انتهاء المهلة، توقف Hub، ...)، يُستخدم القيمة المخزّنة مؤقتًا كحل بديل.

> [!TIP]
> إذا كنت بحاجة فقط إلى تنزيل لقطة كاملة للمستودع، فإن استدعاءً واحدًا لـ [snapshot_download()](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.snapshot_download) يكفي وهو بالفعل يقوم بالعمل الصحيح. أما `resolve_revision` فهو مفيد فقط عند تنزيل الملفات بشكل منفصل.

مثال:
```py
>>> from huggingface_hub import hf_hub_download, resolve_revision
>>> revision = resolve_revision("openai-community/gpt2")
>>> revision
ResolvedRevision(initial=None, resolved='607a30d783dfa663caf39e06633721c8d4cfcd7e')

# Pass it around: every download is pinned to the same commit
>>> config = hf_hub_download("openai-community/gpt2", "config.json", revision=revision)
>>> weights = hf_hub_download("openai-community/gpt2", "model.safetensors", revision=revision)
```

#### restart_space[[huggingface_hub.HfApi.restart_space]]

```python
restart_space(repo_id: str, token: bool | str | None = None, factory_reboot: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8547)

**المعاملات:**

repo_id (`str`) : معرّف المساحة (Space) التي تريد إعادة تشغيلها. مثال: `"Salesforce/BLIP2"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

factory_reboot (`bool`، *اختياري*) : إذا كان `True`، فسيتم إعادة بناء المساحة من الصفر دون تخزين أي متطلبات مؤقتًا.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل الخاصة بمساحتك.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) أو [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على مساحتك (خطأ 404). على الأرجح أن معرف المستودع repo_id خاطئ، أو أن مساحتك خاصة وأنت غير مصادق.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) --  403 Forbidden: لا يمكن إعادة تشغيل مساحة إلا من قِبل مالكها. إذا كنت ترغب في إعادة تشغيل مساحة لا تملكها، فاطلب من المالك ذلك من خلال فتح نقاش، أو انسخ مساحة جديدة.
- [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- إذا كان مساحتك مساحة ثابتة. المساحات الثابتة تعمل دائمًا ولا تُفرض عليها أي رسوم. إذا كنت ترغب في إخفاء مساحة ثابتة، يمكنك تعيينها كخاصة.

أعد تشغيل مساحة عملك.

هذا هو الطريقة الوحيدة لإعادة تشغيل مساحة برمجياً إذا كنت قد وضعتها في وضع الإيقاف المؤقت (انظر [pause_space()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.pause_space)). يجب أن تكون مالك المساحة لإعادة تشغيلها. إذا كنت تستخدم عتاداً مُحدَّثاً، فسيتم احتساب الرسوم على حسابك بمجرد إعادة تشغيل المساحة. يمكنك تفعيل إعادة التشغيل بغض النظر عن الحالة الحالية للمساحة.

لمزيد من التفاصيل، يرجى زيارة [التوثيق](https://huggingface.co/docs/hub/spaces-gpus#pause).

#### resume_inference_endpoint[[huggingface_hub.HfApi.resume_inference_endpoint]]

```python
resume_inference_endpoint(name: str, namespace: str | None = None, running_ok: bool = True, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9961)

**المعاملات:**

name (`str`) : اسم نقطة الاستدلال (Inference Endpoint) التي سيتم استئنافها.

namespace (`str`، *اختياري*) : مساحة الاسم التي يقع فيها Inference Endpoint. الافتراضي هو المستخدم الحالي.

running_ok (`bool`, *اختياري*) : إذا كان `True`، فلن تطلق الطريقة خطأً إذا كان نقطة الاستدلال (Inference Endpoint) قيد التشغيل بالفعل. القيمة الافتراضية هي `True`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة الاستدلال (Inference Endpoint) المُستأنفة.

استئناف نقطة نهاية الاستدلال.

للسهولة، يمكنك أيضًا استئناف نقطة استنتاج باستخدام [InferenceEndpoint.resume()](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.resume).

#### resume_scheduled_job[[huggingface_hub.HfApi.resume_scheduled_job]]

```python
resume_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13389)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Resume (إلغاء إيقاف) مهمة حساب مجدولة على بنية Hugging Face التحتية.

#### revision_exists[[huggingface_hub.HfApi.revision_exists]]

```python
revision_exists(repo_id: str, revision: str, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3726)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`) : نسخة المستودع التي يجب التحقق منها.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنت تستخرج معلومات المستودع من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنت تستخرج معلومات المستودع من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:**

صحيح إذا كان المستودع والمراجعة موجودين، وإلا فخطأ.

يتحقق مما إذا كان هناك إصدار محدد موجود في مستودع على Hugging Face Hub.

أمثلة:
```py
>>> from huggingface_hub import revision_exists
>>> revision_exists("google/gemma-7b", "float16")
True
>>> revision_exists("google/gemma-7b", "not-a-revision")
False
```

#### run_as_future[[huggingface_hub.HfApi.run_as_future]]

```python
run_as_future(fn: Callable[..., R], *args, **kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2183)

**المعاملات:**

fn (`Callable`) : الطريقة التي سيتم تشغيلها في الخلفية.

- ***args,** **kwargs : الحُجج التي سيتم استدعاء الدالة بها.

**يعيد:** `Future`

مثال من [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects) للحصول على نتيجة المهمة.

تشغيل طريقة في الخلفية وإرجاع كائن Future.

الهدف الرئيسي هو تنفيذ الطرق دون تعطيل الخيط الرئيسي (مثلًا، لدفع البيانات أثناء التدريب). تُصفَّف المهام في الخلفية للحفاظ على الترتيب، لكنها لا تُنفَّذ بالتوازي. إذا كنت بحاجة إلى تسريع سكربتاتك عن طريق موازاة عدد كبير من الاستدعاءات إلى واجهة برمجة التطبيقات، فيجب عليك إعداد واستخدام [ThreadPoolExecutor](https://docs.python.org/3/library/concurrent.futures.html#threadpoolexecutor) خاص بك.

ملاحظة: تتضمن الطرق الأكثر استخدامًا مثل [upload_file()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.upload_file) و[upload_folder()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.upload_folder) و[create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit) معاملًا باسم `run_as_future: bool` يتيح استدعاءها مباشرةً في الخلفية. وهذا يعادل استدعاء `api.run_as_future(...)` عليها، لكنه أقل حشوًا.

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> future = api.run_as_future(api.whoami) # instant
>>> future.done()
False
>>> future.result() # wait until complete and return result
(...)
>>> future.done()
True
```

#### run_job[[huggingface_hub.HfApi.run_job]]

```python
run_job(image: str, command: list[str], env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, ssh: bool = False, network_group: str | None = None, network_aliases: list[str] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12127)

**المعاملات:**

image (`str`) : صورة Docker التي سيتم استخدامها. أمثلة: `"ubuntu"`، `"python:3.12"`، `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`. مثال باستخدام صورة من Space: `"hf.co/spaces/lhoestq/duckdb"`.

command (`list[str]`) : الأمر الذي سيتم تنفيذه. مثال: `["echo", "hello"]`.

env (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة الخاصة بالمهمة.

secrets (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة السرية للعمل.

flavor (`str`، *اختياري*) : نوع العتاد. راجع `JobHardware` لمعرفة القيم الممكنة. القيمة الافتراضية هي `"cpu-basic"`.

timeout (`Union[int, float, str]`، *اختياري*) : الحد الأقصى لمدة المهمة: int مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام). مثال: `300` أو `"5m"` لمدة 5 دقائق.

attempts (`int`، *اختياري*) : الحد الأقصى لعدد المحاولات، بما في ذلك التشغيل الأولي. القيمة الافتراضية هي 1. على سبيل المثال، يعيد 3 محاولة تشغيل مهمة فاشلة حتى مرتين.

name (`str`, *اختياري*) : اسم للوظيفة. يُخزَّن كوسم `name`. لا يمكن تمريره مع مفتاح `name` ضمن `labels`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم مشتق من الصورة والأمر (مع لاحقة تجزئة قصيرة).

labels (`dict[str, str]`، *اختياري*) : التسميات التي سيتم إرفاقها بالمهمة (أزواج مفتاح-قيمة).

volumes (`list[Volume]`، *اختياري*) : دلاء أو مستودعات Hugging Face لتثبيتها كمجلدات في حاوية المهمة. كل مجلد هو [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) مع `type` (`"bucket"`، `"model"`، `"dataset"`، أو `"space"`)، و`source` (مثل `"username/my-bucket"`)، و`mount_path` (مثل `"/data"`).

expose (`list[int]`، *اختياري*) : منصات الحاوية التي يجب كشفها عبر وكيل المهام. كل منصة مدرجة يمكن الوصول إليها عبر نطاق المهام العام (مثل `https://<job_id>--8000.hf.jobs`). يتطلب الوصول دائمًا رمز HF مع صلاحية القراءة في مساحة أسماء المهمة. استخدم `expose_public` للوصول دون مصادقة.

expose_public (`list[int]`، *اختياري*) : المنافذ التي يجب كشفها عبر وكيل Jobs دون مصادقة. لا يلزم إدراجها في `expose`.

ssh (`bool`, *اختياري*) : إذا كانت القيمة True، يمكن الوصول إلى حاوية المهمة عبر SSH على العنوان المحدد بواسطة `job.status.ssh_url` (مثل `ssh <job_id>@ssh.hf.jobs`، أو `hf jobs ssh <job_id>` من سطر الأوامر). يتطلب الاتصال صلاحية الكتابة في مساحة أسماء المهمة ومفتاح SSH عام مسجّل على Hub (https://huggingface.co/settings/keys). القيمة الافتراضية هي False.

network_group (`str`, *اختياري*) : اسم مجموعة الشبكة التي سيتم الانضمام إليها. تُجمع المهام الموجودة في نفس مساحة الاسم ومجموعة الموارد والتي تشترك في مجموعة واحدة معًا، ويمكنها الوصول إلى بعضها البعض على كل منفذ. داخل كل عضو، يُحل `HF_NETWORK_GROUP_HOSTNAME` إلى كل عضو في المجموعة. أحرف صغيرة وأرقام وشرطات، بحد أقصى 46 حرفًا.

network_aliases (`list[str]`، *اختياري*) : المستعarentات التي يدّعيها هذا العمل في مجموعته الشبكية. تصل الأعضاء إلى الأعمال التي تدّعي مستعارًا عند `${HF_NETWORK_GROUP_PREFIX}<alias>`. قد تدّعي عدة أعمال المستعار نفسه. أحرف صغيرة وأرقام وشرطات، بحد أقصى 34 حرفًا، فريد ضمن العمل. يتطلب `network_group`.

resource_group_id (`str`, *اختياري*) : المعرّف لمجموعة الموارد التي سيتم إنشاء المهمة (Job) فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق. إذا لم يُقدَّم، تُنشأ المهمة خارج أي مجموعة موارد.

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها إنشاء المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

شغّل مهام الحساب على بنية Hugging Face التحتية.

مثال:

شغّل أول مهمة لك:

```python
>>> from huggingface_hub import run_job
>>> run_job(image="python:3.12", command=["python", "-c" ,"print('Hello from HF compute!')"])
```

تشغيل مهمة وحدة معالجة رسومية:

```python
>>> from huggingface_hub import run_job
>>> image = "pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"
>>> command = ["python", "-c", "import torch; print(f'This code ran with the following GPU: {torch.cuda.get_device_name()}')"]
>>> run_job(image=image, command=command, flavor="a10g-small")
```

تشغيل مهمة مع أحجام:

```python
>>> from huggingface_hub import Volume, run_job
>>> dataset_volume = Volume(type="dataset", source="HuggingFaceFW/fineweb", mount_path="/data")
>>> output_bucket_volume = Volume(type="bucket", source="username/my-bucket", mount_path="/output")
>>> image = "duckdb/duckdb"
>>> command = ["duckdb", "-c", "COPY (SELECT * FROM '/data/**/*.parquet' LIMIT 5) TO '/output/first-rows.parquet'"]
>>> run_job(image=image, command=command, volumes=[dataset_volume, output_bucket_volume])
```

#### run_uv_job[[huggingface_hub.HfApi.run_uv_job]]

```python
run_uv_job(script: str, script_args: list[str] | None = None, dependencies: list[str] | None = None, python: str | None = None, image: str | None = None, env: dict[str, Any] | None = None, secrets: dict[str, Any] | None = None, flavor: JobHardware | str | None = None, timeout: int | float | str | None = None, attempts: int | None = None, name: str | None = None, labels: dict[str, str] | None = None, volumes: list[Volume] | None = None, expose: list[int] | None = None, expose_public: list[int] | None = None, ssh: bool = False, network_group: str | None = None, network_aliases: list[str] | None = None, resource_group_id: str | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12876)

**المعاملات:**

script (`str`) : مسار أو عنوان URL لسكربت UV، أو أمر.

script_args (`list[str]`، *اختياري*) : الحُجج المراد تمريرها إلى السكربت أو الأمر.

dependencies (`list[str]`، *اختياري*) : التبعيات المستخدمة لتشغيل سكربت UV.

python (`str`، *اختياري*) : استخدم إصدارًا محددًا من بايثون. الافتراضي هو 3.12.

image (`str`، *اختياري*، القيمة الافتراضية هي "ghcr.io/astral-sh/uv --python3.12-bookworm"): استخدم صورة Docker مخصصة مع تثبيت `uv`.

env (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة الخاصة بالمهمة.

secrets (`dict[str, Any]`، *اختياري*) : يحدد متغيرات البيئة السرية للعمل.

flavor (`str`، *اختياري*) : نوع العتاد. راجع `JobHardware` لمعرفة القيم الممكنة. القيمة الافتراضية هي `"cpu-basic"`.

timeout (`Union[int, float, str]`، *اختياري*) : الحد الأقصى لمدة المهمة: int مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام). مثال: `300` أو `"5m"` لمدة 5 دقائق.

attempts (`int`، *اختياري*) : الحد الأقصى لعدد المحاولات، بما في ذلك التشغيل الأولي. القيمة الافتراضية هي 1.

name (`str`, *اختياري*) : اسم للوظيفة. يُخزَّن كوسم `name`. لا يمكن تمريره مع مفتاح `name` ضمن `labels`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم مشتق من السكربت وحوامله (مع لاحقة تجزئة قصيرة).

labels (`dict[str, str]`، *اختياري*) : التسميات التي سيتم إرفاقها بالمهمة (أزواج مفتاح-قيمة).

volumes (`list[Volume]`، *اختياري*) : دلاء أو مستودعات Hugging Face لتثبيتها كمجلدات في حاوية المهمة. كل مجلد هو [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) مع `type` (`"bucket"`، `"model"`، `"dataset"`، أو `"space"`)، و`source` (مثل `"username/my-bucket"`)، و`mount_path` (مثل `"/data"`).

expose (`list[int]`، *اختياري*) : منصات الحاوية التي يجب كشفها عبر وكيل المهام. كل منصة مدرجة يمكن الوصول إليها عبر نطاق المهام العام (مثل `https://<job_id>--8000.hf.jobs`). يتطلب الوصول دائمًا رمز HF مع صلاحية القراءة في مساحة أسماء المهمة. استخدم `expose_public` للوصول دون مصادقة.

expose_public (`list[int]`، *اختياري*) : المنافذ التي يجب كشفها عبر وكيل Jobs دون مصادقة. لا يلزم إدراجها في `expose`.

ssh (`bool`, *اختياري*) : إذا كانت القيمة True، يمكن الوصول إلى حاوية المهمة عبر SSH على العنوان المحدد بواسطة `job.status.ssh_url` (مثل `ssh <job_id>@ssh.hf.jobs`، أو `hf jobs ssh <job_id>` من سطر الأوامر). يتطلب الاتصال صلاحية الكتابة في مساحة أسماء المهمة ومفتاح SSH عام مسجّل على Hub (https://huggingface.co/settings/keys). القيمة الافتراضية هي False.

network_group (`str`, *اختياري*) : اسم مجموعة الشبكة التي سيتم الانضمام إليها. تُجمع المهام الموجودة في نفس مساحة الاسم ومجموعة الموارد والتي تشترك في مجموعة واحدة معًا، ويمكنها الوصول إلى بعضها البعض على كل منفذ. داخل كل عضو، يُحل `HF_NETWORK_GROUP_HOSTNAME` إلى كل عضو في المجموعة. أحرف صغيرة وأرقام وشرطات، بحد أقصى 46 حرفًا.

network_aliases (`list[str]`، *اختياري*) : المستعarentات التي يدّعيها هذا العمل في مجموعته الشبكية. تصل الأعضاء إلى الأعمال التي تدّعي مستعارًا عند `${HF_NETWORK_GROUP_PREFIX}<alias>`. قد تدّعي عدة أعمال المستعار نفسه. أحرف صغيرة وأرقام وشرطات، بحد أقصى 34 حرفًا، فريد ضمن العمل. يتطلب `network_group`.

resource_group_id (`str`, *اختياري*) : المعرّف لمجموعة الموارد التي سيتم إنشاء المهمة (Job) فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق. إذا لم يُقدَّم، تُنشأ المهمة خارج أي مجموعة موارد.

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها إنشاء المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

شغّل مهمة سكربت UV على بنية Hugging Face التحتية.

> [!WARNING]
> على عكس `hf jobs uv run`، يتجاهل هذا الأسلوب الجدول الاختياري `[tool.hf-jobs]` الذي يمكن أن يحمله سكربت UV في ترويسة PEP 723 الخاصة به (انظر [دليل الوظائف](../guides/jobs#ship-the-launch-config-with-the-script)): يجب تمرير إعداد الإطلاق هنا بشكل صريح.

مثال:

تشغيل سكربت من عنوان URL:

```python
>>> from huggingface_hub import run_uv_job
>>> script = "https://raw.githubusercontent.com/huggingface/trl/refs/heads/main/trl/scripts/sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> run_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small")
```

تشغيل سكربت محلي:

```python
>>> from huggingface_hub import run_uv_job
>>> script = "my_sft.py"
>>> script_args = ["--model_name_or_path", "Qwen/Qwen2-0.5B", "--dataset_name", "trl-lib/Capybara", "--push_to_hub"]
>>> run_uv_job(script, script_args=script_args, dependencies=["trl"], flavor="a10g-small")
```

نفّذ أمرًا:

```python
>>> from huggingface_hub import run_uv_job
>>> script = "lighteval"
>>> script_args= ["endpoint", "inference-providers", "model_name=openai/gpt-oss-20b,provider=auto", "lighteval|gsm8k|0|0"]
>>> run_uv_job(script, script_args=script_args, dependencies=["lighteval"], flavor="a10g-small")
```

قم بتركيب أحجام التخزين، على سبيل المثال لحفظ نقاط التفتيش للنموذج أثناء التدريب:

```python
>>> from huggingface_hub import Volume, run_uv_job
>>> script = "my_sft.py"
>>> script_args = ["--output_dir", "/training-outputs/training-v3-final", ...]
>>> checkpoints_bucket = Volume(type="bucket", source="username/my-bucket", mount_path="/training-outputs")
>>> run_uv_job(script, script_args=script_args, volumes=[checkpoints_bucket])
```

#### scale_to_zero_inference_endpoint[[huggingface_hub.HfApi.scale_to_zero_inference_endpoint]]

```python
scale_to_zero_inference_endpoint(name: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10007)

**المعاملات:**

name (`str`) : اسم نقطة الاستدلال (Inference Endpoint) التي سيتم تصفير مقياسها.

namespace (`str`، *اختياري*) : مساحة الاسم التي يقع فيها Inference Endpoint. الافتراضي هو المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة النهاية للاستدلال التي تم تصفير مقياسها.

قم بتقليص نقطة نهاية الاستدلال إلى صفر.

لن يتم فرض أي رسوم على نقطة استنتاج (Inference Endpoint) تم تصغيرها إلى صفر. ستُستأنف عند الطلب التالي الموجّه إليها، مع تأخير ناتج عن بدء تشغيل بارد (cold start). وهذا يختلف عن إيقاف نقطة الاستنتاج مؤقتًا باستخدام [pause_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.pause_inference_endpoint)، حيث يتطلب ذلك استئنافًا يدويًا باستخدام [resume_inference_endpoint()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.resume_inference_endpoint).

للسهولة، يمكنك أيضًا تصفير نقطة الاستدلال باستخدام [InferenceEndpoint.scale_to_zero()](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.scale_to_zero).

#### search_spaces[[huggingface_hub.HfApi.search_spaces]]

```python
search_spaces(query: str, filter: str | Iterable[str] | None = None, sdk: str | list[str] | None = None, include_non_running: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2883)

**المعاملات:**

query (`str`) : نص استعلام البحث.

filter (`str` أو `Iterable[str]`، *اختياري*) : وسم نصي أو قائمة وسوم للترشيح بناءً عليها.

sdk (`str` أو `list[str]`، *اختياري*) : تصفية حسب SDK (مثل `"gradio"`، `"docker"`، `"static"`).

include_non_running (`bool`, *اختياري*) : ما إذا كان يجب تضمين مساحات غير نشطة في النتائج. القيمة الافتراضية هي `False`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `Iterable[SpaceSearchResult]`

قابلة للتكرار من كائنات [SpaceSearchResult](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.SpaceSearchResult).

استكشف المساحات على الهاب باستخدام البحث الدلالي.

يستخدم هذا الطرف نقطة البحث الدلالي (المبني على التضمينات) للاستعلامات متعددة الكلمات والبحث النصي الكامل للاستعلامات أحادية الكلمة.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> results = list(api.search_spaces("generate image"))
>>> results[0].id
'mrfakename/Z-Image-Turbo'
>>> results[0].ai_category
'Image Generation'
```

#### set_space_sleep_time[[huggingface_hub.HfApi.set_space_sleep_time]]

```python
set_space_sleep_time(repo_id: str, sleep_time: int, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8378)

**المعاملات:**

repo_id (`str`) : معرّف المستودع الذي سيتم تحديثه. مثال: `"bigcode/in-the-stack"`.

sleep_time (`int`، *اختياري*) : عدد ثوانٍ من عدم النشاط التي يجب انتظارها قبل وضع مساحة في وضع السكون. اضبط القيمة على `-1` إذا كنت لا تريد إيقاف مساحة مؤقتًا (السلوك الافتراضي للأجهزة المُحدَّثة). أما بالنسبة للأجهزة المجانية، فلا يمكنك ضبط وقت السكون (القيمة ثابتة عند 48 ساعة من عدم النشاط). راجع https://huggingface.co/docs/hub/spaces-gpus#sleep-time لمزيد من التفاصيل.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل حول مساحة (Space) تتضمن مرحلة المساحة (Space stage) والأجهزة (hardware).

اضبط وقت نوم مخصصًا لمساحة تعمل على أجهزة محسّنة.

ستدخل مساحة Space الخاصة بك في وضع السكون بعد X ثانية من عدم النشاط. لن يتم احتساب أي رسوم عليك عندما تكون مساحتك في وضع "السكون". إذا وصل زائر جديد إلى مساحتك، فسيتم "إيقاظها". يمكن فقط للأجهزة المصعّدة أن تمتلك وقت سكون قابل للضبط. لمعرفة المزيد حول مرحلة السكون، يُرجى الرجوع إلى https://huggingface.co/docs/hub/spaces-gpus#sleep-time.

> [!TIP]
> من الممكن أيضًا تعيين وقت نوم مخصص عند طلب العتاد باستخدام [request_space_hardware()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.request_space_hardware).

#### set_space_volumes[[huggingface_hub.HfApi.set_space_volumes]]

```python
set_space_volumes(repo_id: str, volumes: list[Volume], token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9062)

**المعاملات:**

repo_id (`str`) : معرّف مساحة (Space) التي سيتم تحديثها. مثال: `"username/my-space"`.

volumes (`list[Volume]`) : قائمة من كائنات [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) للتثبيت. يحتوي كل حجم على `type` (`"bucket"`، `"model"`، `"dataset"`، أو `"space"`)، و`source` (معرّف المستودع أو الدلو)، و`mount_path` (المسار داخل الحاوية)، وحقول اختيارية `revision` و`read_only` و`path`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `BadRequestError`

- `BadRequestError` -- إذا كان المساحة مساحة ثابتة (لا يتم دعم الأحجام في المساحات الثابتة).

اضبط الأحجام لمساحة.

Sets (أو يستبدل) قائمة الأحجام (volumes) المرفقة في المساحة (Space). يمنح كل حجم حاوية المساحة (Space) وصولاً إلى مورد في Hub (نموذج، مجموعة بيانات، أو دلو تخزين).

مثال:
```python
>>> from huggingface_hub import HfApi, Volume
>>> api = HfApi()
>>> api.set_space_volumes(
...     "username/my-space",
...     volumes=[
...         Volume(type="model", source="username/my-model", mount_path="/models", read_only=True),
...         Volume(type="bucket", source="username/my-bucket", mount_path="/data"),
...     ],
... )
```

#### snapshot_download[[huggingface_hub.HfApi.snapshot_download]]

```python
snapshot_download(repo_id: str, repo_type: str | None = None, revision: str | None = None, cache_dir: str | Path | None = None, local_dir: str | Path | None = None, etag_timeout: float = 10, force_download: bool = False, token: bool | str | None = None, local_files_only: bool = False, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, max_workers: int = 8, tqdm_class: type[base_tqdm] | None = None, dry_run: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L6551)

**المعاملات:**

repo_id (`str`) : اسم مستخدم أو منظمة واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` إذا كنتَ تقوم بتنزيل من مجموعة بيانات أو مساحة، أو `None` أو `"model"` إذا كنتَ تقوم بتنزيل من نموذج. القيمة الافتراضية هي `None`.

revision (`str`, *اختياري*) : معرف اختيارية لمراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.

cache_dir (`str`، `Path`، *اختياري*) : المسار إلى المجلد الذي تُخزَّن فيه الملفات المؤقتة.

local_dir (`str` أو `Path`، *اختياري*) : إذا تم تقديمه، فسيتم وضع الملفات المُحمَّلة تحت هذا المجلد.

etag_timeout (`float`، *اختياري*، القيمة الافتراضية `10`) : عند جلب ETag، عدد الثواني التي يجب انتظارها حتى يرسل الخادم البيانات قبل التوقف، وهي القيمة التي تُمرَّر إلى `httpx2.request`.

force_download (`bool`، *اختياري*، الافتراضي `False`) : ما إذا كان يجب تنزيل الملف حتى لو كان موجودًا مسبقًا في ذاكرة التخزين المؤقت المحلية.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

local_files_only (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، فتجنّب تنزيل الملف وعُدّ مسار الملف المخزّن محليًا إذا كان موجودًا.

allow_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، يتم تنزيل الملفات المطابقة لنمط واحد على الأقل فقط.

ignore_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، فإن الملفات المطابقة لأي من الأنماط لن يتم تنزيلها.

max_workers (`int`, *اختياري*) : عدد الخيوط المتزامنة لتنزيل الملفات (خيط واحد = تنزيل ملف واحد). القيمة الافتراضية هي 8.

tqdm_class (`tqdm`، *اختياري*) : إذا تم توفيره، يُغني عن السلوك الافتراضي لشريط التقدم. يجب أن يرث الحُجج المُمرَّرة من `tqdm.auto.tqdm` أو يحاكي سلوكه على الأقل. لاحظ أن `tqdm_class` لا يُمرَّر إلى كل عملية تنزيل على حدة. الافتراضي هو شريط تقدم مخصص من HF يمكن تعطيله عن طريق تعيين متغير البيئة `HF_HUB_DISABLE_PROGRESS_BARS`.

dry_run (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت `True`، يتم تنفيذ تشغيل تجريبي دون تنزيل الملفات فعليًا. تُرجع قائمة من كائنات [DryRunFileInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DryRunFileInfo) تحتوي على معلومات حول ما كان سيُتنزَّل.

**يعيد:** `str` أو قائمة من [DryRunFileInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DryRunFileInfo)

- إذا كان `dry_run=False`: مسار مجلد لقطة المستودع.
- إذا كان `dry_run=True`: قائمة من كائنات [DryRunFileInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.DryRunFileInfo) تحتوي على معلومات التحميل.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) أو ``EnvironmentError`` أو ``OSError`` أو ``ValueError``

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مضبوطًا على `private` ولا تملك صلاحية الوصول إليه.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا تعذّر العثور على المراجعة التي يجب التحميل منها.
- [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError) -- إذا كان `token=True` ولم يتم العثور على الرمز.
- [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) -- إذا تعذّر تحديد ETag.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كانت قيمة بعض المعاملات غير صالحة.

تنزيل ملفات المستودع.

تنزيل لقطة كاملة لملفات المستودع عند المراجعة المحددة. يكون هذا مفيدًا عندما تريد جميع الملفات من مستودع، لأنك لا تعرف مسبقًا أيها ستحتاج. تُوضع جميع الملفات داخل مجلد لتبقى أسماء الملفات الفعلية نسبيةً لذلك المجلد. كما يمكنك تصفية الملفات المراد تنزيلها باستخدام `allow_patterns` و`ignore_patterns`.

إذا تم توفير `local_dir`، فسيتم تكرار هيكل الملفات من المستودع في هذا الموقع. عند استخدام هذا الخيار، لن يتم استخدام `cache_dir` وسيتم إنشاء مجلد `.cache/huggingface/` في جذر `local_dir` لتخزين بعض البيانات الوصفية المتعلقة بالملفات التي تم تنزيلها. وعلى الرغم من أن هذا الآلية ليست قوية مثل نظام الكاش الرئيسي، إلا أنها مُحسّنة لسحب أحدث إصدار من المستودع بانتظام.

بديل لذلك هو استنساخ المستودع، لكن هذا يتطلب تثبيت git و git-lfs وتكوينهما بشكل صحيح. كما أنه لا يمكن تصفية الملفات المراد تنزيلها عند استنساخ مستودع باستخدام git.

#### space_info[[huggingface_hub.HfApi.space_info]]

```python
space_info(repo_id: str, revision: str | None = None, timeout: float | None = None, files_metadata: bool = False, expand: list[ExpandSpaceProperty_T] | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L3364)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

revision (`str`، *اختياري*) : نسخة مستودع المساحة التي سيتم منها الحصول على المعلومات.

timeout (`float`، *اختياري*) : ما إذا كان يجب تعيين مهلة زمنية للطلب الموجّه إلى Hub.

files_metadata (`bool`، *اختياري*) : ما إذا كان سيتم استرداد البيانات الوصفية للملفات في المستودع (الحجم، البيانات الوصفية لـ LFS، إلخ). القيمة الافتراضية هي `False`.

expand (`list[ExpandSpaceProperty_T]`، *اختياري*) : خصائص قائمة للإرجاع في الاستجابة. عند الاستخدام، لن تُرجع إلا الخصائص الموجودة في القائمة. لا يمكن استخدام هذا المعامل إذا تم تمرير `full`. القيم الممكنة هي `"author"`، `"cardData"`، `"createdAt"`، `"datasets"`، `"disabled"`، `"lastModified"`، `"likes"`، `"models"`، `"private"`، `"region"`، `"runtime"`، `"sdk"`، `"siblings"`، `"sha"`، `"subdomain"`، `"tags"`، `"trendingScore"`، `"usedStorage"`، `"visibility"`، و`"resourceGroup"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [SpaceInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.SpaceInfo)

معلومات مستودع المساحة.

احصل على معلومات حول مساحة محددة على huggingface.co.

يمكن أن يكون المساحة خاصة إذا قمت بتمرير رمز مقبول.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مُعيَّنًا على أنه `private` ولا تملك صلاحية الوصول إليه. - [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) إذا تعذّر العثور على الإصدار الذي سيتم التنزيل منه.

#### super_squash_history[[huggingface_hub.HfApi.super_squash_history]]

```python
super_squash_history(repo_id: str, branch: str | None = None, commit_message: str | None = None, repo_type: str | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4351)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

branch (`str`، *اختياري*) : الفرع الذي سيتم دمج فروع الفرع فيه. الافتراضي هو رأس فرع `"main"`.

commit_message (`str`، *اختياري*) : رسالة الالتزام المستخدمة للالتزام المُدمج.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند سرد الالتزامات من مجموعة بيانات أو مساحة، أو `None` أو `"model"` عند السرد من نموذج. القيمة الافتراضية هي `None`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) أو [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا تعذّر العثور على الفرع الذي يجب دمجه.
- [BadRequestError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.BadRequestError) -- إذا كان المرجع غير صالح لفرع. لا يمكنك ضغط السجل على الوسوم.

دمج سجلّ الالتزامات على فرعٍ في مستودعٍ على Hub.

يُعدّ دمج سجل المستودع مفيدًا عندما تعلم أنك ستقوم بمئات من عمليات الإضافة ولا تريد إرباك السجل. لا يمكن تنفيذ دمج عمليات الإضافة إلا من رأس الفرع.

> [!WARNING]
> بمجرد دمج التغيرات، لا يمكن استعادة سجل التغيرات. هذه عملية لا يمكن التراجع عنها.

> [!WARNING]
> بمجرد ضغط سجل فرع، لم يعد من الممكن دمجه مرة أخرى في فرع آخر لأن سجلاتهما ستكون قد تباعدت.

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()

# Create repo
>>> repo_id = api.create_repo("test-squash").repo_id

# Make a lot of commits.
>>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"content")
>>> api.upload_file(repo_id=repo_id, path_in_repo="lfs.bin", path_or_fileobj=b"content")
>>> api.upload_file(repo_id=repo_id, path_in_repo="file.txt", path_or_fileobj=b"another_content")

# Squash history
>>> api.super_squash_history(repo_id=repo_id)
```

#### suspend_scheduled_job[[huggingface_hub.HfApi.suspend_scheduled_job]]

```python
suspend_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13359)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

Suspend (إيقاف مؤقت) مهمة حساب مجدولة على بنية Hugging Face التحتية.

#### sync_bucket[[huggingface_hub.HfApi.sync_bucket]]

```python
sync_bucket(source: str | None = None, dest: str | None = None, delete: bool = False, ignore_times: bool = False, ignore_sizes: bool = False, existing: bool = False, ignore_existing: bool = False, include: list[str] | None = None, exclude: list[str] | None = None, filter_from: str | None = None, plan: str | None = None, apply: str | None = None, dry_run: bool = False, verbose: bool = False, quiet: bool = False, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L15212)

**المعاملات:**

source (*str*، *اختياري*) : مسار المصدر: مجلد محلي أو `hf://buckets/namespace/bucket_name(/prefix)`. مطلوب ما لم يتم استخدام `apply`.

dest (*str*، *اختياري*) : مسار الوجهة: مجلد محلي أو `hf://buckets/namespace/bucket_name(/prefix)`. مطلوب ما لم يتم استخدام `apply`.

delete (*bool*، *اختياري*، القيمة الافتراضية *False*) : حذف الملفات الموجودة في الوجهة وغير الموجودة في المصدر.

ignore_times (*bool*، *اختياري*، القيمة الافتراضية *False*) : تخطي الملفات بناءً على الحجم فقط، مع تجاهل أوقات التعديل.

ignore_sizes (*bool*، *اختياري*، القيمة الافتراضية *False*) : تخطي الملفات بناءً على أوقات التعديل فقط، مع تجاهل الأحجام.

existing (*bool*، *اختياري*، القيمة الافتراضية *False*) : تخطي إنشاء ملفات جديدة على المستقبل (تحديث الملفات الموجودة فقط).

ignore_existing (*bool*، *اختياري*، القيمة الافتراضية *False*) : تخطي تحديث الملفات الموجودة على المستقبل (إنشاء الملفات الجديدة فقط).

include (*list[str]*، *اختياري*) : تضمين الملفات المطابقة للنمط (بأسلوب fnmatch).

exclude (*list[str]*، *اختياري*) : استبعاد الملفات المطابقة لأنماط (بأسلوب fnmatch).

filter_from (*str*، *اختياري*) : المسار إلى ملف تصفية يحتوي على قواعد تضمين/استبعاد.

plan (*str*، *اختياري*) : احفظ خطة المزامنة في هذا الملف بصيغة JSONL بدلاً من تنفيذها.

apply (*str*، *اختياري*) : تطبيق ملف خطة محفوظ مسبقًا. عند ضبطه، لا حاجة إلى `source` و`dest`.

dry_run (*bool*، *اختياري*، القيمة الافتراضية *False*) : طباعة خطة المزامنة إلى stdout بصيغة JSONL دون تنفيذها.

verbose (*bool*، *اختياري*، القيمة الافتراضية *False*) : عرض عمليات مفصّلة لكل ملف.

quiet (*bool*، *اختياري*، القيمة الافتراضية *False*) : كبت جميع المخرجات وأشرطة التقدم.

token (Union[bool, str, None], اختياري) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيتم استخدام رمز الوصول المحفوظ محليًا.

**يعيد:** [*SyncPlan*]

خطة المزامنة المحسوبة (أو المحمّلة).

مزامنة الملفات بين مجلد محلي ودلو.

يعادل هذا الأمر أمر سطر الأوامر `hf buckets sync`. يجب أن يكون أحدهما من `source` أو `dest` مسار دلو (`hf://buckets/...`) والآخر مسار مجلد محلي.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()

# Upload local directory to bucket
>>> api.sync_bucket("./data", "hf://buckets/username/my-bucket")

# Download bucket to local directory
>>> api.sync_bucket("hf://buckets/username/my-bucket", "./data")

# Sync with delete and filtering
>>> api.sync_bucket(
...     "./data",
...     "hf://buckets/username/my-bucket",
...     delete=True,
...     include=["*.safetensors"],
... )

# Dry run: preview what would be synced
>>> plan = api.sync_bucket("./data", "hf://buckets/username/my-bucket", dry_run=True)
>>> plan.summary()
&amp;lcub;'uploads': 3, 'downloads': 0, 'deletes': 0, 'skips': 1, 'total_size': 4096}

# Save plan for review, then apply
>>> api.sync_bucket("./data", "hf://buckets/username/my-bucket", plan="sync-plan.jsonl")
>>> api.sync_bucket(apply="sync-plan.jsonl")
```

#### sync_job_volume[[huggingface_hub.HfApi.sync_job_volume]]

```python
sync_job_volume(source: str | Path, mount_path: str, remote_name: str | None = None, read_only: bool = True, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13862)

**المعاملات:**

source (`str` أو `Path`) : المسار إلى مجلد محلي للمزامنة.

mount_path (`str`) : مسار التركيب داخل حاوية المهمة، على سبيل المثال `"/inputs"`. يجب أن يبدأ بـ `/`.

remote_name (`str`, *اختياري*) : اسم مجلد الفرع في الدلو الذي سيتم المزامنة معه. الافتراضي هو اسم `{dirname}-{hash}` مشتق من مسار المصدر واسم مضيف الجهاز.

read_only (`bool`، *اختياري*، القيمة الافتراضية `True`) : تركيب وحدة التخزين للقراءة فقط في المهمة. مرّر `False` للسماح للمهمة بالكتابة مرة أخرى إلى مجلد الدلو (مثلًا لاستخراج المخرجات باستخدام [sync_bucket()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket) لاحقًا).

namespace (`str`، *اختياري*) : مساحة الأسماء التي تمتلك حاوية `jobs-artifacts`. الافتراضي هو مساحة أسماء المستخدم الحالي. استخدم نفس مساحة الأسماء الخاصة بالمهمة التي ستقوم بتركيب الوحدة.

token (`Union[bool, str, None]`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** [حجم](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume)

حجم دلو (Bucket volume) مُقيّد النطاق بالملف الفرعي المتزامن، ليتم تمريره في قائمة `volumes` الخاصة بـ [run_job()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.run_job) أو [run_uv_job()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.run_uv_job) أو [create_scheduled_job()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_scheduled_job) أو [create_scheduled_uv_job()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_scheduled_uv_job).

مزامنة مجلد محلي مع دلو وإرجاع [Volume](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.Volume) جاهز للتثبيت في مهمة.

تُحمَّل الملفات إلى مجلد فرعي داخل حاوية `{namespace}/jobs-artifacts` (يتم إنشاؤه تلقائيًا كخاص؛ ويُصدر تحذيرًا إذا كان موجودًا مسبقًا وعامًا) باستخدام نفس منطق المزامنة المستخدم في [sync_bucket()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket): فإعادة مزامنة نفس المجلد لا ترفع سوى الملفات الجديدة أو المعدَّلة. افتراضيًا، يُشتق اسم المجلد الفرعي من مسار المجلد واسم مضيف الجهاز، بحيث تعيد الاستدعاءات المتكررة من نفس المجلد استخدام نفس المجلد البعيد. مرِّر `remote_name` لاستخدام اسم ثابت بدلاً من ذلك.

لاحظ أن البيانات *تُنسخ* إلى الدلو، ولا تُركَّب مباشرة: التغييرات التي تُجرى محليًا بعد المزامنة لا تظهر للـ Job (أعد تشغيل `sync_job_volume` لتحديثها)، كما أن المجلد يُركَّب للقراءة فقط افتراضيًا. لاسترجاع البيانات التي كتبها الـ Job إلى مجلد قابل للقراءة والكتابة، قم بمزامنة مجلد الدلو مرة أخرى باستخدام [sync_bucket()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.sync_bucket). إذا كان المجلد المصدر فارغًا (مثل مجلد الإخراج)، يتم رفع ملف `.keep` كملف احتياطي حتى يمكن تركيب المجلد.

مثال:
```python
>>> from huggingface_hub import run_uv_job, sync_job_volume

# Upload ./training-data once, then run multiple jobs against it
>>> volume = sync_job_volume("./training-data", "/data")
>>> run_uv_job("train.py", script_args=["--learning-rate", "0.01"], volumes=[volume])
>>> run_uv_job("train.py", script_args=["--learning-rate", "0.05"], volumes=[volume])

# Read-write volume to retrieve outputs after the job completes
>>> volume = sync_job_volume("./outputs", "/outputs", read_only=False)
>>> job = run_uv_job("process.py", volumes=[volume])
```

#### trigger_scheduled_job[[huggingface_hub.HfApi.trigger_scheduled_job]]

```python
trigger_scheduled_job(scheduled_job_id: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13471)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo)

معلومات حول التشغيل المُفعّل.

**يرفع:** [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError)

- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- خطأ HTTP 409 إذا كان هناك مثيل آخر قيد التشغيل بالفعل ومعطّل `concurrency` في المهمة المجدولة.

تشغيل مهمة مجدولة فوراً.

يُطلق هذا الأمر تنفيذًا فوريًا واحدًا لمواصفة المهمة المجدولة. لا **يُعدّل** الجدول الزمني ولا **يؤثر** على التنفيذ المجدول التالي. إذا كانت هناك نسخة قيد التشغيل بالفعل ولا تسمح المهمة المجدولة بالتشغيل المتزامن، فسيتم رفض الطلب (HTTP 409).

#### على عكس[[huggingface_hub.HfApi.unlike]]

```python
unlike(repo_id: str, token: bool | str | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2942)

**المعاملات:**

repo_id (`str`) : المستودع الذي تريد إلغاء إعجابه. مثال: `"user/my-cool-model"`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` عند إلغاء الإعجاب بمجموعة بيانات أو مساحة، أو `None` أو `"model"` عند إلغاء الإعجاب بنموذج. القيمة الافتراضية هي `None`.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.

على عكس مستودع معين على Hub (مثلًا، إزالة من قائمة المفضلة).

للمنع من الاستخدام غير المشروع، لا يمكن `like` مستودعًا من سكربت.

انظر أيضًا إلى [list_liked_repos()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_liked_repos).

مثال:
```python
>>> from huggingface_hub import list_liked_repos, unlike
>>> "gpt2" in list_liked_repos().models # we assume you have already liked gpt2
True
>>> unlike("gpt2")
>>> "gpt2" in list_liked_repos().models
False
```

#### update_bucket_settings[[huggingface_hub.HfApi.update_bucket_settings]]

```python
update_bucket_settings(bucket_id: str, private: bool, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L14261)

**المعاملات:**

bucket_id (`str`) : المعرّف الخاص بالحاوية (على سبيل المثال `"username/my-bucket"`).

private (`bool`) : ما إذا كان سيتم جعل الدلو خاصًا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يرفع:** `BucketNotFoundError` أو ``or``

- `BucketNotFoundError` -- إذا تعذّر العثور على الدلو. قد يكون السبب عدم وجوده،
- ``or`` -- لأنه مَعيَّن على `private` ولا تملك صلاحية الوصول إليه.

تحديث إعدادات دلو على Hub.

حاليًا، الإعداد المدعوم الوحيد هو مستوى ظهور الدلو.

مثال:
```python
>>> from huggingface_hub import update_bucket_settings

>>> # Make a bucket public
>>> update_bucket_settings(bucket_id="Wauplin/first-bucket", private=False)

>>> # Make it private again
>>> update_bucket_settings(bucket_id="Wauplin/first-bucket", private=True)
```

#### update_collection_item[[huggingface_hub.HfApi.update_collection_item]]

```python
update_collection_item(collection_slug: str, item_object_id: str, note: str | None = None, position: int | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10499)

**المعاملات:**

collection_slug (`str`) : المعرّف المختصر (Slug) للمجموعة المراد تحديثها. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

item_object_id (`str`) : المعرّف الخاص بالعنصر في المجموعة. هذا ليس المعرّف الخاص بالعنصر على Hub (repo_id أو paper id). يجب استرداده من كائن [CollectionItem](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.CollectionItem). مثال: `collection.items[0].item_object_id`.

note (`str`، *اختياري*) : ملاحظة تُرفق بالعنصر في المجموعة. الحد الأقصى لحجم الملاحظة هو 500 حرف.

position (`int`، *اختياري*) : الموقع الجديد للعنصر في المجموعة.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

تحديث عنصر في مجموعة.

مثال:

```py
>>> from huggingface_hub import get_collection, update_collection_item

# Get collection first
>>> collection = get_collection("TheBloke/recent-models-64f9a55bb3115b4f513ec026")

# Update item based on its ID (add note + update position)
>>> update_collection_item(
...     collection_slug="TheBloke/recent-models-64f9a55bb3115b4f513ec026",
...     item_object_id=collection.items[-1].item_object_id,
...     note="Newly updated model!",
...     position=0,
... )
```

#### update_collection_metadata[[huggingface_hub.HfApi.update_collection_metadata]]

```python
update_collection_metadata(collection_slug: str, title: str | None = None, description: str | None = None, position: int | None = None, private: bool | None = None, theme: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10269)

**المعاملات:**

collection_slug (`str`) : المعرّف المختصر (Slug) للمجموعة المراد تحديثها. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

title (`str`) : عنوان المجموعة التي سيتم تحديثها.

description (`str`، *اختياري*) : وصف المجموعة التي سيتم تحديثها. الحد الأقصى لحجم الوصف هو 150 حرفًا.

position (`int`, *اختياري*) : الموقع الجديد للمجموعة في قائمة مجموعات المستخدم.

private (`bool`، *اختياري*) : ما إذا كان يجب أن تكون المجموعة خاصة أم لا.

theme (`str`، *اختياري*) : موضوع المجموعة على الـ Hub.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

تحديث بيانات الوصف الخاصة بمجموعة على Hub.

جميع الحُجج اختيارية. لن يتم تحديث سوى البيانات الوصفية المُقدَّمة.

يعيد: [Collection](/docs/huggingface_hub/main/ar/package_reference/collections#huggingface_hub.Collection)

مثال:

```py
>>> from huggingface_hub import update_collection_metadata
>>> collection = update_collection_metadata(
...     collection_slug="username/iccv-2023-64f9a55bb3115b4f513ec026",
...     title="ICCV Oct. 2023",
...     description="Portfolio of models, datasets, papers and demos I presented at ICCV Oct. 2023",
...     private=False,
...     theme="pink",
... )
>>> collection.slug
"username/iccv-oct-2023-64f9a55bb3115b4f513ec026"
# ^collection slug got updated but not the trailing ID
```

#### update_collection_resource_group[[huggingface_hub.HfApi.update_collection_resource_group]]

```python
update_collection_resource_group(collection_slug: str, resource_group_id: str | None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L10337)

**المعاملات:**

collection_slug (`str`) : المعرّف المختصر (Slug) للمجموعة المراد تحديثها. مثال: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.

resource_group_id (`str` أو `None`) : مجموعة الموارد التي سيتم إسناد المجموعة إليها، كسلسلة سداسية عشرية بطول 24 حرفًا. إذا كانت `None`، تُزال المجموعة من أي مجموعة موارد.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

اسند مجموعة إلى مجموعة موارد، أو أزلها من أي مجموعة موارد.

صالح فقط لمجموعات مملوكة للمنظمة.

مثال:

```py
>>> from huggingface_hub import update_collection_resource_group
>>> update_collection_resource_group(
...     collection_slug="my-org/iccv-2023-64f9a55bb3115b4f513ec026",
...     resource_group_id="66980ecfc1e12a49c8f0e42d",
... )
```

#### update_inference_endpoint[[huggingface_hub.HfApi.update_inference_endpoint]]

```python
update_inference_endpoint(name: str, accelerator: str | None = None, instance_size: str | None = None, instance_type: str | None = None, min_replica: int | None = None, max_replica: int | None = None, scale_to_zero_timeout: int | None = None, scaling_metric: InferenceEndpointScalingMetric | None = None, scaling_threshold: float | None = None, repository: str | None = None, framework: str | None = None, revision: str | None = None, task: str | None = None, custom_image: dict | None = None, container_command: list[str] | None = None, container_args: list[str] | None = None, tensor_parallel_size: int | None = None, data_parallel_size: int | None = None, env: dict[str, str] | None = None, secrets: dict[str, str] | None = None, domain: str | None = None, path: str | None = None, cache_http_responses: bool | None = None, tags: list[str] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L9710)

**المعاملات:**

name (`str`) : اسم نقطة الاستدلال (Inference Endpoint) المراد تحديثها.

accelerator (`str`، *اختياري*) : مُسرِّع العتاد الذي سيُستخدم للاستدلال (مثل `"cpu"`).

instance_size (`str`، *اختياري*) : حجم أو نوع المثيل الذي سيُستخدم لاستضافة النموذج (مثل `"x4"`).

instance_type (`str`، *اختياري*) : نوع مثيل السحابة الذي سيتم نشر نقطة الاستدلال (Inference Endpoint) عليه (مثل `"intel-icl"`).

min_replica (`int`، *اختياري*) : الحد الأدنى لعدد النسخ (المهام) التي يجب إبقاؤها قيد التشغيل لنقطة الاستدلال.

max_replica (`int`، *اختياري*) : الحد الأقصى لعدد النسخ (الأمثلة) التي يمكن توسيعها لنقطة الاستدلال.

scale_to_zero_timeout (`int`، *اختياري*) : المدة بالدقائق قبل أن يُخفَّض حجم نقطة النهاية غير النشطة إلى صفر.

scaling_metric (`str` أو `InferenceEndpointScalingMetric `، *اختياري*) : مرجع المقياس للتوسيع. إما "pendingRequests" أو "hardwareUsage" عند تقديمه. القيمة الافتراضية هي None.

scaling_threshold (`float`, *اختياري*) : عتبة مقياس التوسيع المستخدمة لتفعيل التوسيع. يتم تجاهلها عندما لا يُوفَّر مقياس التوسيع. القيمة الافتراضية هي None.

repository (`str`، *اختياري*) : اسم مستودع النموذج المرتبط بنقطة الاستدلال (Inference Endpoint) (مثل `"gpt2"`).

framework (`str`، *اختياري*) : إطار التعلم الآلي المستخدم للنموذج (مثل `"custom"`).

revision (`str`، *اختياري*) : المراجعة المحددة للنموذج التي سيتم نشرها على نقطة الاستدلال (Inference Endpoint) (مثل `"6c0e6080953db56375760c0471a8c5f2929baf11"`).

task (`str`، *اختياري*) : المهمة التي سيتم نشر النموذج عليها (مثل `"text-classification"`).

custom_image (`dict`, *اختياري*) : صورة الحاوية التي سيتم تشغيلها. إما قاموس مفاتيحه هي نسخ الصور (مثل `{"vLLM": {"url": "vllm/vllm-openai:v0.23.0", "port": 8000}}`، وكذلك `sGLang`، `tgi`، `tei`، `llamacpp`، `hfServe`، ...)، والذي يُمرَّر كما هو، أو قاموس مسطّح يصف حاوية مخصصة (مثل `{"url": ..., "port": ...}`)، والذي يُرسل على شكل `{"custom": ...}`.

container_command (`list[str]`، *اختياري*) : تجاوز أمر نقطة الدخول للحاوية (يتوافق مع `model.command` في حمولة الواجهة البرمجية). يعمل مع صور المحركات المُدارة (مثل vLLM وSGLang) والصور المخصصة.

container_args (`list[str]`، *اختياري*) : الحُجج المُلحَقة بنقطة دخول الحاوية (تتوافق مع `model.args` في حمولة الواجهة البرمجية). تعمل مع صور المحركات المُدارة (مثل vLLM وSGLang) والصور المخصصة.

tensor_parallel_size (`int`, *اختياري*) : عدد المعالِجات التي تُوزَّع عليها نسخة واحدة من النموذج (صور vLLM و SGLang). يُكتب داخل إعدادات صورة المحرّك. تتطلب الواجهة البرمجية `model.image` ككل، لذا عند عدم تقديم `custom_image` يتم جلب الصورة المُعدّة حاليًا على نقطة النهاية وتحديثها في مكانها.

data_parallel_size (`int`، *اختياري*) : عدد نسخ النموذج التي سيتم تشغيلها، نسخة واحدة لكل معجّل (صور vLLM). نفس المعالجة المطبّقة على `tensor_parallel_size`.

env (`dict[str, str]`، *اختياري*) : متغيرات بيئة غير سرية تُحقن في بيئة الحاوية

secrets (`dict[str, str]`، *اختياري*) : قيم سرية تُحقن في بيئة الحاوية.

domain (`str`، *اختياري*) : المجال المخصص لنشر نقطة الاستدلال، فإذا تم ضبطه ستكون نقطة الاستدلال متاحة عبر هذا المجال (مثلًا `"my-new-domain.cool-website.woof"`).

path (`str`، *اختياري*) : المسار المخصص للنموذج المُنفَّذ، يجب أن يبدأ بـ `/` (مثل `"/models/google-bert/bert-base-uncased"`).

cache_http_responses (`bool`، *اختياري*) : ما إذا كان سيتم تخزين استجابات HTTP من نقطة الاستدلال مؤقتًا.

tags (`list[str]`، *اختياري*) : قائمة بالوسوم التي سيتم ربطها بنقطة الاستدلال (Inference Endpoint).

namespace (`str`، *اختياري*) : مساحة الاسم التي سيتم فيها تحديث نقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [InferenceEndpoint](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint)

معلومات حول نقطة الاستدلال المحدّثة.

تحديث نقطة نهاية الاستدلال.

تتيح هذه الطريقة تحديث إعدادات الحساب، أو النموذج المُنفَّذ، أو المسار، أو أي تركيبة منها. جميع الحجج اختيارية، لكن يجب تقديم واحدة على الأقل.

للسهولة، يمكنك أيضًا تحديث نقطة استنتاج باستخدام [InferenceEndpoint.update()](/docs/huggingface_hub/main/ar/package_reference/inference_endpoints#huggingface_hub.InferenceEndpoint.update).

#### update_job_expose[[huggingface_hub.HfApi.update_job_expose]]

```python
update_job_expose(job_id: str, expose: list[int] | None = None, expose_public: list[int] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12792)

**المعاملات:**

job_id (`str`) : معرّف المهمة قيد التشغيل.

expose (`list[int]`، *اختياري*) : المنافذ التي يجب كشفها عبر وكيل Jobs. يتطلب الوصول رمز HF مع صلاحية القراءة في مساحة أسماء Job.

expose_public (`list[int]`، *اختياري*) : المنافذ التي يجب كشفها عبر وكيل Jobs دون مصادقة. لا يلزم إدراجها في `expose`.

namespace (`str`، *اختياري*) : مساحة الاسم الخاصة بالمهمة. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول المستخدم. الافتراضي هو المحفوظ محليًا.

**يعيد:** [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo)

المهمة المحدّثة.

استبدال المنافذ المكشوفة لوظيفة قيد التشغيل دون إعادة تشغيلها.

`expose` و`expose_public` معًا تشكّلان إعداد المنفذ الكامل: المنافذ التي لا توجد في أيٍّ من القائمتين تكون مغلقة. لا تمرّر أيًّا منهما لإغلاق جميع المنافذ المكشوفة.

#### update_job_labels[[huggingface_hub.HfApi.update_job_labels]]

```python
update_job_labels(job_id: str, labels: dict[str, str], namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12833)

**المعاملات:**

job_id (`str`) : معرف المهمة.

labels (`dict[str, str]`) : التسميات الجديدة التي سيتم تعيينها على المهمة. تحل محل جميع التسميات الموجودة مسبقًا. يجب ألا يتجاوز طول كل من المفاتيح والقيم 100 حرف، وأن تحتوي على أحرف وأرقام وشرطات وشرطات سفلية فقط.

namespace (`str`، *اختياري*) : مساحة الاسم التي يعمل فيها Job. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo)

معلومات المهمة المحدّثة.

تحديث تسميات مهمة موجودة مسبقًا.

يستبدل جميع التسميات التي قدمها المستخدم سابقًا بالتسميات الجديدة.

#### update_repo_settings[[huggingface_hub.HfApi.update_repo_settings]]

```python
update_repo_settings(repo_id: str, gated: Literal['auto', 'manual', False] | None = None, private: bool | None = None, visibility: RepoVisibility_T | None = None, token: str | bool | None = None, repo_type: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4843)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ /.

gated (`Literal["auto", "manual", False]`, *اختياري*) : حالة التقييد للمستودع. إذا تم ضبطها على `None` (الافتراضي)، فلن يتم تحديث إعداد `gated` للمستودع. * "auto": المستودع مقيد، وتُقبل طلبات الوصول أو تُرفض تلقائيًا بناءً على معايير محددة مسبقًا. * "manual": المستودع مقيد، وتتطلب طلبات الوصول موافقة يدوية. * False : المستودع غير مقيد، ويمكن لأي شخص الوصول إليه.

private (`bool`، *اختياري*) : ما إذا كان يجب أن يكون المستودع خاصًا. لا يمكن تمريره مع `visibility`.

visibility (`Literal["public", "private", "protected"]`, *اختياري*) : مدى ظهور المستودع. يمكن أن يكون `"public"` أو `"private"`، أو `"protected"` لـ Spaces.

token (`Union[str, bool, None]`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر False.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم تحديث الإعدادات منه (`"model"` أو `"dataset"` أو `"space"`). القيمة الافتراضية هي `"model"`.

**يرفع:** ``ValueError`` أو [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) أو [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError)

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا لم يكن gated أحد القيم "auto" أو "manual" أو False.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا لم يكن repo_type أحد القيم الموجودة في constants.REPO_TYPES.
- [HfHubHTTPError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.HfHubHTTPError) -- إذا فشل الطلب الموجّه إلى واجهة برمجة تطبيقات Hugging Face Hub.
- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا تعذّر العثور على المستودع الذي سيتم التنزيل منه. قد يكون السبب عدم وجوده، أو كونه مضبوطًا على `private` ولا تملك صلاحية الوصول إليه.

تحديث إعدادات المستودع، بما في ذلك الوصول المُقيَّد والإظهار.

من أجل منح مزيد من التحكم في طريقة استخدام المستودعات، يتيح لك مركز Hugging Face لمطوّري المستودعات تفعيل طلبات الوصول إلى مستودعاتهم، كما يتيح لهم تغيير مستوى ظهور المستودع.

#### update_scheduled_job_labels[[huggingface_hub.HfApi.update_scheduled_job_labels]]

```python
update_scheduled_job_labels(scheduled_job_id: str, labels: dict[str, str], namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13513)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

labels (`dict[str, str]`) : التسميات الجديدة التي يجب تعيينها على المهمة المجدولة. تحل محل جميع التسميات الموجودة مسبقًا. يجب ألا يتجاوز طول كل من المفاتيح والقيم 100 حرف، وأن تحتوي على أحرف وأرقام وشرطات وشرطات سفلية فقط.

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** `ScheduledJobInfo`

معلومات المهمة المجدولة المحدّثة.

تحديث تسميات مهمة مجدولة موجودة مسبقًا.

يستبدل جميع التسميات التي قدمها المستخدم سابقًا بالتسميات الجديدة.

#### update_scheduled_job_schedule[[huggingface_hub.HfApi.update_scheduled_job_schedule]]

```python
update_scheduled_job_schedule(scheduled_job_id: str, schedule: str, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L13419)

**المعاملات:**

scheduled_job_id (`str`) : معرّف المهمة المجدولة.

schedule (`str`) : أحد "@annually" أو "@yearly" أو "@monthly" أو "@weekly" أو "@daily" أو "@hourly"، أو تعبير جدولة CRON (مثل '0 9 * * 1' للساعة 9 صباحًا كل يوم اثنين).

namespace (`str`، *اختياري*) : مساحة الاسم التي يوجد فيها Job المجدول. الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** `ScheduledJobInfo`

معلومات المهمة المجدولة المحدّثة.

تغيير وقت تشغيل مهمة مجدولة موجودة مسبقًا.

يتم تحديث الجدولة فقط: حيث تُحفظ مواصفات المهمة (Job) والوسوم وحالة الإيقاف المؤقت. لتشغيل المهمة المجدولة مرة واحدة الآن دون تغيير جدولتها، استخدم [trigger_scheduled_job()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.trigger_scheduled_job) بدلاً من ذلك.

مثال:

```python
>>> from huggingface_hub import update_scheduled_job_schedule
>>> scheduled_job = update_scheduled_job_schedule(scheduled_job_id="6abb8dc9c617607c354d45f4", schedule="@daily")
>>> scheduled_job.schedule
'@daily'
```

#### update_webhook[[huggingface_hub.HfApi.update_webhook]]

```python
update_webhook(webhook_id: str, url: str | None = None, job_id: str | None = None, watched: list[dict | WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T], secret: str | None = None, secrets: dict[str, str] | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L11323)

**المعاملات:**

webhook_id (`str`) : المعرّف الفريد لخطاف الويب (webhook) الذي سيتم تحديثه.

url (`str`، اختياري) : عنوان URL الذي سيتم إرسال الحمولة إليه.

job_id (`str`، اختياري) : معرّف مهمة المصدر التي سيتم تشغيلها عبر حمولة webhook. مطلوب عند تعيين `secrets`.

watched (`list[WebhookWatchedItem]`) : قائمة العناصر المراد مراقبتها. يمكن أن تكون هذه العناصر مستخدمين أو منظمات أو نماذج أو مجموعات بيانات أو مساحات. راجع [WebhookWatchedItem](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookWatchedItem) لمزيد من التفاصيل. كما يمكن تقديم العناصر المراد مراقبتها على شكل قواميس بسيطة.

domains (`list[Literal["repo", "discussion"]]`) : المجالات المراد مراقبتها. يمكن أن يتضمن ذلك "repo" أو "discussion" أو كلاهما.

secret (`str`، اختياري) : سرٌّ يُستخدم لتوقيع الحمولة، مما يوفر طبقة أمان إضافية.

secrets (`dict[str, str]`, اختياري) : متغيرات البيئة السرية الخاصة بالمهمة التي يُطلقها خطاف الويب. تحل المفاتيح المدرجة محل القيمة المخزنة، ويؤدي السلسلة الفارغة إلى إزالة ذلك السر، وتحتفظ المفاتيح غير المدرجة بقيمتها المخزنة. يتطلب `job_id`.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** [WebhookInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookInfo)

معلومات حول خطاف الويب المحدّث.

تحديث خطاف ويب (webhook) موجود مسبقًا.

مرّر القائمة الكاملة للمُراقَب، والمجالات وجهة الوصول، بما في ذلك القيم التي لم تتغير. قدّم بالضبط واحدًا من `url` أو `job_id`.

مثال:
```python
>>> from huggingface_hub import update_webhook
>>> updated_payload = update_webhook(
...     webhook_id="654bbbc16f2ec14d77f109cc",
...     url="https://new.webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
...     watched=[{"type": "user", "name": "julien-c"}, {"type": "org", "name": "HuggingFaceH4"}],
...     domains=["repo"],
...     secret="my-secret",
... )
>>> print(updated_payload)
WebhookInfo(
    id="654bbbc16f2ec14d77f109cc",
    job=None,
    url="https://new.webhook.site/a2176e82-5720-43ee-9e06-f91cb4c91548",
    watched=[WebhookWatchedItem(type="user", name="julien-c"), WebhookWatchedItem(type="org", name="HuggingFaceH4")],
    domains=["repo"],
    secret="my-secret",
    disabled=False,
```

#### upload_attachment[[huggingface_hub.HfApi.upload_attachment]]

```python
upload_attachment(path: str | Path, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8005)

**المعاملات:**

path (`str` أو `Path`) : المسار إلى الملف المراد رفعه. الصيغ المدعومة هي PNG وJPEG وGIF وWebP وMP4 وMOV وWebM وMP3 وWAV. يجب أن تكون الملفات أصغر من 10 ميغابايت (50 ميغابايت للفيديوهات).

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). يحتاج الرمز إلى إذن `discussion.write`. للرفع بشكل مجهول، مرر `False`.

**يعيد:** `str`

عنوان URL للملف المرفوع.

**يرفع:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا لم يكن تنسيق الملف مدعومًا.

يرفع صورة أو ملف فيديو أو صوت إلى Hub ويعيد عنوان URL الخاص به.

هذا ما يقوم به محرر الويب الخاص بـ Hub عند سحب ملف إلى مربع تعليق في نقاش أو طلب سحب. اضمّن الرابط المُعاد في وصف أو تعليق: `![alt text](url)` لصورة، والرابط الصريح لفيديو، و`<audio controls src="url"></audio>` لملف صوتي.

مثال:
```python
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> url = api.upload_attachment("screenshot.png")
>>> api.create_discussion("username/my-model", title="Rendering bug", description=f"![screenshot]({url})")
```

#### upload_file[[huggingface_hub.HfApi.upload_file]]

```python
upload_file(path_or_fileobj: str | Path | bytes | BinaryIO, path_in_repo: str, repo_id: str, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, commit_message: str | None = None, commit_description: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None, run_as_future: bool = False, _hot_reload: bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L5626)

**المعاملات:**

path_or_fileobj (`str` أو `Path` أو `bytes` أو `IO`) : مسار ملف على الجهاز المحلي أو تدفق بيانات ثنائية / fileobj / buffer.

path_in_repo (`str`) : مسار الملف النسبي في المستودع، على سبيل المثال: `"checkpoints/1fec34a/weights.bin"`

repo_id (`str`) : المستودع الذي سيتم رفع الملف إليه، على سبيل المثال: `"username/custom_transformers"`

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` أو `"kernel"` عند الرفع إلى مستودع مجموعة بيانات أو مساحة أو نواة، أو على `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

commit_message (`str`، *اختياري*) : الملخص / العنوان / السطر الأول للالتزام المولّد

commit_description (`str`، *اختياري*) : وصف التثبيت المولّد

create_pr (`boolean`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب (Pull Request) مع ذلك الالتزام أم لا. القيمة الافتراضية هي `False`. إذا لم يتم تعيين `revision`، يُفتح طلب السحب ضد الفرع `"main"`. إذا تم تعيين `revision` وكان فرعًا، يُفتح طلب السحب ضد هذا الفرع. إذا تم تعيين `revision` ولم يكن اسم فرع (مثال: معرف التزام)، يُرجع الخادم `RevisionNotFoundError`.

parent_commit (`str`, *اختياري*) : معرف OID / SHA للالتزام الأب، كسلسلة سداسية عشرية. يتم دعم الاختصارات (الأحرف السبعة الأولى) أيضًا. إذا تم تحديده وكان `create_pr` هو `False`، فسيفشل الالتزام إذا لم يشير `revision` إلى `parent_commit`. إذا تم تحديده وكان `create_pr` هو `True`، فسيتم إنشاء طلب السحب من `parent_commit`. يضمن تحديد `parent_commit` عدم تغيير المستودع قبل الالتزام بالتغييرات، وقد يكون مفيدًا بشكل خاص إذا تم تحديث المستودع / الالتزام به بشكل متزامن.

run_as_future (`bool`, *اختياري*) : ما إذا كان سيتم تنفيذ هذه الطريقة في الخلفية أم لا. تُنفَّذ مهام الخلفية بشكل تسلسلي دون تعطيل الخيط الرئيسي. تمرير `run_as_future=True` سيعيد كائن [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects). القيمة الافتراضية هي `False`.

**يعيد:** [CommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitInfo) أو `Future`

مثال من [CommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitInfo) يحتوي على معلومات حول الالتزام الجديد الذي تم إنشاؤه (تجزئة الالتزام، رابط الالتزام، رابط طلب الدمج، رسالة الالتزام، ...). إذا تم تمرير `run_as_future=True`، تُرجع كائن Future الذي سيحتوي على النتيجة عند التنفيذ.

ارفع ملفًا محليًا (حتى 50 جيجابايت) إلى المستودع المحدد. يتم الرفع عبر طلب HTTP post، ولا يتطلب تثبيت git أو git-lfs.

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة بعض المعاملات غير صالحة - [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) إذا تعذر العثور على المستودع الذي سيتم التنزيل منه. قد يكون ذلك بسبب عدم وجوده، أو لأنه مُعدّ كـ`private` ولا تملك صلاحية الوصول إليه. - [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) إذا تعذر العثور على الإصدار الذي سيتم التنزيل منه.

> [!WARNING]
> `upload_file` يفترض أن المستودع موجود مسبقًا على Hub. إذا واجهت خطأ Client 404، فتأكد من أنك مسجّل الدخول، وأن رمزك (token) يحمل الصلاحيات المطلوبة، وأن `repo_id` و`repo_type` مضبوطة بشكل صحيح. إذا لم يكن المستودع موجودًا، أنشئه أولًا باستخدام [create_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_repo).

مثال:

```python
>>> from huggingface_hub import upload_file

>>> with open("./local/filepath", "rb") as fobj:
...     upload_file(
...         path_or_fileobj=fileobj,
...         path_in_repo="remote/file/path.h5",
...         repo_id="username/my-dataset",
...         repo_type="dataset",
...         token="my_token",
...     )

>>> upload_file(
...     path_or_fileobj=".\\local\\file\\path",
...     path_in_repo="remote/file/path.h5",
...     repo_id="username/my-model",
...     token="my_token",
... )

>>> upload_file(
...     path_or_fileobj=".\\local\\file\\path",
...     path_in_repo="remote/file/path.h5",
...     repo_id="username/my-model",
...     token="my_token",
...     create_pr=True,
... )
```

#### upload_folder[[huggingface_hub.HfApi.upload_folder]]

```python
upload_folder(repo_id: str, folder_path: str | Path, path_in_repo: str | None = None, commit_message: str | None = None, commit_description: str | None = None, token: str | bool | None = None, repo_type: str | None = None, revision: str | None = None, create_pr: bool | None = None, parent_commit: str | None = None, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, delete_patterns: list[str] | str | None = None, run_as_future: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L5813)

**المعاملات:**

repo_id (`str`) : المستودع الذي سيتم رفع الملف إليه، على سبيل المثال: `"username/custom_transformers"`

folder_path (`str` أو `Path`) : المسار إلى المجلد الذي سيتم رفعه على نظام الملفات المحلي

path_in_repo (`str`, *اختياري*) : المسار النسبي للمجلد في المستودع، على سبيل المثال: `"checkpoints/1fec34a/results"`. سيُستخدم المجلد الجذري للمستودع افتراضيًا.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

repo_type (`str`, *اختياري*) : اضبطه على `"dataset"` أو `"space"` أو `"kernel"` عند الرفع إلى مستودع مجموعة بيانات أو مساحة أو نواة، أو على `None` أو `"model"` عند الرفع إلى نموذج. القيمة الافتراضية هي `None`.

revision (`str`، *اختياري*) : المراجعة (revision) في git التي سيتم الالتزام منها. الافتراضي هو رأس فرع `"main"`.

commit_message (`str`، *اختياري*) : الملخص / العنوان / السطر الأول للالتزام المولّد. الافتراضي هو: `f"Upload {path_in_repo} with huggingface_hub"`

commit_description (`str` *اختياري*) : وصف التثبيت المولّد

create_pr (`boolean`, *اختياري*) : ما إذا كان سيتم إنشاء طلب سحب (Pull Request) مع ذلك الالتزام. القيمة الافتراضية هي `False`. يُفتح طلب السحب دائمًا مقابل الفرع الافتراضي: فإعداد كل من `create_pr=True` و`revision` يثير `ValueError`. لاحظ أن كل استدعاء مع `create_pr=True` يفتح طلب سحب جديدًا: لاستئناف رفعٍ مُقاطَع إلى طلب السحب الموجود، أعد التشغيل مع `revision="refs/pr/N"` بدلاً من ذلك.

parent_commit (`str`, *اختياري*) : معرف OID / SHA للالتزام الأب، كسلسلة سداسية عشرية. يتم دعم الاختصارات (الأحرف السبعة الأولى) أيضًا. إذا تم تحديد هذا المعامل وكان `create_pr` هو `False`، فسيُفشل الالتزام إذا لم يُشير `revision` إلى `parent_commit`. يضمن تحديد `parent_commit` عدم تغيّر المستودع قبل الالتزام بالتغييرات، وقد يكون مفيدًا بشكل خاص إذا تم تحديث المستودع / الالتزام به بشكل متزامن. إذا تم تقسيم الرفع إلى عدة التزامات (مجلدات كبيرة)، فإن `parent_commit` ينطبق على الالتزام الأول فقط.

allow_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، تُحمَّل فقط الملفات التي تطابق نمطًا واحدًا على الأقل.

ignore_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، فإن الملفات المطابقة لأي من الأنماط لن يتم رفعها.

delete_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، سيتم حذف الملفات البعيدة المطابقة لأي من الأنماط من المستودع أثناء تثبيت الملفات الجديدة. هذا مفيد إذا كنت لا تعرف أي الملفات تم رفعها بالفعل. ملاحظة: لتجنب الاختلافات، لن يتم حذف ملف `.gitattributes` حتى لو كان يطابق النمط.

run_as_future (`bool`, *اختياري*) : ما إذا كان سيتم تنفيذ هذه الطريقة في الخلفية أم لا. تُنفَّذ مهام الخلفية بشكل تسلسلي دون تعطيل الخيط الرئيسي. تمرير `run_as_future=True` سيعيد كائن [Future](https://docs.python.org/3/library/concurrent.futures.html#future-objects). القيمة الافتراضية هي `False`.

**يعيد:** [CommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitInfo) أو `Future`

مثال من [CommitInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitInfo) يحتوي على معلومات حول الالتزام الجديد الذي تم إنشاؤه (تجزئة الالتزام، رابط الالتزام، رابط طلب الدمج، رسالة الالتزام، ...). إذا تم تمرير `run_as_future=True`، تُرجع كائن Future الذي سيحتوي على النتيجة عند التنفيذ.

ارفع مجلدًا محليًا إلى المستودع المحدد. يتم الرفع من خلال طلبات HTTP، ولا يتطلب تثبيت git أو git-lfs.

سيتم الحفاظ على هيكل المجلد. سيتم استبدال الملفات الموجودة مسبقًا في المستودع والتي تحمل نفس الاسم. أما الملفات الأخرى فستُترك دون تغيير.

استخدم الحججين `allow_patterns` و`ignore_patterns` لتحديد الملفات المراد رفعها. تقبل هذه المعاملات نمطًا واحدًا أو قائمة بأنماط. الأنماط هي برمجيات كروية قياسية (أنماط globbing) كما هو موثق [هنا](https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm). إذا تم تقديم كل من `allow_patterns` و`ignore_patterns`، فإن كلا القيدين يسريان. افتراضيًا، يتم رفع جميع الملفات من المجلد.

استخدم الحجة `delete_patterns` لتحديد الملفات البعيدة التي تريد حذفها. نوع الإدخال هو نفسه الخاص بـ `allow_patterns` (انظر أعلاه). إذا تم تقديم `path_in_repo` أيضًا، فإن الأنماط تُطابق المسارات النسبية لهذا المجلد. على سبيل المثال، `upload_folder(..., path_in_repo="experiment", delete_patterns="logs/*")` سيحذف أي ملف بعيد تحت `./experiment/logs/`. لاحظ أن ملف `.gitattributes` لن يُحذف حتى لو تطابق مع الأنماط.

سيتم تجاهل أي مجلد `.git/` موجود في أي مجلد فرعي. ومع ذلك، يرجى الانتباه إلى أن ملف `.gitignore` لا يُؤخذ في الاعتبار.

عند تثبيت `hf_xet` (وهو الإعداد الافتراضي)، تُرفع الملفات عبر خط أنابيب متدفق: تبدأ عمليات الرفع بينما لا يزال يتم فحص المجلد مقابل Hub، وتُحسب تجزئة الملفات أثناء تقسيمها للرفع (مرحلة قراءة واحدة)، وتُلتزم المجلدات الكبيرة تلقائيًا في عدة دفعات للبقاء ضمن حدود الخادم (تحصل الالتزامات اللاحقة على لاحقة ` (part N)` في رسالة الالتزام). إذا انقطع الرفع، فإن إعادة تنفيذ نفس الاستدعاء يستأنفه: يتم تخطي الملفات التي تم الالتزام بها مسبقًا، ويتم إزالة التكرار من البيانات التي تم رفعها مسبقًا. عند عدم تثبيت `hf_xet`، يتم الرجوع إلى التزام واحد يُنشأ باستخدام [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit).

> [!TIP]
> يرفع الأخطاء التالية:
>
> - [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError) إذا أعادت واجهة HuggingFace البرمجية خطأً - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) إذا كانت قيمة أحد المعاملات غير صالحة

> [!WARNING]
> `upload_folder` يفترض أن المستودع موجود مسبقًا على Hub. إذا واجهت خطأ Client 404، فتأكد من أنك مسجّل الدخول، وأن رمزك (token) يحمل الصلاحيات المطلوبة، وأن `repo_id` و`repo_type` مضبوطة بشكل صحيح. إذا لم يكن المستودع موجودًا، أنشئه أولًا باستخدام [create_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_repo).

مثال:

```python
# Upload checkpoints folder except the log files
>>> upload_folder(
...     folder_path="local/checkpoints",
...     path_in_repo="remote/experiment/checkpoints",
...     repo_id="username/my-dataset",
...     repo_type="datasets",
...     token="my_token",
...     ignore_patterns="**/logs/*.txt",
... )

# Upload checkpoints folder including logs while deleting existing logs from the repo
# Useful if you don't know exactly which log files have already being pushed
>>> upload_folder(
...     folder_path="local/checkpoints",
...     path_in_repo="remote/experiment/checkpoints",
...     repo_id="username/my-dataset",
...     repo_type="datasets",
...     token="my_token",
...     delete_patterns="**/logs/*.txt",
... )

# Upload checkpoints folder while creating a PR
>>> upload_folder(
...     folder_path="local/checkpoints",
...     path_in_repo="remote/experiment/checkpoints",
...     repo_id="username/my-dataset",
...     repo_type="datasets",
...     token="my_token",
...     create_pr=True,
... )
```

#### verify_repo_checksums[[huggingface_hub.HfApi.verify_repo_checksums]]

```python
verify_repo_checksums(repo_id: str, repo_type: str | None = None, revision: str | None = None, local_dir: str | Path | None = None, cache_dir: str | Path | None = None, token: str | bool | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L4040)

**المعاملات:**

repo_id (`str`) : مساحة أسماء (مستخدم أو منظمة) واسم مستودع مفصولان بـ `/`.

repo_type (`str`, *اختياري*) : نوع المستودع الذي سيتم منه جلب الشجرة (`"model"` أو `"dataset"` أو `"space"`. القيمة الافتراضية هي `"model"`.

revision (`str`، *اختياري*) : المراجعة (revision) للمستودع الذي سيتم منه جلب الشجرة. القيمة الافتراضية هي الفرع `"main"`.

local_dir (`str` أو `Path`، *اختياري*) : المجلد المحلي الذي يجب التحقق منه.

cache_dir (`str` أو `Path`، *اختياري*) : مجلد التخزين المؤقت الذي يجب التحقق منه.

token (Union[bool, str, None], اختياري) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

**يعيد:** `FolderVerification`

نتيجة منظمة تحتوي على تفاصيل التحقق.

**يرفع:** [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) أو [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError)

- [RepositoryNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RepositoryNotFoundError) -- إذا لم يتم العثور على المستودع (خطأ 404): معرف المستودع repo_id أو نوع المستودع repo_type غير صحيح، أو المستودع خاص وغير مصادق عليه، أو المستودع غير موجود.
- [RevisionNotFoundError](/docs/huggingface_hub/main/ar/package_reference/utilities#huggingface_hub.errors.RevisionNotFoundError) -- إذا لم يتم العثور على المراجعة (خطأ 404) في المستودع.

تحقق من الملفات المحلية لمستودع مقابل قيم التجزئة (Checksums) الخاصة بالمستودع على Hugging Face Hub.

#### wait_for_job[[huggingface_hub.HfApi.wait_for_job]]

```python
wait_for_job(job_id: str | list[str], timeout: float | None = None, poll_interval: float = 1.0, stages: list[JobStage] | None = None, namespace: str | None = None, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L12643)

**المعاملات:**

job_id (`str` أو `list[str]`) : معرّف المهمة، أو قائمة بمعرّفات المهام التي يجب الانتظار لها. إذا تم تمرير قائمة، يُعاد قائمة من [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo) (بنفس الترتيب).

timeout (`float`، *اختياري*) : الحد الأقصى للوقت الذي يجب انتظاره حتى تنتهي المهمة (المهام)، بالثواني. إذا كان `None`، فسيتم الانتظار إلى ما لا نهاية.

poll_interval (`float`، *اختياري*) : المدة التي يجب الانتظار بينها وبين كل فحص للحالة، بالثواني. القيمة الافتراضية هي 1 ثانية.

stages (`list[JobStage]`، *اختياري*) : المراحل التي يجب الانتظار حتى بلوغها. الافتراضي هو المراحل النهائية (`"COMPLETED"`، `"CANCELED"`، `"ERROR"`، `"DELETED"`). مرّر على سبيل المثال `[JobStage.RUNNING]` للانتظار حتى يبدأ تشغيل المهمة. تتوقف عملية الانتظار دائمًا عند المراحل النهائية بغض النظر عن هذه القيمة.

namespace (`str`، *اختياري*) : مساحة الاسم التي تعمل فيها المهمة (المهام). الافتراضي هو مساحة اسم المستخدم الحالي.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. إذا لم يُقدَّم، فسيُستخدم رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع: https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo) أو `list[JobInfo]`

معلومات Job النهائية.

**يرفع:** ``TimeoutError``

- ``TimeoutError`` -- إذا لم يصل أي Job واحد على الأقل إلى إحدى المراحل المستهدفة بعد `timeout` ثانية.

انتظر حتى تصل مهمة أو أكثر من مهام الحوسبة على بنية Hugging Face التحتية إلى مرحلة محددة.

يتم استطلاع حالة كل مهمة (باستخدام [inspect_job()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.inspect_job)) كل `poll_interval` ثانية حتى تصبح مرحلتها إحدى `stages` (المراحل النهائية افتراضيًا: `"COMPLETED"`، `"CANCELED"`، `"ERROR"` أو `"DELETED"`). يتم إرجاع [JobInfo](/docs/huggingface_hub/main/ar/package_reference/jobs#huggingface_hub.JobInfo) النهائي في جميع الحالات: لا ترمي المهمة الفاشلة أو الملغاة استثناءً **على الإطلاق** — تحقق من `job.status.stage` للتعامل مع النتيجة.

توقف المراحل النهائية دائمًا انتظارًا، حتى لو لم تُذكر في `stages`. وهذا يتجنب الانتظار إلى الأبد لمراحل لن يصل إليها Job أبدًا (مثل انتظار `"RUNNING"` لـ Job يفشل أثناء الجدولة).

مثال:

```python
>>> from huggingface_hub import run_job, wait_for_job
>>> job = run_job(image="python:3.12", command=["python", "-c", "print('Hello from HF compute!')"])
>>> wait_for_job(job_id=job.id).status.stage
'COMPLETED'
```

#### wait_for_space[[huggingface_hub.HfApi.wait_for_space]]

```python
wait_for_space(repo_id: str, timeout: float | None = None, poll_interval: float = 1.0, token: bool | str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L8808)

**المعاملات:**

repo_id (`str`) : معرّف مساحة (Space) يجب الانتظار لها. مثال: `"username/my-space"`.

timeout (`float`، *اختياري*) : الحد الأقصى للوقت الذي يجب الانتظار به بالثواني. إذا كان `None`، فسيتم الانتظار إلى ما لا نهاية.

poll_interval (`float`، *اختياري*) : عدد الثواني بين فحوصات الحالة. القيمة الافتراضية هي 1 ثانية.

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح. الافتراضي هو رمز الوصول المحفوظ محليًا، وهو طريقة المصادقة الموصى بها. اضبطه على `False` لتعطيل المصادقة. راجع https://huggingface.co/docs/huggingface_hub/quick-start#authentication.

**يعيد:** [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime)

معلومات وقت التشغيل النهائية عندما يصل المساحة إلى مرحلة نهائية.

**يرفع:** ``TimeoutError``

- ``TimeoutError`` -- إذا لم يصل المساحة إلى مرحلة نهائية بعد `timeout` ثانية.

انتظر حتى يصل Space إلى مرحلة نهائية (غير قيد البناء/البدء).

تستطلع [get_space_runtime()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_space_runtime) كل `poll_interval` ثانية حتى لم يعد مرحلة الـ Space وسيطة (`BUILDING`، `RUNNING_BUILDING`، `APP_STARTING`، `RUNNING_APP_STARTING`). تُرجع [SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime) النهائية في جميع الحالات — تحقق من `runtime.stage` للتعامل مع النتيجة (مثل `RUNNING` مقابل `BUILD_ERROR`).

مثال:

```python
>>> from huggingface_hub import restart_space, wait_for_space
>>> restart_space("username/my-space")
>>> runtime = wait_for_space("username/my-space")
>>> runtime.stage
'RUNNING'
```

#### whoami[[huggingface_hub.HfApi.whoami]]

```python
whoami(token: bool | str | None = None, cache: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L2223)

**المعاملات:**

token (`bool` أو `str`، *اختياري*) : رمز وصول مستخدم صالح (نص). الافتراضي هو رمز الوصول المحفوظ محليًا، وهو الطريقة الموصى بها للمصادقة (انظر https://huggingface.co/docs/huggingface_hub/quick-start#authentication). لتعطيل المصادقة، مرر `False`.

cache (`bool`, *اختياري*) : ما إذا كان سيتم تخزين نتيجة استدعاء `whoami` للاستخدام في الاستدعاءات اللاحقة. إذا حدث خطأ أثناء الاستدعاء الأول، فلن يتم تخزينه. القيمة الافتراضية هي `False`.

استدعاء واجهة HF البرمجية لمعرفة "من أنا".

إذا مررت `cache=True`، فسيتم تخزين النتيجة مؤقتًا للاستدعاءات اللاحقة طوال مدة عملية بايثون. وهذا مفيد إذا كنت تخطط لاستدعاء `whoami` عدة مرات، إذ إن هذا الطرفي (endpoint) يخضع لقيود معدل صارمة لأسباب أمنية.

## بيانات واجهة برمجة التطبيقات

### AccessRequest[[huggingface_hub.hf_api.AccessRequest]]

#### huggingface_hub.hf_api.AccessRequest[[huggingface_hub.hf_api.AccessRequest]]

```python
huggingface_hub.hf_api.AccessRequest(username: str | None, request_id: str, fullname: str | None, email: str | None, timestamp: datetime, status: Literal['pending', 'accepted', 'rejected'], fields: dict[str, Any] | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L446)

**المعاملات:**

username (`str`, *اختياري*) : اسم المستخدم الذي طلب الوصول. `None` إذا كان المستودع مُهيأً بحيث لا يشارك أسماء المستخدمين الذين يقدمون الطلبات. في هذه الحالة، استخدم `request_id` لقبول الطلب أو رفضه أو إلغائه.

request_id (`str`) : معرّف طلب الوصول. يُعيَّن دائمًا، حتى إذا لم يتم مشاركة اسم المستخدم.

fullname (`str`، *اختياري*) : الاسم الكامل للمستخدم الذي طلب الوصول. `None` إذا كان المستودع مُهيأً بحيث لا يشارك أسماء المستخدمين الذين يقدمون الطلبات.

email (`str`، *اختياري*) : بريد المستخدم الذي طلب الوصول. `None` إذا تم منح المستخدم الوصول يدويًا أو إذا كان المستودع مُهيأً بحيث لا يُشارك بريدات طالبي الوصول.

timestamp (`datetime`) : طابع زمني للطلب.

status (`Literal["pending", "accepted", "rejected"]`) : حالة الطلب. يمكن أن تكون واحدة من `["pending", "accepted", "rejected"]`.

fields (`dict[str, Any]`، *اختياري*) : حقول إضافية يملأها المستخدم في نموذج البوابة.

هيكل بيانات يحتوي على معلومات حول طلب وصول مستخدم.

### BucketFile[[huggingface_hub.BucketFile]]

#### huggingface_hub.BucketFile[[huggingface_hub.BucketFile]]

```python
huggingface_hub.BucketFile(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_buckets.py#L197)

تحتوي على معلومات حول ملف في دلو على Hub. يُعاد هذا الكائن بواسطة [list_bucket_tree()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_bucket_tree).

مشابه لـ [RepoFile](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.RepoFile) ولكن للملفات الموجودة في الدلاء.

### BucketFileMetadata[[huggingface_hub.BucketFileMetadata]]

#### huggingface_hub.BucketFileMetadata[[huggingface_hub.BucketFileMetadata]]

```python
huggingface_hub.BucketFileMetadata(size: int, xet_file_data: XetFileData)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_buckets.py#L140)

**المعاملات:**

size (`int`) : حجم الملف بالبايت.

xet_file_data (`XetFileData`) : معلومات Xet الخاصة بالملف (التجزئة ومسار التحديث).

هيكل بيانات يحتوي على معلومات حول ملف في دلو.

تُعاد بواسطة [get_bucket_file_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_bucket_file_metadata).

### BucketInfo[[huggingface_hub.BucketInfo]]

#### huggingface_hub.BucketInfo[[huggingface_hub.BucketInfo]]

```python
huggingface_hub.BucketInfo(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_buckets.py#L65)

**المعاملات:**

id (`str`) : معبّر عن معرف الدلو.

private (`bool`) : هل الحاوية خاصة.

created_at (`datetime`) : تاريخ إنشاء الدلو على Hub.

size (`int`) : حجم الدلو بالبايت.

total_files (`int`) : العدد الإجمالي للملفات في الدلو.

تحتوي على معلومات حول دلو في Hub. يُعاد هذا الكائن بواسطة [bucket_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.bucket_info) و [list_buckets()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_buckets).

### BucketUrl[[huggingface_hub.BucketUrl]]

#### huggingface_hub.BucketUrl[[huggingface_hub.BucketUrl]]

```python
huggingface_hub.BucketUrl(url: str, endpoint: str = '')
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_buckets.py#L157)

**المعاملات:**

url (`str`) : القيمة النصية لعنوان bucket.

endpoint (`str`، *اختياري*) : نقطة نهاية Hub. القيمة الافتراضية هي .

يصف رابط دلو على Hub.

`BucketUrl` هو ما يُعاد بواسطة [create_bucket()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_bucket). عند التهيئة، يتم تحليل الرابط (URL) لملء الخصائص:
- endpoint (`str`)
- namespace (`str`)
- bucket_id (`str`)
- url (`str`)
- uri (`HfUri`)

### DatasetLeaderboardEntry[[huggingface_hub.DatasetLeaderboardEntry]]

#### huggingface_hub.DatasetLeaderboardEntry[[huggingface_hub.DatasetLeaderboardEntry]]

```python
huggingface_hub.DatasetLeaderboardEntry(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1953)

**المعاملات:**

rank (`int`) : ترتيب النموذج على لوحة الصدارة (مفهرس من 1).

model_id (`str`) : معرّف النموذج (مثل `"meta-llama/Llama-3-8b"`).

value (`float`) : قيمة درجة التقييم.

filename (`str`) : اسم ملف النتيجة الذي يحتوي على بيانات التقييم.

verified (`bool`) : ما إذا كان قد تم التحقق من النتيجة.

source (`dict[str, Any]`، *اختياري*) : معلومات حول مصدر نتيجة التقييم. يحتوي على مفاتيح مثل `"url"` و`"name"` و`"isExternal"`. لا تحتوي جميع الإدخالات على مصدر.

author (`User` أو `Organization`) : مؤلف النموذج، يُحلَّل بناءً على حقل `"type"` في استجابة الواجهة البرمجية.

pull_request (`int`, *اختياري*) : رقم طلب الإرسال المرتبط بإدراج لوحة الصدارة، إن وُجد.

notes (`str`، *اختياري*) : ملاحظات مرتبطة بإدراج لوحة الصدارة، إن وُجدت.

تحتوي على معلومات عن إدخال واحد في لوحة صدارة مجموعة بيانات على Hub.

ترتّب لوحة الصدارة النماذج بناءً على درجات تقييمها على مجموعة بيانات مرجعية محددة. يُعاد هذا الكائن بواسطة [get_dataset_leaderboard()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_dataset_leaderboard). للحصول على نتائج التقييم لنموذج معين عبر معايير مرجعية متعددة، راجع `ModelInfo.eval_results` (عبر [model_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.model_info) مع `expand=["evalResults"]`) و [EvalResultEntry](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.EvalResultEntry).

### EvalResultEntry[[huggingface_hub.EvalResultEntry]]

#### huggingface_hub.EvalResultEntry[[huggingface_hub.EvalResultEntry]]

```python
huggingface_hub.EvalResultEntry(dataset_id: str, task_id: str, value: typing.Any, dataset_revision: str | None = None, verify_token: str | None = None, date: str | None = None, source_url: str | None = None, source_name: str | None = None, source_user: str | None = None, source_org: str | None = None, notes: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_eval_results.py#L17)

**المعاملات:**

dataset_id (`str`) : معرّف مجموعة بيانات الاختبار من Hub. مثال: "cais/hle"، "Idavidrein/gpqa".

task_id (`str`) : معرّف المهمة ضمن مجموعة الاختبار. مثال: "gpqa_diamond".

value (`Any`) : قيمة المقياس. مثال: 20.90.

dataset_revision (`str`، *اختياري*) : معرف SHA الخاص بـ Git لمجموعة بيانات الاختبار.

verify_token (`str`، *اختياري*) : توقيع يمكن استخدامه لإثبات أن التقييم قابل للتدقيق والتكرار بشكل قاطع.

date (`str`، *اختياري*) : وقت تشغيل التقييم (تاريخ ووقت بصيغة ISO-8601). القيمة الافتراضية هي وقت آخر التزامن (commit) في git.

source_url (`str`، *اختياري*) : رابط إلى مصدر التقييم (مثل https://huggingface.co/spaces/SaylorTwift/smollm3-mmlu-pro). مطلوب إذا تم تقديم `source_name` أو `source_user` أو `source_org`.

source_name (`str`، *اختياري*) : الاسم المعروض للمصدر. مثال: "Eval Logs".

source_user (`str`، *اختياري*) : اسم مستخدم HF للنسبة. مثال: "celinah".

source_org (`str`، *اختياري*) : اسم منظمة HF للنسبة. مثال: "cais".

notes (`str`, *optional*) : Details about the evaluation setup. Example: "tools", "no-tools", "chain-of-thought".

عنصر نتيجة التقييم لتنسيق `.eval_results/*.yaml`.

يمثل درجات التقييم المخزنة في مستودعات النماذج والتي تظهر تلقائيًا على صفحة النموذج ولوحة صدارة مجموعة بيانات المعيار.

بالنسبة إلى تنسيق `model-index` القديم في `README.md`، استخدم [EvalResult](/docs/huggingface_hub/main/ar/package_reference/cards#huggingface_hub.EvalResult) بدلاً من ذلك.

راجع https://huggingface.co/docs/hub/eval-results لمزيد من التفاصيل.

مثال:
```python
>>> from huggingface_hub import EvalResultEntry
>>> # Minimal example with required fields only
>>> result = EvalResultEntry(
...     dataset_id="Idavidrein/gpqa",
...     task_id="gpqa_diamond",
...     value=0.412,
... )
>>> # Full example with all fields
>>> result = EvalResultEntry(
...     dataset_id="cais/hle",
...     task_id="default",
...     value=20.90,
...     dataset_revision="5503434ddd753f426f4b38109466949a1217c2bb",
...     verify_token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
...     date="2025-01-15T10:30:00Z",
...     source_url="https://huggingface.co/datasets/cais/hle",
...     source_name="CAIS HLE",
...     source_org="cais",
...     notes="no-tools",
... )

```

### SyncOperation[[huggingface_hub.SyncOperation]]

#### huggingface_hub.SyncOperation[[huggingface_hub.SyncOperation]]

```python
huggingface_hub.SyncOperation(action: typing.Literal['upload', 'download', 'delete', 'skip'], path: str, size: int | None = None, reason: str = '', local_mtime: str | None = None, remote_mtime: str | None = None, bucket_file: huggingface_hub._buckets.BucketFile | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_buckets.py#L289)

يمثل عملية مزامنة يجب تنفيذها.

### SyncPlan[[huggingface_hub.SyncPlan]]

#### huggingface_hub.SyncPlan[[huggingface_hub.SyncPlan]]

```python
huggingface_hub.SyncPlan(source: str, dest: str, timestamp: str, operations: list = <factory>)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_buckets.py#L302)

يمثل خطة مزامنة كاملة.

### CommitInfo[[huggingface_hub.CommitInfo]]

#### huggingface_hub.CommitInfo[[huggingface_hub.CommitInfo]]

```python
huggingface_hub.CommitInfo(commit_url: str, *args, **kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L363)

**المعاملات:**

commit_url (`str`) : عنوان الرابط الذي يمكن من خلاله العثور على الالتزام.

commit_message (`str`) : ملخص (السطر الأول) للالتزام الذي تم إنشاؤه.

commit_description (`str`) : وصف الالتزام الذي تم إنشاؤه. يمكن أن يكون فارغًا.

oid (`str`) : معرّف تجزئة الالتزام. مثال: `"91c54ad1727ee830252e457677f467be0bfd8a57"`.

pr_url (`str`, *اختياري*) : عنوان رابط طلب الإرسال (PR) الذي تم إنشاؤه، إن وُجد. يُعبأ عند تمرير `create_pr=True`.

pr_revision (`str`, *اختياري*) : نسخة من طلب الإرسال الذي تم إنشاؤه، إن وُجد. يُعبأ عند تمرير `create_pr=True`. مثال: `"refs/pr/1"`.

pr_num (`int`, *اختياري*) : رقم نقاش طلب الإرسال الذي تم إنشاؤه، إن وُجد. يُعبأ عند تمرير `create_pr=True`. يمكن تمريره كـ `discussion_num` في [get_discussion_details()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_discussion_details). مثال: `1`.

repo_url (`RepoUrl`) : عنوان مستودع (Repo URL) للالتزام (commit) الذي يحتوي على معلومات مثل repo_id و repo_type وغيرها.

هيكل بيانات يحتوي على معلومات حول التزامن الجديد الذي تم إنشاؤه.

تُعاد بواسطة أي طريقة تنشئ التزامًا على Hub: [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit)، [upload_file()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.upload_file)، [upload_folder()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.upload_folder)، [delete_file()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.delete_file)، [delete_folder()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.delete_folder). ترث من `str` من أجل التوافق مع الإصدارات السابقة، لكن استخدام طرق خاصة بـ `str` أصبح غير موصى به.

### DatasetInfo[[huggingface_hub.DatasetInfo]]

#### huggingface_hub.DatasetInfo[[huggingface_hub.DatasetInfo]]

```python
huggingface_hub.DatasetInfo(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1014)

**المعاملات:**

id (`str`) : معرّف مجموعة البيانات.

author (`str`) : مؤلف مجموعة البيانات.

card_data (`DatasetCardData`، *اختياري*) : بيانات وصفية لبطاقة مجموعة البيانات ككائن [huggingface_hub.repocard_data.DatasetCardData](/docs/huggingface_hub/main/ar/package_reference/cards#huggingface_hub.DatasetCardData).

citation (`str`، *اختياري*) : معلومات الاستشهاد للبيانات.

created_at (`datetime`، *اختياري*) : تاريخ إنشاء المستودع على Hub. لاحظ أن أدنى قيمة هي `2022-03-02T23:29:04.000Z`، والتي تتوافق مع التاريخ الذي بدأنا فيه بتخزين تواريخ الإنشاء.

description (`str`، *اختياري*) : وصف مجموعة البيانات.

disabled (`bool`، *اختياري*) : هل المستودع معطّل.

downloads (`int`) : عدد مرات تنزيل مجموعة البيانات خلال آخر 30 يومًا.

downloads_all_time (`int`) : العدد التراكمي لتنزيلات مجموعة البيانات منذ إنشائها.

gated (`Literal["auto", "manual", False]`، *اختياري*) : هل المستودع محمي؟ وإذا كان كذلك، ما نوع الموافقة المطلوبة: يدوية أو تلقائية.

last_modified (`datetime`، *اختياري*) : تاريخ آخر التزام (commit) في المستودع.

likes (`int`) : عدد الإعجابات بالبيانات.

main_size (`int`، *اختياري*) : حجم الفرع الرئيسي للبيانات بالبايت.

paperswithcode_id (`str`، *اختياري*) : معرف بيانات Papers with code الخاص بالبيانات.

private (`bool`) : ما إذا كان المستودع خاصًا.

resource_group (`dict`، *اختياري*) : معلومات مجموعة الموارد للمجموعة البيانات.

sha (`str`) : معرف SHA المستودع في هذا المراجعة المحددة.

siblings (`list[RepoSibling]`) : قائمة من كائنات [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) التي تُشكّل مجموعة البيانات.

tags (`list[str]`) : قائمة بوسوم مجموعة البيانات.

trending_score (`int`، *اختياري*) : درجة اتجاه مجموعة البيانات.

used_storage (`int`، *اختياري*) : حجم مجموعة البيانات على Hub بالبايت.

تحتوي على معلومات حول مجموعة بيانات على Hub. يُعاد هذا الكائن بواسطة [dataset_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) و [list_datasets()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_datasets).

> [!TIP]
> معظم خصائص هذه الفئة اختيارية. يعود السبب إلى أن البيانات التي يعيدها Hub تعتمد على الاستعلام المُدخل. بشكل عام، كلما كان الاستعلام أكثر تحديدًا، زادت المعلومات المُعادَة. على العكس من ذلك، عند سرد مجموعات البيانات باستخدام [list_datasets()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_datasets)، لا تُعاد سوى مجموعة فرعية من الخصائص.

### DryRunFileInfo[[huggingface_hub.DryRunFileInfo]]

#### huggingface_hub.DryRunFileInfo[[huggingface_hub.DryRunFileInfo]]

```python
huggingface_hub.DryRunFileInfo(commit_hash: str, file_size: int | None, filename: str, local_path: str, is_cached: bool, will_download: bool)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/file_download.py#L182)

**المعاملات:**

commit_hash (`str`) : commit_hash المرتبط بالملف.

file_size (`int`، *اختياري*) : حجم الملف، إذا كان معروفًا. في حالة ملف LFS، يحتوي على حجم ملف LFS الفعلي، وليس المؤشر.

filename (`str`) : اسم الملف في المستودع.

is_cached (`bool`) : ما إذا كان الملف مخزّنًا مؤقتًا محليًا بالفعل.

will_download (`bool`) : ما إذا كان الملف سيُحمَّل عند استدعاء `hf_hub_download` مع `dry_run=False`. عمليًا، تكون قيمة will_download هي `True` إذا لم يكن الملف مخزَّنًا مؤقتًا أو إذا كان `force_download=True`.

المعلومات المُعاد عند إجراء تجربة جافة لتنزيل ملف.

تُعاد بواسطة [hf_hub_download()](/docs/huggingface_hub/main/ar/package_reference/file_download#huggingface_hub.hf_hub_download) عندما يكون `dry_run=True`.

### DuplicatedRepoUrl[[huggingface_hub.DuplicatedRepoUrl]]

#### huggingface_hub.DuplicatedRepoUrl[[huggingface_hub.DuplicatedRepoUrl]]

```python
huggingface_hub.DuplicatedRepoUrl(url: Any, endpoint: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L595)

**المعاملات:**

files_copy_pending (`bool`) : `True` إذا كانت ملفات LFS/Xet المستودع الجديد لا تزال قيد النسخ في الخلفية. حتى اكتمال عملية النسخ، قد يفشل تنزيل هذه الملفات.

[RepoUrl](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.RepoUrl) الذي يُرجعه [duplicate_repo()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.duplicate_repo).

### GitRefInfo[[huggingface_hub.GitRefInfo]]

#### huggingface_hub.GitRefInfo[[huggingface_hub.GitRefInfo]]

```python
huggingface_hub.GitRefInfo(name: str, ref: str, target_commit: str)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1449)

**المعاملات:**

name (`str`) : اسم المرجع (مثل اسم وسم أو اسم فرع).

ref (`str`) : مرجع git كامل على Hub (مثل `"refs/heads/main"` أو `"refs/tags/v1.0"`).

target_commit (`str`) : المعرّف (OID) للالتزام المستهدف للإشارة (ref) (على سبيل المثال `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)

تحتوي على معلومات حول مرجع git لمستودع على Hub.

### GitCommitInfo[[huggingface_hub.GitCommitInfo]]

#### huggingface_hub.GitCommitInfo[[huggingface_hub.GitCommitInfo]]

```python
huggingface_hub.GitCommitInfo(commit_id: str, authors: list[str], created_at: datetime, title: str, message: str, formatted_title: str | None, formatted_message: str | None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1494)

**المعاملات:**

commit_id (`str`) : معرف OID للالتزام (مثلًا `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)

authors (`list[str]`) : قائمة بمؤلفي هذا الالتزام.

created_at (`datetime`) : التاريخ والوقت الذي تم فيه إنشاء الالتزام.

title (`str`) : عنوان الالتزام. هذه قيمة نص حر يُدخلها المؤلفون.

message (`str`) : وصف الالتزام. هذه قيمة نص حر يُدخلها المؤلفون.

formatted_title (`str`) : عنوان الالتزام منسقًا بصيغة HTML. يُعاد فقط إذا تم تعيين `formatted=True`.

formatted_message (`str`) : وصف الالتزام منسّقًا بصيغة HTML. يُعاد فقط إذا تم تعيين `formatted=True`.

تحتوي على معلومات حول التزامن (commit) في مستودع على Hub. راجع [list_repo_commits()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_repo_commits) لمزيد من التفاصيل.

### GitRefs[[huggingface_hub.GitRefs]]

#### huggingface_hub.GitRefs[[huggingface_hub.GitRefs]]

```python
huggingface_hub.GitRefs(branches: list[GitRefInfo], converts: list[GitRefInfo], tags: list[GitRefInfo], pull_requests: list[GitRefInfo] | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1468)

**المعاملات:**

branches (`list[GitRefInfo]`) : قائمة من [GitRefInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.GitRefInfo) تحتوي على معلومات حول الفروع في المستودع.

converts (`list[GitRefInfo]`) : قائمة من [GitRefInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.GitRefInfo) تحتوي على معلومات حول مراجع "convert" في المستودع. المراجع المُحوَّلة هي مراجع تُستخدم (داخليًا) لدفع البيانات المُعالجة مسبقًا في مستودعات Dataset.

tags (`list[GitRefInfo]`) : قائمة من [GitRefInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.GitRefInfo) تحتوي على معلومات حول الوسوم في المستودع.

pull_requests (`list[GitRefInfo]`، *اختياري*) : قائمة من [GitRefInfo](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.GitRefInfo) تحتوي على معلومات حول طلبات الدمج في المستودع. يُعاد فقط إذا تم تعيين `include_prs=True`.

يتضمن معلومات حول جميع مراجع git الخاصة بمستودع على Hub.

يُعاد الكائن بواسطة [list_repo_refs()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_repo_refs).

### InferenceProviderMapping[[huggingface_hub.hf_api.InferenceProviderMapping]]

#### huggingface_hub.hf_api.InferenceProviderMapping[[huggingface_hub.hf_api.InferenceProviderMapping]]

```python
huggingface_hub.hf_api.InferenceProviderMapping(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L774)

### KernelInfo[[huggingface_hub.KernelInfo]]

#### huggingface_hub.KernelInfo[[huggingface_hub.KernelInfo]]

```python
huggingface_hub.KernelInfo(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1290)

**المعاملات:**

id (`str`) : معرف مستودع النواة.

author (`str`، *اختياري*) : مؤلف مستودع النواة.

downloads (`int`, *اختياري*) : عدد تنزيلات مستودع النواة خلال آخر 30 يومًا.

gated (`Literal["auto", "manual", False]`، *اختياري*) : هل المستودع محمي؟ وإذا كان كذلك، ما نوع الموافقة المطلوبة: يدوية أو تلقائية.

last_modified (`datetime`، *اختياري*) : تاريخ آخر التزام (commit) في المستودع.

likes (`int`, *اختياري*) : عدد الإعجابات بمستودع النواة.

private (`bool`، *اختياري*) : هل المستودع خاص.

sha (`str`، *اختياري*) : SHA المستودع عند هذا المراجعة المحددة.

تحتوي على معلومات حول مستودع نواة على Hub. يُعاد هذا الكائن بواسطة [kernel_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.kernel_info).

### LFSFileInfo[[huggingface_hub.hf_api.LFSFileInfo]]

#### huggingface_hub.hf_api.LFSFileInfo[[huggingface_hub.hf_api.LFSFileInfo]]

```python
huggingface_hub.hf_api.LFSFileInfo(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1892)

**المعاملات:**

file_oid (`str`) : معرّف SHA-256 الخاص بالملف. هذا هو المعرّف الذي يجب تمريره عند حذف الملف بشكل دائم.

filename (`str`) : اسم الملف المحتمل لكائن LFS. راجع الملاحظة أعلاه لمزيد من المعلومات.

oid (`str`) : معرف OID لكائن LFS.

pushed_at (`datetime`) : التاريخ الذي تم فيه دفع كائن LFS إلى المستودع.

ref (`str`، *اختياري*) : المرجع الذي تم دفع كائن LFS إليه (إن وُجد).

size (`int`) : حجم كائن LFS.

تحتوي على معلومات حول ملف مخزّن بصيغة LFS في مستودع على Hub.

يُستخدم في سياق سرد ملفات LFS من مستودع وحذفها بشكل دائم لتحرير المساحة. راجع [list_lfs_files()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_lfs_files) و [permanently_delete_lfs_files()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.permanently_delete_lfs_files) لمزيد من التفاصيل.

تُتتبع ملفات Git LFS باستخدام معرّفات كائنات SHA-256 بدلاً من مسارات الملفات، وذلك لتحسين الأداء. هذا النهج ضروري لأن كائناً واحداً يمكن أن يُشار إليه عبر مسارات متعددة في التزامات المختلفة، مما يجعل البحث عن هذه الروابط وحلّها غير عملي. اطّلع على [توثيقنا](https://huggingface.co/docs/hub/storage-limits#advanced-track-lfs-file-references) لمعرفة كيفية تحديد اسم الملف أو أسماء الملفات المرتبطة بكل SHA.

مثال:
```py
>>> from huggingface_hub import HfApi
>>> api = HfApi()
>>> lfs_files = api.list_lfs_files("username/my-cool-repo")

# Filter files to delete based on a combination of `filename`, `pushed_at`, `ref` or `size`.
# e.g. select only LFS files in the "checkpoints" folder
>>> lfs_files_to_delete = (lfs_file for lfs_file in lfs_files if lfs_file.filename.startswith("checkpoints/"))

# Permanently delete LFS files
>>> api.permanently_delete_lfs_files("username/my-cool-repo", lfs_files_to_delete)
```

### ModelInfo[[huggingface_hub.ModelInfo]]

#### huggingface_hub.ModelInfo[[huggingface_hub.ModelInfo]]

```python
huggingface_hub.ModelInfo(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L799)

**المعاملات:**

id (`str`) : معرّف النموذج.

author (`str`، *اختياري*) : مؤلف النموذج.

base_models (`list[str]`، *اختياري*) : قائمة بنماذج الأساس التي اشتُقت منها هذه النموذج.

card_data (`ModelCardData`، *اختياري*) : بيانات وصفية لبطاقة النموذج على شكل كائن [huggingface_hub.repocard_data.ModelCardData](/docs/huggingface_hub/main/ar/package_reference/cards#huggingface_hub.ModelCardData).

children_model_count (`int`, *اختياري*) : عدد النماذج الفرعية المشتقة من هذا النموذج.

config (`dict`، *اختياري*) : تكوين النموذج.

created_at (`datetime`، *اختياري*) : تاريخ إنشاء المستودع على Hub. لاحظ أن أدنى قيمة هي `2022-03-02T23:29:04.000Z`، والتي تتوافق مع التاريخ الذي بدأنا فيه بتخزين تواريخ الإنشاء.

disabled (`bool`، *اختياري*) : هل المستودع معطّل.

downloads (`int`) : عدد تنزيلات النموذج خلال آخر 30 يومًا.

downloads_all_time (`int`) : إجمالي عدد تنزيلات النموذج منذ إنشائه.

eval_results (`list[EvalResultEntry]`، *اختياري*) : نتائج تقييم النموذج.

gated (`Literal["auto", "manual", False]`، *اختياري*) : هل المستودع محمي؟ وإذا كان كذلك، ما نوع الموافقة المطلوبة: يدوية أو تلقائية.

gguf (`dict`، *اختياري*) : معلومات GGUF الخاصة بالنموذج.

inference (`Literal["warm"]`، *اختياري*) : حالة النموذج لدى مزوّدي الاستدلال. تكون الحالة "دافئة" إذا كان النموذج مقدَّمًا من قِبل مزوّد واحد على الأقل.

inference_provider_mapping (`list[InferenceProviderMapping]`، *اختياري*) : قائمة من `InferenceProviderMapping` مرتبة وفقًا لترتيب مزوّد المستخدم.

last_modified (`datetime`، *اختياري*) : تاريخ آخر التزام (commit) في المستودع.

library_name (`str`، *اختياري*) : المكتبة المرتبطة بالنموذج.

likes (`int`) : عدد الإعجابات بالنموذج.

mask_token (`str`، *اختياري*) : رمز القناع الذي يستخدمه النموذج.

model_index (`dict`، *اختياري*) : فهرس النموذج للتقييم.

pipeline_tag (`str`، *اختياري*) : وسم خط الأنابيب المرتبط بالنموذج.

private (`bool`) : ما إذا كان المستودع خاصًا.

resource_group (`dict`، *اختياري*) : معلومات مجموعة الموارد للنموذج.

safetensors (`SafeTensorsInfo`، *اختياري*) : معلومات safetensors الخاصة بالنموذج.

security_repo_status (`dict`، *اختياري*) : حالة فحص الأمان للنموذج.

sha (`str`، *اختياري*) : SHA المستودع عند هذا المراجعة المحددة.

siblings (`list[RepoSibling]`) : قائمة من كائنات [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) التي تُشكّل النموذج.

spaces (`list[str]`، *اختياري*) : قائمة بالمسافات التي تستخدم النموذج.

tags (`list[str]`) : قائمة بوسوم النموذج. مقارنةً بـ `card_data.tags`، تحتوي على وسوم إضافية يحسبها Hub (مثل المكتبات المدعومة، وورقة arXiv الخاصة بالنموذج).

transformers_info (`TransformersInfo`، *اختياري*) : معلومات خاصة بـ Transformers (فئة تلقائية، معالج، إلخ) مرتبطة بالنموذج.

trending_score (`int`، *اختياري*) : درجة اتجاه النموذج.

used_storage (`int`، *اختياري*) : حجم النموذج على Hub بالبايت.

widget_data (`Any`، *اختياري*) : بيانات الودجت المرتبطة بالنموذج.

تحتوي على معلومات حول نموذج على Hub. يُعاد هذا الكائن بواسطة [model_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.model_info) و [list_models()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_models).

> [!TIP]
> معظم خصائص هذه الفئة اختيارية. يعود السبب إلى أن البيانات التي يعيدها Hub تعتمد على الاستعلام المُدخل. بشكل عام، كلما كان الاستعلام أكثر تحديدًا، زادت المعلومات المُعادَة. على العكس من ذلك، عند سرد النماذج باستخدام [list_models()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_models)، لا تُعاد سوى مجموعة فرعية من الخصائص.

### RepoSibling[[huggingface_hub.hf_api.RepoSibling]]

#### huggingface_hub.hf_api.RepoSibling[[huggingface_hub.hf_api.RepoSibling]]

```python
huggingface_hub.hf_api.RepoSibling(rfilename: str, size: int | None = None, blob_id: str | None = None, lfs: BlobLfsInfo | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L649)

**المعاملات:**

rfilename (str) : اسم الملف، نسبيًا لجذر المستودع.

size (`int`, *اختياري*) : حجم الملف، بالبايت. يُعرَّف هذا السمة عندما يُضبط معامل `files_metadata` في [repo_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.repo_info) على `True`. وإلا فهو `None`.

blob_id (`str`, *اختياري*) : معرف git OID للملف. يُعرَّف هذا السمة عندما يُضبط معامل `files_metadata` في [repo_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.repo_info) على `True`. وإلا فهو `None`.

lfs (`BlobLfsInfo`, *اختياري*) : بيانات LFS الوصفية للملف. يُعرَّف هذا السمة عندما يكون الحجة `files_metadata` في [repo_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.repo_info) مضبوطًا على `True` ويُخزَّن الملف باستخدام Git LFS. وإلا فهو `None`.

تحتوي على معلومات أساسية حول ملف مستودع داخل مستودع على Hub.

> [!TIP]
> جميع خصائص هذه الفئة اختيارية باستثناء `rfilename`. والسبب في ذلك هو أن أسماء الملفات فقط هي ما يُعاد عند سرد المستودعات على Hub (باستخدام [list_models()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_models) أو [list_datasets()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_datasets) أو [list_spaces()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_spaces)). إذا كنت بحاجة إلى مزيد من المعلومات مثل حجم الملف أو معرّف blob أو تفاصيل lfs، فيجب عليك طلبها بشكل محدد من مستودع واحد في كل مرة (باستخدام [model_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.model_info) أو [dataset_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.dataset_info) أو [space_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.space_info)) لأن ذلك يفرض قيوداً إضافية على خادم الخلفية لاسترجاع هذه البيانات.

### RepoFile[[huggingface_hub.RepoFile]]

#### huggingface_hub.RepoFile[[huggingface_hub.RepoFile]]

```python
huggingface_hub.RepoFile(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L681)

**المعاملات:**

path (str) : مسار الملف النسبي لجذر المستودع.

size (`int`) : حجم الملف، بالبايت.

blob_id (`str`) : معرف git OID الخاص بالملف.

lfs (`BlobLfsInfo`، *اختياري*) : بيانات LFS الوصفية للملف.

xet_hash (`str`، *اختياري*) : تجزئة Xet الخاصة بالملف.

last_commit (`LastCommitInfo`، *اختياري*) : بيانات الوصف (البيانات الوصفية) لآخر التزامن للملف. يُعرَّف فقط إذا تم استدعاء [list_repo_tree()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_repo_tree) و [get_paths_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_paths_info) مع `expand=True`.

security (`BlobSecurityInfo`، *اختياري*) : بيانات وصفية لمسح الأمان الخاص بالملف. يُعرَّف فقط إذا تم استدعاء [list_repo_tree()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_repo_tree) و [get_paths_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_paths_info) مع `expand=True`.

تحتوي على معلومات حول ملف على Hub.

### RepoUrl[[huggingface_hub.RepoUrl]]

#### huggingface_hub.RepoUrl[[huggingface_hub.RepoUrl]]

```python
huggingface_hub.RepoUrl(url: Any, endpoint: str | None = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L528)

**المعاملات:**

url (`Any`) : قيمة نصية لعنوان المستودع.

endpoint (`str`، *اختياري*) : نقطة نهاية Hub. القيمة الافتراضية هي .

**يرفع:** `HfUriError`

- `HfUriError` -- إذا تعذّر تحليل عنوان URL (مثل مستودع أحادي المقطع قياسي، أو `repo_type` غير معروف).

فئة فرعية من `str` تصف عنوان URL مستودع على Hub.

`RepoUrl` يُعاد بواسطة `HfApi.create_repo`. وهو يرث من `str` من أجل التوافق مع الإصدارات السابقة. عند التهيئة، يتم تحليل الرابط لتعبئة الخصائص:
- endpoint (`str`)
- namespace (`str`)
- repo_name (`str`)
- repo_id (`str`)
- repo_type (`Literal["model", "dataset", "space"]`)
- url (`str`)

مثال:
```py
>>> RepoUrl('https://huggingface.co/openai-community/gpt2')
RepoUrl('https://huggingface.co/openai-community/gpt2', endpoint='https://huggingface.co', repo_type='model', repo_id='openai-community/gpt2')

>>> RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co')
RepoUrl('https://hub-ci.huggingface.co/datasets/dummy_user/dummy_dataset', endpoint='https://hub-ci.huggingface.co', repo_type='dataset', repo_id='dummy_user/dummy_dataset')

>>> RepoUrl('hf://datasets/my-user/my-dataset')
RepoUrl('hf://datasets/my-user/my-dataset', endpoint='https://huggingface.co', repo_type='dataset', repo_id='user/dataset')

>>> HfApi.create_repo("dummy_model")
RepoUrl('https://huggingface.co/Wauplin/dummy_model', endpoint='https://huggingface.co', repo_type='model', repo_id='Wauplin/dummy_model')
```

### SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]]

#### huggingface_hub.utils.SafetensorsRepoMetadata[[huggingface_hub.utils.SafetensorsRepoMetadata]]

```python
huggingface_hub.utils.SafetensorsRepoMetadata(metadata: dict | None, sharded: bool, weight_map: dict, files_metadata: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_safetensors.py#L74)

**المعاملات:**

metadata (`dict`، *اختياري*) : البيانات الوصفية الموجودة في ملف 'model.safetensors.index.json'، إذا كان موجودًا. يُعبأ فقط للنماذج المجزأة.

sharded (`bool`) : ما إذا كان المستودع يحتوي على نموذج مقسّم إلى أجزاء أم لا.

weight_map (`dict[str, str]`) : خريطة لجميع الأوزان. المفاتيح هي أسماء المصفوفات (tensors) والقيم هي أسماء الملفات التي تحتوي على المصفوفات.

files_metadata (`dict[str, SafetensorsFileMetadata]`) : خريطة لجميع بيانات وصفية الملفات. المفاتيح هي أسماء الملفات والقيم هي البيانات الوصفية للملف المقابل، ككائن `SafetensorsFileMetadata`.

parameter_count (`dict[str, int]`) : خريطة لعدد المعاملات لكل نوع بيانات. المفاتيح هي أنواع البيانات والقيم هي عدد المعاملات من ذلك النوع.

بيانات وصفية لخزّان Safetensors.

يُعتبر المستودع مستودع Safetensors إذا احتوى على ملف الأوزان 'model.safetensors' (نموذج غير مشترك) أو ملف الفهرس 'model.safetensors.index.json' (نموذج مقسّم) في جذره.

تُعاد هذه الفئة بواسطة [get_safetensors_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.get_safetensors_metadata).

لمزيد من التفاصيل حول صيغة safetensors، راجع https://huggingface.co/docs/safetensors/index#format.

### SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]]

#### huggingface_hub.utils.SafetensorsFileMetadata[[huggingface_hub.utils.SafetensorsFileMetadata]]

```python
huggingface_hub.utils.SafetensorsFileMetadata(metadata: dict, tensors: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_safetensors.py#L44)

**المعاملات:**

metadata (`dict`) : البيانات الوصفية الموجودة في الملف.

tensors (`dict[str, TensorInfo]`) : خريطة لجميع المتجهات. المفاتيح هي أسماء المتجهات والقيم هي معلومات عن المتجه المقابل، ككائن `TensorInfo`.

parameter_count (`dict[str, int]`) : خريطة لعدد المعاملات لكل نوع بيانات. المفاتيح هي أنواع البيانات والقيم هي عدد المعاملات من ذلك النوع.

بيانات وصفية لملف Safetensors مستضاف على Hub.

تُعاد هذه الفئة بواسطة [parse_safetensors_file_metadata()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.parse_safetensors_file_metadata).

لمزيد من التفاصيل حول صيغة safetensors، راجع https://huggingface.co/docs/safetensors/index#format.

### SpaceInfo[[huggingface_hub.SpaceInfo]]

#### huggingface_hub.SpaceInfo[[huggingface_hub.SpaceInfo]]

```python
huggingface_hub.SpaceInfo(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1148)

**المعاملات:**

id (`str`) : معرّف المساحة.

author (`str`، *اختياري*) : مؤلف المساحة.

card_data (`SpaceCardData`، *اختياري*) : بيانات وصفية لبطاقة المساحة ككائن [huggingface_hub.repocard_data.SpaceCardData](/docs/huggingface_hub/main/ar/package_reference/cards#huggingface_hub.SpaceCardData).

created_at (`datetime`، *اختياري*) : تاريخ إنشاء المستودع على Hub. لاحظ أن أدنى قيمة هي `2022-03-02T23:29:04.000Z`، والتي تتوافق مع التاريخ الذي بدأنا فيه بتخزين تواريخ الإنشاء.

datasets (`list[str]`، *اختياري*) : قائمة بمجموعات البيانات التي يستخدمها المساحة.

disabled (`bool`، *اختياري*) : هل المساحة معطّلة.

gated (`Literal["auto", "manual", False]`، *اختياري*) : هل المستودع محمي؟ وإذا كان كذلك، ما نوع الموافقة المطلوبة: يدوية أو تلقائية.

host (`str`، *اختياري*) : عنوان مضيف المساحة.

last_modified (`datetime`، *اختياري*) : تاريخ آخر التزام (commit) في المستودع.

likes (`int`) : عدد الإعجابات بالمساحة.

models (`list[str]`، *اختياري*) : قائمة بالنماذج التي يستخدمها المساحة.

private (`bool`) : ما إذا كان المستودع خاصًا.

region (`Literal["us", "eu"]`، *اختياري*) : منطقة السحابة التي يُخزَّن فيها المساحة.

resource_group (`dict`، *اختياري*) : معلومات مجموعة الموارد الخاصة بالمساحة.

runtime (`SpaceRuntime`، *اختياري*) : معلومات وقت تشغيل المساحة ككائن [huggingface_hub.hf_api.SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime).

sdk (`str`، *اختياري*) : SDK المستخدم في المساحة.

sha (`str`، *اختياري*) : SHA المستودع عند هذا المراجعة المحددة.

siblings (`list[RepoSibling]`) : قائمة من كائنات [huggingface_hub.hf_api.RepoSibling](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.hf_api.RepoSibling) التي تُشكّل المساحة (Space).

subdomain (`str`، *اختياري*) : النطاق الفرعي للمساحة.

tags (`list[str]`) : قائمة بوسوم المساحة.

trending_score (`int`، *اختياري*) : درجة الترند الخاصة بالمساحة.

used_storage (`int`، *اختياري*) : حجم المساحة على Hub بالبايت.

visibility (`Literal["public", "private", "protected"]`، *اختياري*) : مدى ظهور المساحة. على عكس `private`، يُميّز هذا بين المساحات الخاصة والمساحات المحمية. متاح للمساحات فقط (وليس للنماذج أو مجموعات البيانات أو الدلاء).

تحتوي على معلومات حول مساحة على Hub. يُعاد هذا الكائن بواسطة [space_info()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.space_info) و [list_spaces()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_spaces).

> [!TIP]
> معظم خصائص هذه الفئة اختيارية. يعود السبب إلى أن البيانات التي يعيدها Hub تعتمد على الاستعلام المُدخل. بشكل عام، كلما كان الاستعلام أكثر تحديدًا، زادت المعلومات المُعادَة. على العكس من ذلك، عند سرد المساحات باستخدام [list_spaces()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.list_spaces)، لا تُعاد سوى مجموعة فرعية من الخصائص.

### SpaceSearchResult[[huggingface_hub.SpaceSearchResult]]

#### huggingface_hub.SpaceSearchResult[[huggingface_hub.SpaceSearchResult]]

```python
huggingface_hub.SpaceSearchResult(data: dict)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_space_api.py#L309)

**المعاملات:**

id (`str`) : معرّف المساحة (Space) (مثل `"username/repo-name"`).

author (`str`) : صاحب المساحة.

title (`str`) : عنوان عرض المساحة.

emoji (`str` أو `None`) : أيقونة الإيموجي الخاصة بالمساحة.

sdk (`str` أو `None`) : واجهة برمجة التطبيقات (SDK) المستخدمة في المساحة (مثل `"gradio"`، `"docker"`، `"static"`).

likes (`int`) : عدد الإعجابات.

private (`bool`) : ما إذا كان المساحة (Space) خاصة.

tags (`list[str]` أو `None`) : قائمة من الوسوم.

runtime ([SpaceRuntime](/docs/huggingface_hub/main/ar/package_reference/space_runtime#huggingface_hub.SpaceRuntime) أو `None`) : معلومات وقت التشغيل (المرحلة، العتاد، إلخ).

ai_short_description (`str` أو `None`) : وصف قصير مولّد بالذكاء الاصطناعي.

ai_category (`str` أو `None`) : فئة مولّدة بالذكاء الاصطناعي (مثل `"Image Generation"`).

semantic_relevancy_score (`float` أو `None`) : درجة الصلة الدلالية (0-1) نسبةً إلى استعلام البحث.

trending_score (`int` أو `None`) : درجة الاتجاه.

نتيجة واحدة من واجهة برمجة التطبيقات (API) للبحث الدلالي في Spaces.

تُعاد بواسطة [HfApi.search_spaces()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.search_spaces).

### TensorInfo[[huggingface_hub.utils.TensorInfo]]

#### huggingface_hub.utils.TensorInfo[[huggingface_hub.utils.TensorInfo]]

```python
huggingface_hub.utils.TensorInfo(dtype: typing.Literal['F64', 'F32', 'F16', 'BF16', 'I64', 'I32', 'I16', 'I8', 'U8', 'U3', 'BOOL'], shape: list, data_offsets: tuple)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/utils/_safetensors.py#L14)

**المعاملات:**

dtype (`str`) : نوع البيانات الخاص بالمصفوفة ("F64", "F32", "F16", "BF16", "I64", "I32", "I16", "I8", "U8", "U3", "BOOL").

shape (`list[int]`) : شكل المصفوفة.

data_offsets (`tuple[int, int]`) : إزاحات البيانات في الملف على شكل مجموعة مرتبة `[BEGIN, END]`.

parameter_count (`int`) : عدد المعاملات في الموتر.

معلومات حول متجه (Tensor).

لمزيد من التفاصيل حول صيغة safetensors، راجع https://huggingface.co/docs/safetensors/index#format.

### المستخدم[[huggingface_hub.User]]

#### huggingface_hub.User[[huggingface_hub.User]]

```python
huggingface_hub.User(**kwargs)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1663)

**المعاملات:**

username (`str`) : اسم المستخدم على Hub (فريد).

fullname (`str`) : الاسم الكامل للمستخدم.

avatar_url (`str`) : عنوان URL لصورة المستخدم الرمزية.

details (`str`، *اختياري*) : تفاصيل المستخدم.

is_following (`bool`، *اختياري*) : ما إذا كان المستخدم الموثّق يتابع هذا المستخدم.

is_pro (`bool`، *اختياري*) : ما إذا كان المستخدم مستخدمًا محترفًا.

num_models (`int`, *اختياري*) : عدد النماذج التي أنشأها المستخدم.

num_datasets (`int`، *اختياري*) : عدد مجموعات البيانات التي أنشأها المستخدم.

num_spaces (`int`، *اختياري*) : عدد المساحات التي أنشأها المستخدم.

num_discussions (`int`, *اختياري*) : عدد النقاشات التي بدأها المستخدم.

num_papers (`int`, *اختياري*) : عدد الأوراق البحثية التي كتبها المستخدم.

num_upvotes (`int`, *اختياري*) : عدد الأصوات الإيجابية التي حصل عليها المستخدم.

num_likes (`int`، *اختياري*) : عدد الإعجابات التي منحها المستخدم.

num_following (`int`, *اختياري*) : عدد المستخدمين الذين يتابعهم هذا المستخدم.

num_followers (`int`, *اختياري*) : عدد المستخدمين الذين يتابعون هذا المستخدم.

orgs (قائمة من `Organization`) : قائمة بالمنظمات التي ينتمي إليها المستخدم.

تحتوي على معلومات حول مستخدم على Hub.

### UserLikes[[huggingface_hub.UserLikes]]

#### huggingface_hub.UserLikes[[huggingface_hub.UserLikes]]

```python
huggingface_hub.UserLikes(user: str, total: int, datasets: list[str], kernels: list[str], models: list[str], spaces: list[str])
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L1527)

**المعاملات:**

user (`str`) : اسم المستخدم الذي تم جلب الإعجابات الخاصة به.

total (`int`) : إجمالي عدد الإعجابات.

datasets (`list[str]`) : قائمة بمجموعات البيانات التي أعجب بها المستخدم (بصيغة repo_ids).

kernels (`list[str]`) : قائمة بالنواة التي أعجب بها المستخدم (بصيغة repo_ids).

models (`list[str]`) : قائمة بالنماذج التي أعجب بها المستخدم (بصيغة repo_ids).

spaces (`list[str]`) : قائمة بالمساحات التي أعجب بها المستخدم (بصيغة repo_ids).

تحتوي على معلومات حول الإعجابات التي يضيفها المستخدم على المنصة.

### WebhookInfo[[huggingface_hub.WebhookInfo]]

#### huggingface_hub.WebhookInfo[[huggingface_hub.WebhookInfo]]

```python
huggingface_hub.WebhookInfo(id: str, url: str | None, job: JobSpec | None, watched: list[WebhookWatchedItem], domains: list[constants.WEBHOOK_DOMAIN_T], secret: str | None, disabled: bool)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L497)

**المعاملات:**

id (`str`) : المعرّف الخاص بـ webhook.

url (`str`، *اختياري*) : عنوان URL الخاص بـ webhook.

job (`JobSpec`، *اختياري*) : مواصفات المهمة التي سيتم تشغيلها.

watched (`list[WebhookWatchedItem]`) : قائمة العناصر التي يراقبها خطاف الويب، انظر إلى [WebhookWatchedItem](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.WebhookWatchedItem).

domains (`list[WEBHOOK_DOMAIN_T]`) : قائمة النطاقات التي يراقبها خطاف الويب. يمكن أن يكون أحد `["repo", "discussion"]`.

secret (`str`، *اختياري*) : سرّ خطّ الويب (webhook).

disabled (`bool`) : ما إذا كان خطاف الويب معطلاً أم لا.

هيكل بيانات يحتوي على معلومات حول خطاف ويب.

يتم تحديد أحد `url` أو `job`، وليس كلاهما معًا.

### WebhookWatchedItem[[huggingface_hub.WebhookWatchedItem]]

#### huggingface_hub.WebhookWatchedItem[[huggingface_hub.WebhookWatchedItem]]

```python
huggingface_hub.WebhookWatchedItem(type: Literal['bucket', 'dataset', 'model', 'org', 'space', 'user'], name: str)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py#L481)

**المعاملات:**

type (`Literal["bucket", "dataset", "model", "org", "space", "user"]`) : نوع العنصر المراد مراقبته. يمكن أن يكون أحد `["bucket", "dataset", "model", "org", "space", "user"]`.

name (`str`) : اسم العنصر المراد مراقبته. يمكن أن يكون اسم المستخدم، أو اسم المؤسسة، أو اسم النموذج، أو اسم مجموعة البيانات، أو اسم المساحة، أو اسم الدلو.

هيكل بيانات يحتوي على معلومات حول العناصر التي راقبها خطاف الويب.

## CommitOperation[[huggingface_hub.CommitOperationAdd]]

فيما يلي القيم المدعومة لـ `CommitOperation()`:

#### huggingface_hub.CommitOperationAdd[[huggingface_hub.CommitOperationAdd]]

```python
huggingface_hub.CommitOperationAdd(path_in_repo: str, path_or_fileobj: str | pathlib.Path | bytes | typing.BinaryIO)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_api.py#L141)

**المعاملات:**

path_in_repo (`str`) : مسار الملف النسبي في المستودع، على سبيل المثال: `"checkpoints/1fec34a/weights.bin"`

path_or_fileobj (`str`، `Path`، `bytes`، أو `BinaryIO`) : إما: - مسار إلى ملف محلي (بصيغة `str` أو `pathlib.Path`) للرفع - مخزن من البايتات (`bytes`) يحتوي على محتوى الملف المراد رفعه - "كائن ملف" (فئة فرعية من `io.BufferedIOBase`)، يُحصل عليه عادةً باستخدام `open(path, "rb")`. يجب أن يدعم طريقتي `seek()` و`tell()`.

**يرفع:** ``ValueError``

- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا لم يكن `path_or_fileobj` من نوع `str` أو `Path` أو `bytes` أو `io.BufferedIOBase`.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كان `path_or_fileobj` من نوع `str` أو `Path` لكنه ليس مسارًا إلى ملف موجود.
- [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError) -- إذا كان `path_or_fileobj` من نوع `io.BufferedIOBase` لكنه لا يدعم كلًا من `seek()` و`tell()`.

هيكل بيانات يحتوي على المعلومات اللازمة لرفع ملف إلى مستودع على Hub.

#### as_file[[huggingface_hub.CommitOperationAdd.as_file]]

```python
as_file(with_tqdm: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_api.py#L223)

**المعاملات:**

with_tqdm (`bool`، *اختياري*، القيمة الافتراضية `False`) : إذا كانت القيمة True، فسيتم عرض شريط تقدم عند التكرار على كائن الملف. يعمل هذا فقط إذا كان الكائن المشابه للملف مسارًا إلى ملف. لا يتم دعم البايتات النقية أو المخازن المؤقتة.

مدير سياق يُنتج كائناً يشبه ملفاً يتيح قراءة البيانات الأساسية خلف `path_or_fileobj`.

مثال:

```python
>>> operation = CommitOperationAdd(
...        path_in_repo="remote/dir/weights.h5",
...        path_or_fileobj="./local/weights.h5",
... )
CommitOperationAdd(path_in_repo='remote/dir/weights.h5', path_or_fileobj='./local/weights.h5')

>>> with operation.as_file() as file:
...     content = file.read()

>>> with operation.as_file(with_tqdm=True) as file:
...     while True:
...         data = file.read(1024)
...         if not data:
...              break
config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]

>>> with operation.as_file(with_tqdm=True) as file:
...     httpx2.put(..., data=file)
config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s]
```

#### b64content[[huggingface_hub.CommitOperationAdd.b64content]]

```python
b64content()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_api.py#L275)

المحتوى المُرمّز بصيغة base64 الخاص بـ`path_or_fileobj`

يعيد: `bytes`

#### huggingface_hub.CommitOperationDelete[[huggingface_hub.CommitOperationDelete]]

```python
huggingface_hub.CommitOperationDelete(path_in_repo: str, is_folder: typing.Union[bool, typing.Literal['auto']] = 'auto')
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_api.py#L56)

**المعاملات:**

path_in_repo (`str`) : مسار الملف النسبي داخل المستودع، على سبيل المثال: `"checkpoints/1fec34a/weights.bin"` لملف أو `"checkpoints/1fec34a/"` لمجلد.

is_folder (`bool` أو `Literal["auto"]`، *اختياري*) : ما إذا كانت عملية الحذف تنطبق على مجلد أم لا. إذا كانت القيمة "auto"، يتم تخمين نوع المسار (ملف أو مجلد) تلقائيًا من خلال التحقق مما إذا كان المسار ينتهي بـ "/" (مجلد) أم لا (ملف). لضبط نوع المسار بشكل صريح، يمكنك تعيين `is_folder=True` أو `is_folder=False`.

هيكل بيانات يحتوي على المعلومات اللازمة لحذف ملف أو مجلد من مستودع على Hub.

#### huggingface_hub.CommitOperationCopy[[huggingface_hub.CommitOperationCopy]]

```python
huggingface_hub.CommitOperationCopy(src_path_in_repo: str, path_in_repo: str, src_revision: str | None = None, src_repo_id: str | None = None, src_repo_type: str | None = None, _src_oid: str | None = None, _dest_oid: str | None = None, _is_duplicated: bool = False)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_api.py#L87)

**المعاملات:**

src_path_in_repo (`str`) : مسار الملف النسبي داخل المستودع للملف الذي سيتم نسخه، على سبيل المثال `"checkpoints/1fec34a/weights.bin"`.

path_in_repo (`str`) : مسار الملف النسبي داخل المستودع الذي سيتم نسخ الملف إليه، على سبيل المثال `"checkpoints/1fec34a/weights_copy.bin"`.

src_revision (`str`، *اختياري*) : المراجعة (revision) الخاصة بـ git للملف الذي سيتم نسخه. يمكن أن تكون أي مراجعة git صالحة. الافتراضي هو مراجعة الالتزام (commit) المستهدفة.

src_repo_id (`str`، *اختياري*) : المستودع المصدر الذي سيتم النسخ منه (مثل `"username/source-model"`). الافتراضي هو المستودع الوجهة (نسخ داخل المستودع).

src_repo_type (`str`، *اختياري*) : نوع المستودع المصدر (`"model"`، `"dataset"` أو `"space"`). مطلوب عند تعيين `src_repo_id`.

هيكل بيانات يحتوي على المعلومات اللازمة لنسخ ملف في مستودع على Hub.

تُؤيَّد كلٌّ من ملفات LFS والملفات العادية. تُنسخ ملفات LFS على جانب الخادم، بينما تُحمَّل الملفات العادية وتُعاد رفعها كجزء من عملية الالتزام.

تُؤمَّن النسخ بين المستودعات من خلال تعيين `src_repo_id` و`src_repo_type`. وفي حالة النسخ بين المستودعات باستخدام LFS، يتم تكرار كائنات LFS إلى المستودع الوجهة قبل إنشاء الالتزام. ويتولى [create_commit()](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi.create_commit) معالجة ذلك تلقائيًا. تجدر الإشارة إلى أن النسخ بين المستودعات يعمل فقط ضمن [منطقة تخزين](https://huggingface.co/docs/hub/storage-regions) واحدة؛ إذ لا يُدعم النسخ عبر مناطق مختلفة.

ملاحظة: يمكنك دمج [CommitOperationCopy](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitOperationCopy) و [CommitOperationDelete](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitOperationDelete) لإعادة تسمية ملف LFS على Hub.

## CommitScheduler[[huggingface_hub.CommitScheduler]]

#### huggingface_hub.CommitScheduler[[huggingface_hub.CommitScheduler]]

```python
huggingface_hub.CommitScheduler(repo_id: str, folder_path: str | pathlib.Path, every: int | float = 5, path_in_repo: str | None = None, repo_type: str | None = None, revision: str | None = None, private: bool | None = None, token: str | None = None, allow_patterns: list[str] | str | None = None, ignore_patterns: list[str] | str | None = None, squash_history: bool = False, hf_api: typing.Optional[ForwardRef('HfApi')] = None)
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_scheduler.py#L30)

**المعاملات:**

repo_id (`str`) : المعرّف الخاص بالمستودع الذي سيتم الالتزام فيه.

folder_path (`str` أو `Path`) : المسار إلى المجلد المحلي الذي سيتم رفعه بانتظام.

every (`int` أو `float`، *اختياري*) : عدد الدقائق بين كل عملية تثبيت. القيمة الافتراضية هي 5 دقائق.

path_in_repo (`str`, *اختياري*) : المسار النسبي للمجلد في المستودع، على سبيل المثال: `"checkpoints/"`. الافتراضي هو المجلد الجذري للمستودع.

repo_type (`str`، *اختياري*) : نوع المستودع الذي سيتم الالتزام به. الافتراضي هو `model`.

revision (`str`، *اختياري*) : المراجعة (revision) المستودع التي سيتم الالتزام بها. الافتراضي هو `main`.

private (`bool`، *اختياري*) : ما إذا كان سيتم جعل المستودع خاصًا. إذا كان `None` (الافتراضي)، فسيكون المستودع عامًا ما لم يكن الافتراضي الخاص بالمنظمة هو الخاص. يتم تجاهل هذه القيمة إذا كان المستودع موجودًا بالفعل.

token (`str`، *اختياري*) : الرمز الذي يُستخدم للتأكيد على المستودع. الافتراضي هو الرمز المحفوظ على الجهاز.

allow_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، تُحمَّل فقط الملفات التي تطابق نمطًا واحدًا على الأقل.

ignore_patterns (`list[str]` أو `str`، *اختياري*) : إذا تم تقديمه، فإن الملفات المطابقة لأي من الأنماط لن يتم رفعها.

squash_history (`bool`، *اختياري*) : ما إذا كان سيتم ضغط سجل المستودع بعد كل التزام. القيمة الافتراضية هي `False`. يُعدّ ضغط الالتزامات مفيدًا لتجنب تدهور الأداء في المستودع عندما يكبر حجمه بشكل مفرط.

hf_api (`HfApi`، *اختياري*) : عميل [HfApi](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.HfApi) الذي يُستخدم للالتزام بالمستودع (Hub). يمكن ضبطه بإعدادات مخصصة (وكيل المستخدم، الرمز المميز، ...).

مجدول لرفع مجلد محلي إلى المستودع (Hub) على فترات منتظمة (مثل الدفع إلى المستودع كل 5 دقائق).

الطريقة الموصى بها لاستخدام المجدول هي استخدامه كمدير سياق. يضمن ذلك إيقاف المجدول بشكل صحيح وتحفيز آخر التزام عند انتهاء السكربت. يمكن أيضًا إيقاف المجدول يدويًا باستخدام طريقة `stop`. اطّلع على [دليل الرفع](https://huggingface.co/docs/huggingface_hub/guides/upload#scheduled-uploads) لمعرفة المزيد حول كيفية استخدامه.

مثال:
```py
>>> from pathlib import Path
>>> from huggingface_hub import CommitScheduler

# Scheduler uploads every 10 minutes
>>> csv_path = Path("watched_folder/data.csv")
>>> CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path=csv_path.parent, every=10)

>>> with csv_path.open("a") as f:
...     f.write("first line")

# Some time later (...)
>>> with csv_path.open("a") as f:
...     f.write("second line")
```

مثال على استخدام مدير سياق:
```py
>>> from pathlib import Path
>>> from huggingface_hub import CommitScheduler

>>> with CommitScheduler(repo_id="test_scheduler", repo_type="dataset", folder_path="watched_folder", every=10) as scheduler:
...     csv_path = Path("watched_folder/data.csv")
...     with csv_path.open("a") as f:
...         f.write("first line")
...     (...)
...     with csv_path.open("a") as f:
...         f.write("second line")

# Scheduler is now stopped and last commit have been triggered
```

#### push_to_hub[[huggingface_hub.CommitScheduler.push_to_hub]]

```python
push_to_hub()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_scheduler.py#L204)

ادفع المجلد إلى Hub وعُد بمعلومات الالتزام.

> [!WARNING]
> لا يُقصد استدعاء هذه الطريقة مباشرةً. يتم تشغيلها في الخلفية بواسطة المجدول، مع الالتزام بآلية الطابور لتجنب الالتزامات المتزامنة. قد يؤدي الاستدعاء المباشر للطريقة إلى مشاكل في التزامن.

السلوك الافتراضي لـ `push_to_hub` هو افتراض أن المجلد مخصص للإضافة فقط. يقوم该方法 بترتيب جميع الملفات في المجلد ورفع الملفات التي تم تغييرها فقط. إذا لم يتم العثور على أي تغييرات، يعيد الطريقة دون الالتزام بأي شيء. إذا كنت ترغب في تغيير هذا السلوك، يمكنك الوراثة من [CommitScheduler](/docs/huggingface_hub/main/ar/package_reference/hf_api#huggingface_hub.CommitScheduler) وتجاوز هذه الطريقة. يمكن أن يكون هذا مفيدًا، على سبيل المثال، لضغط البيانات معًا في ملف واحد قبل الالتزام. لمزيد من التفاصيل والأمثلة، راجع [دليل التكامل](https://huggingface.co/docs/huggingface_hub/main/en/guides/upload#scheduled-uploads) الخاص بنا.

#### stop[[huggingface_hub.CommitScheduler.stop]]

```python
stop()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_scheduler.py#L157)

أوقف المجدول.

لا يمكن إعادة تشغيل مجدول متوقف. يُستخدم هذا الغرض بشكل رئيسي لأغراض الاختبارات.

#### مُحفِّز[[huggingface_hub.CommitScheduler.trigger]]

```python
trigger()
```

[المصدر](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/_commit_scheduler.py#L181)

استدعاء `push_to_hub` وإرجاع مستقبلي.

يتم استدعاء هذه الطريقة تلقائيًا كل `every` دقائق. يمكنك أيضًا استدعاؤها يدويًا لتفعيل التزامن فورًا، دون انتظار التزامن المجدول التالي.