# تحذير
# تم توليد هذا الملف بالكامل من تنفيذ `hf` CLI.
# لإعادة توليد الكود، نفّذ `make style` أو `python ./utils/generate_cli_reference.py --update`.
# تحذير
-->

# `hf`

واجهة سطر أوامر Hugging Face Hub

**الاستخدام**:

```console
$ hf [OPTIONS] [COMMAND] [ARGS]...
```

**الخيارات**:

* `--skills`: اطبع ملف `hf-cli` SKILL.md إلى الإخراج القياسي (اسم آخر لـ `hf skills preview`).
* `--install-completion`: تثبيت الإكمال التلقائي للصدفة الحالية.
* `--show-completion`: يعرض إكمال الأوامر (completion) للصدفة (shell) الحالية، لنسخه أو تخصيص التثبيت.
* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `auth`: إدارة المصادقة (تسجيل الدخول، تسجيل الخروج، وما إلى ذلك).
* `buckets`: أوامر للتفاعل مع الدلاء.
* `cache`: إدارة مجلد التخزين المؤقت المحلي.
* `collections`: التفاعل مع المجموعات على Hub.
* `cp`: نسخ الملفات بين المسارات المحلية والمستودعات والدلاء.
* `datasets`: التفاعل مع مجموعات البيانات على Hub.
* `discussions`: إدارة النقاشات وطلبات الدمج على Hub.
* `download`: تنزيل الملفات من Hub.
* `endpoints`: إدارة نقاط نهاية الاستدلال في Hugging Face.
* `env`: طباعة معلومات حول البيئة.
* `extensions`: إدارة امتدادات hf CLI. [alias: ext]
* `jobs`: تشغيل وإدارة مهام على Hub.
* `lfs-enable-largefiles`: تكوين مستودعك لتفعيل رفع الملفات التي حجمها > 5 جيجابايت.
* `lfs-multipart-upload`: وكيل نقل مخصص لـ git-lfs داخلي للرفع متعدد الأجزاء.
* `models`: التفاعل مع النماذج على Hub.
* `papers`: التفاعل مع الأوراق البحثية على المنصة.
* `repos`: إدارة المستودعات على Hub.
* `sandbox`: تشغيل وإدارة بيئات تجريبية على Hugging Face Jobs.
* `skills`: إدارة المهارات للمساعدات الذكية.
* `spaces`: التفاعل مع المساحات على Hub.
* `sync`: مزامنة الملفات بين المجلد المحلي ودلو التخزين.
* `update`: حدّث واجهة `hf` الطرفية إلى أحدث إصدار.
* `upload`: رفع ملف أو مجلد إلى Hub.
* `version`: طباعة معلومات حول إصدار hf.
* `webhooks`: إدارة الخطافات البرمجية على Hub.

## `hf auth`

إدارة المصادقة (تسجيل الدخول، تسجيل الخروج، وما إلى ذلك).

**الاستخدام**:

```console
$ hf auth [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `list`: يعرض جميع رموز الوصول المخزنة. [اسم مستعار: ls]
* `login`: تسجيل الدخول من متصفحك، أو باستخدام رمز من huggingface.co/settings/tokens.
* `logout`: تسجيل الخروج من رمز محدد.
* `switch`: التبديل بين رموز الوصول.
* `token`: طباعة رمز الوصول الحالي إلى الإخراج القياسي.
* `whoami`: لمعرفة الحساب على huggingface.co الذي تم تسجيل الدخول به.

### `hf auth list`

ls

**الاستخدام**:

```console
$ hf auth list [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf auth list

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth login`

سجّل الدخول من متصفحك، أو باستخدام رمز من huggingface.co/settings/tokens.

**الاستخدام**:

```console
$ hf auth login [OPTIONS]
```

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--add-to-git-credential / --no-add-to-git-credential`: الحفظ في مساعد git credential. مفيد فقط إذا كنت تخطط لتنفيذ أوامر git مباشرة. [الافتراضي: no-add-to-git-credential]
* `--force / --no-force`: إجبار تسجيل الدخول من جديد حتى لو كان المستخدم مسجلاً بالفعل. [الافتراضي: no-force]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf auth login $ hf auth login --token $HF_TOKEN $ hf auth login --token $HF_TOKEN --add-to-git-credential $ hf auth login --force

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth logout`

تسجيل الخروج من رمز محدد.

**الاستخدام**:

```console
$ hf auth logout [OPTIONS]
```

**الخيارات**:

* `--token-name TEXT`: اسم الرمز الذي تريد تسجيل الخروج منه
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf auth logout $ hf auth logout --token-name my-token

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth switch`

التبديل بين رموز الوصول.

**الاستخدام**:

```console
$ hf auth switch [OPTIONS]
```

**الخيارات**:

* `--token-name TEXT`: اسم الرمز الذي تريد التبديل إليه
* `--add-to-git-credential / --no-add-to-git-credential`: الحفظ في مساعد git credential. مفيد فقط إذا كنت تخطط لتنفيذ أوامر git مباشرة. [الافتراضي: no-add-to-git-credential]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf auth switch $ hf auth switch --token-name my-token

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth token`

اطبع رمز الوصول الحالي إلى الإخراج القياسي.

**الاستخدام**:

```console
$ hf auth token [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf auth token $ hf auth token | xargs curl -H 'Authorization: Bearer {}'

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf auth whoami`

اعرف حساب huggingface.co الذي تم تسجيل الدخول به.

**الاستخدام**:

```console
$ hf auth whoami [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf auth whoami $ hf auth whoami --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf buckets`

أوامر للتفاعل مع الدلاء.

**الاستخدام**:

```console
$ hf buckets [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `cp`: نسخ الملفات بين المسارات المحلية والمستودعات والدلاء.
* `create`: إنشاء دلو جديد.
* `delete`: حذف دلو.
* `info`: احصل على معلومات حول دلو.
* `list`: يعرض قائمة الدلاء أو الملفات داخل دلو. [اسم مستعار: ls]
* `move`: نقل (إعادة تسمية) دلو إلى اسم أو مساحة أسماء جديدة.
* `remove`: إزالة الملفات من الدلو. [اسم مستعار: rm]
* `settings`: تحديث إعدادات الدلو (الظهور).
* `sync`: مزامنة الملفات بين المجلد المحلي ودلو التخزين.

### `hf buckets cp`

انسخ الملفات بين المسارات المحلية والمستودعات والدلاء.

يتعامل مع عمليات الرفع (محلي/مدخل قياسي -> مستودع/دلو) والتنزيل (مستودع/دلو -> محلي/مخرج قياسي) والنسخ من عن بُعد إلى عن بُعد (مستودع/دلو -> مستودع/دلو). لا يتم دعم النسخ من الدلو إلى المستودع أو من المحلي إلى المحلي. بالنسبة للمجلدات، استخدم `hf upload`/`hf download` (للمستودعات) أو `hf buckets sync` (للدلاء). تعمل عمليات النسخ من عن بُعد إلى عن بُعد فقط ضمن نفس منطقة التخزين (https://huggingface.co/docs/hub/storage-regions).

**الاستخدام**:

```console
$ hf buckets cp [OPTIONS] SRC [DST]
```

**الحجج**:

* `SRC`: المصدر: ملف محلي، أو عنوان URI بصيغة hf:// (مستودع أو دلو)، أو - لمدخل المعيار. [إلزامي]
* `[DST]`: الوجهة: مسار محلي، أو URI بصيغة hf:// (مستودع أو دلو)، أو - لمخرج المعيار.

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets cp hf://buckets/username/my-bucket/config.json config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv data/ $ hf buckets cp hf://buckets/username/my-bucket/config.json - $ hf buckets cp model.safetensors hf://buckets/username/my-bucket/model.safetensors $ hf buckets cp config.json hf://buckets/username/my-bucket/logs/ $ hf buckets cp - hf://buckets/username/my-bucket/config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv hf://buckets/username/dest-bucket/ $ hf buckets cp hf://buckets/username/source-bucket/logs/ hf://buckets/username/dest-bucket/logs/

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets create`

أنشئ دلوًا جديدًا.

**الاستخدام**:

```console
$ hf buckets create [OPTIONS] BUCKET_ID
```

**الحجج**:

* `BUCKET_ID`: معرّف الدلو: bucket_name أو namespace/bucket_name أو hf://buckets/namespace/bucket_name [إلزامي]

**الخيارات**:

* `--private`: إنشاء دلو خاص.
* `--region [us|eu]`: منطقة السحابة التي سيتم فيها إنشاء الدلو. يمكن أن تكون إما 'us' أو 'eu'. يتطلب الاشتراك في خطة Team أو أعلى.
* `--exist-ok`: لا ترفع خطأً إذا كان الدلو موجودًا بالفعل.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets create my-bucket $ hf buckets create user/my-bucket $ hf buckets create hf://buckets/user/my-bucket $ hf buckets create user/my-bucket --private $ hf buckets create user/my-bucket --exist-ok $ hf buckets create user/my-bucket --region us

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets delete`

حذف دلو.

يحذف هذا الأمر الدلو بالكامل وكل محتوياته. استخدم `hf buckets rm` لإزالة ملفات فردية.

**الاستخدام**:

```console
$ hf buckets delete [OPTIONS] BUCKET_ID
```

**الحجج**:

* `BUCKET_ID`: معرّف الدلو: namespace/bucket_name أو hf://buckets/namespace/bucket_name [إلزامي]

**الخيارات**:

* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--missing-ok`: لا ترفع خطأً إذا لم يكن الحوض موجودًا.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets delete user/my-bucket $ hf buckets delete hf://buckets/user/my-bucket $ hf buckets delete user/my-bucket --yes $ hf buckets delete user/my-bucket --missing-ok

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets info`

الحصول على معلومات حول دلو.

**الاستخدام**:

```console
$ hf buckets info [OPTIONS] BUCKET_ID
```

**الحجج**:

* `BUCKET_ID`: معرّف الدلو: namespace/bucket_name أو hf://buckets/namespace/bucket_name [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets info user/my-bucket $ hf buckets info hf://buckets/user/my-bucket

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets list`

list الدلاء أو الملفات داخل دلو. [alias: ls]

عند الاستدعاء دون أي حجة أو مع مساحة أسماء، يعرض قائمة بالحاويات. عند الاستدعاء مع معرّف حاوية (namespace/bucket_name)، يعرض قائمة بالملفات داخل الحاوية.

**الاستخدام**:

```console
$ hf buckets list [OPTIONS] [ARGUMENT]
```

**الحجج**:

* `[ARGUMENT]`: مساحة الأسماء (مستخدم أو منظمة) لعرض الأوعية، أو معرّف الوعاء (namespace/bucket_name(/prefix) أو hf://buckets/...) لعرض الملفات.

**الخيارات**:

* `-h, --human-readable`: عرض الأحجام بتنسيق قابل للقراءة البشرية.
* `--tree`: قائمة الملفات بتنسيق الشجرة (لإدراج الملفات فقط).
* `-R, --recursive`: سرد الملفات بشكل متكرر (لعملية سرد الملفات فقط).
* `--search TEXT`: استعلام البحث.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets list $ hf buckets list huggingface $ hf buckets list --search "my-prefix" $ hf buckets list user/my-bucket $ hf buckets list user/my-bucket -R $ hf buckets list user/my-bucket -h $ hf buckets list user/my-bucket --tree $ hf buckets list user/my-bucket --tree -h $ hf buckets list hf://buckets/user/my-bucket $ hf buckets list user/my-bucket/sub -R

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets move`

Move إعادة تسمية (rename) دلو إلى اسم أو مساحة أسماء جديدة.

**الاستخدام**:

```console
$ hf buckets move [OPTIONS] FROM_ID TO_ID
```

**الحجج**:

* `FROM_ID`: معرّف الدلو المصدر: namespace/bucket_name أو hf://buckets/namespace/bucket_name [إلزامي]
* `TO_ID`: معرّف الدلو الوجهة: namespace/bucket_name أو hf://buckets/namespace/bucket_name [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets move user/old-bucket user/new-bucket $ hf buckets move user/my-bucket my-org/my-bucket $ hf buckets move hf://buckets/user/old-bucket hf://buckets/user/new-bucket

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets remove`

إزالة الملفات من الدلو. [alias: rm]

لحذف دلو بالكامل، استخدم `hf buckets delete` بدلاً من ذلك.

**الاستخدام**:

```console
$ hf buckets remove [OPTIONS] ARGUMENT
```

**الحجج**:

* `ARGUMENT`: مسار الدلو: namespace/bucket_name/path أو hf://buckets/namespace/bucket_name/path. عند استخدام --recursive، يُقبل namespace/bucket_name أيضًا لاستهداف جميع الملفات. [إلزامي]

**الخيارات**:

* `-R, --recursive`: إزالة الملفات بشكل متكرر تحت البادئة المحددة.
* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--dry-run`: معاينة ما سيتم حذفه دون حذفه فعليًا.
* `--include TEXT`: تضمين الملفات المطابقة للنمط فقط (يمكن تحديد عدة أنماط). يتطلب --recursive.
* `--exclude TEXT`: استبعاد الملفات المطابقة للنمط (يمكن تحديد عدة أنماط). يتطلب --recursive.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets remove user/my-bucket/file.txt $ hf buckets rm hf://buckets/user/my-bucket/file.txt $ hf buckets rm user/my-bucket/logs/ --recursive $ hf buckets rm user/my-bucket --recursive --include "*.tmp" $ hf buckets rm user/my-bucket/data/ --recursive --dry-run

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets settings`

تحديث إعدادات الدلو (الظهور).

**الاستخدام**:

```console
$ hf buckets settings [OPTIONS] BUCKET_ID
```

**الحجج**:

* `BUCKET_ID`: معرّف الدلو: namespace/bucket_name أو hf://buckets/namespace/bucket_name [إلزامي]

**الخيارات**:

* `--private`: يجعل الدلو خاصًا.
* `--public`: يجعل الدلو عامًا.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets settings user/my-bucket --private $ hf buckets settings user/my-bucket --public $ hf buckets settings hf://buckets/user/my-bucket --private

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf buckets sync`

مزامنة الملفات بين المجلد المحلي ودلو التخزين.

**الاستخدام**:

```console
$ hf buckets sync [OPTIONS] [SOURCE] [DEST]
```

**الحجج**:

* `[SOURCE]`: مسار المصدر: مجلد محلي أو hf://buckets/namespace/bucket_name(/prefix)
* `[DEST]`: مسار الوجهة: مجلد محلي أو hf://buckets/namespace/bucket_name(/prefix)

**الخيارات**:

* `--delete / --no-delete`: حذف الملفات الموجودة في الوجهة وغير الموجودة في المصدر. [الافتراضي: no-delete]
* `--ignore-times`: تخطي الملفات بناءً على الحجم فقط، مع تجاهل أوقات التعديل.
* `--ignore-sizes`: تخطي الملفات بناءً على أوقات التعديل فقط، مع تجاهل الأحجام.
* `--plan TEXT`: حفظ خطة المزامنة في ملف بصيغة JSONL للمراجعة بدلاً من التنفيذ.
* `--apply TEXT`: تطبيق ملف خطة محفوظ مسبقًا.
* `--dry-run`: طباعة خطة المزامنة إلى stdout بصيغة JSONL دون تنفيذها.
* `--include TEXT`: تضمين الملفات المطابقة للنمط (يمكن تحديد عدة أنماط).
* `--exclude TEXT`: استبعاد الملفات المطابقة للنمط (يمكن تحديد عدة أنماط).
* `--filter-from TEXT`: قراءة أنماط الإدراج/الاستبعاد من ملف.
* `--existing`: تخطي إنشاء ملفات جديدة على المستقبل (تحديث الملفات الموجودة فقط).
* `--ignore-existing`: تخطي تحديث الملفات الموجودة على المستقبل (إنشاء الملفات الجديدة فقط).
* `-v, --verbose`: عرض سجلات تفصيلية مع الاستدلال.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf buckets sync ./data hf://buckets/user/my-bucket $ hf buckets sync hf://buckets/user/my-bucket ./data $ hf buckets sync ./data hf://buckets/user/my-bucket --delete $ hf buckets sync hf://buckets/user/my-bucket ./data --include "*.safetensors" --exclude "*.tmp" $ hf buckets sync ./data hf://buckets/user/my-bucket --plan sync-plan.jsonl $ hf buckets sync --apply sync-plan.jsonl $ hf buckets sync ./data hf://buckets/user/my-bucket --dry-run $ hf buckets sync ./data hf://buckets/user/my-bucket --dry-run | jq .

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf cache`

إدارة مجلد التخزين المؤقت المحلي.

**الاستخدام**:

```console
$ hf cache [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `list`: قائمة المستودعات أو المراجعات المخزنة مؤقتًا. [اسم مستعار: ls]
* `prune`: إزالة المراجعات المنفصلة والتحميلات غير المكتملة من ذاكرة التخزين المؤقت.
* `rm`: إزالة المستودعات أو المراجعات أو الملفات المخزنة مؤقتًا.
* `verify`: التحقق من رموز التحقق (Checksums) لإصدار مستودع واحد من ذاكرة التخزين المؤقت أو من مجلد محلي.

### `hf cache list`

قائمة المستودعات أو المراجعات المخزنة مؤقتًا. [alias: ls]

**الاستخدام**:

```console
$ hf cache list [OPTIONS]
```

**الخيارات**:

* `--cache-dir TEXT`: مجلد الكاش الذي سيتم فحصه (الافتراضي هو مجلد كاش Hugging Face).
* `--revisions / --no-revisions`: تضمين المراجعات في المخرجات بدلاً من المستودعات المجمّعة. [الافتراضي: no-revisions]
* `-f, --filter TEXT`: تصفية العناصر (مثل 'size>1GB'، 'type=model'، 'accessed>7d'). يمكن استخدامه عدة مرات.
* `--sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc]`: ترتيب العناصر حسب المفتاح. المفاتيح المدعومة: 'accessed'، 'modified'، 'name'، 'size'. أضف ':asc' أو ':desc' لتحديد الترتيب صراحةً (مثلًا: 'modified:asc'). القيم الافتراضية: 'accessed' و'modified' و'size' تُرتَّب افتراضيًا بترتيب تنازلي (الأحدث/الأكبر أولًا)؛ بينما 'name' يُرتَّب افتراضيًا بترتيب تصاعدي (أبجدي).
* `--limit INTEGER`: تحديد عدد النتائج المُعادَة. تُعاد أعلى N إدخالات فقط بعد الفرز.
* `--show-warnings / --no-show-warnings`: عرض تحذيرات حول عدم اتساق ذاكرة التخزين المؤقت. [الافتراضي: no-show-warnings]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf cache ls $ hf cache ls --revisions $ hf cache ls --filter "size>1GB" --limit 20 $ hf cache ls --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache prune`

إزالة المراجعات المنفصلة والتحميلات غير المكتملة من ذاكرة التخزين المؤقت.

**الاستخدام**:

```console
$ hf cache prune [OPTIONS]
```

**الخيارات**:

* `--cache-dir TEXT`: مجلد الكاش الذي سيتم فحصه (الافتراضي هو مجلد كاش Hugging Face).
* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--dry-run / --no-dry-run`: معاينة الحذف دون إزالة أي شيء. [الافتراضي: no-dry-run]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf cache prune $ hf cache prune --dry-run

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache rm`

إزالة المستودعات أو المراجعات أو الملفات المخزنة مؤقتًا.

**الاستخدام**:

```console
$ hf cache rm [OPTIONS] TARGETS...
```

**الحجج**:

* `TARGETS...`: معرف مستودع واحد أو أكثر (مثل model/bert-base-uncased)، أو عناوين hf:// (للمستودع أو الملف)، أو تجزئات المراجعة التي يجب حذفها. [إلزامي]

**الخيارات**:

* `--cache-dir TEXT`: مجلد الكاش الذي سيتم فحصه (الافتراضي هو مجلد كاش Hugging Face).
* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--dry-run / --no-dry-run`: معاينة الحذف دون إزالة أي شيء. [الافتراضي: no-dry-run]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf cache rm model/gpt2 $ hf cache rm hf://models/openai-community/gpt2 $ hf cache rm hf://models/openai-community/gpt2/model.safetensors $ hf cache rm $ hf cache rm model/gpt2 --dry-run $ hf cache rm model/gpt2 --yes

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf cache verify`

تحقق من قيم التجزئة (checksums) لتعديل مستودع واحد من ذاكرة التخزين المؤقت أو من مجلد محلي.

أمثلة:
  - تحقق من المراجعة الرئيسية في ذاكرة التخزين المؤقت: `hf cache verify gpt2`
  - التحقق من نسخة محددة: `hf cache verify gpt2 --revision refs/pr/1`
  - التحقق من مجموعة البيانات: `hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset`
  - التحقق من المجلد المحلي: `hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo`

**الاستخدام**:

```console
$ hf cache verify [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--cache-dir TEXT`: مجلد التخزين المؤقت الذي يُستخدم عند التحقق من الملفات من التخزين المؤقت (الافتراضي هو تخزين Hugging Face المؤقت).
* `--local-dir TEXT`: إذا تم ضبطه، تحقق من الملفات الموجودة تحت هذا المجلد بدلاً من ذاكرة التخزين المؤقت.
* `--fail-on-missing-files`: يفشل إذا كانت بعض الملفات موجودة عن بُعد لكنها مفقودة محليًا.
* `--fail-on-extra-files`: يفشل إذا كانت بعض الملفات موجودة محليًا لكنها غير موجودة في المراجعة البعيدة.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf cache verify gpt2 $ hf cache verify gpt2 --revision refs/pr/1 $ hf cache verify my-dataset --repo-type dataset

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf collections`

تفاعل مع المجموعات على Hub.

**الاستخدام**:

```console
$ hf collections [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `add-item`: إضافة عنصر إلى مجموعة.
* `create`: إنشاء مجموعة جديدة على Hub.
* `delete`: حذف مجموعة من Hub.
* `delete-item`: حذف عنصر من مجموعة.
* `info`: احصل على معلومات حول مجموعة على Hub.
* `list`: يعرض مجموعات على Hub. [مستعار: ls]
* `update`: تحديث بيانات الوصف (Metadata) لمجموعة على Hub.
* `update-item`: تحديث عنصر في مجموعة.

### `hf collections add-item`

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

**الاستخدام**:

```console
$ hf collections add-item [OPTIONS] COLLECTION_SLUG ITEM_ID ITEM_TYPE:{model|dataset|space|paper|collection|bucket}
```

**الحجج**:

* `COLLECTION_SLUG`: مُعرّف المجموعة (e.g., 'username/collection-slug'). [إلزامي]
* `ITEM_ID`: المعرّف الخاص بالعنصر المراد إضافته (repo_id للمستودعات، معرّف الورقة للورقات). [إلزامي]
* `ITEM_TYPE:{model|dataset|space|paper|collection|bucket}`: نوع العنصر (نموذج، مجموعة بيانات، مساحة، ورقة بحثية، مجموعة، أو دلو). [إلزامي]

**الخيارات**:

* `--note TEXT`: ملاحظة لإرفاقها بالعنصر (بحد أقصى 500 حرف).
* `--exists-ok / --no-exists-ok`: لا ترفع خطأً إذا كان العنصر موجودًا بالفعل في المجموعة. [الافتراضي: no-exists-ok]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections add-item username/my-collection moonshotai/kimi-k2 model $ hf collections add-item username/my-collection Qwen/DeepPlanning dataset --note "Useful dataset" $ hf collections add-item username/my-collection Tongyi-MAI/Z-Image space

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections create`

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

**الاستخدام**:

```console
$ hf collections create [OPTIONS] TITLE
```

**الحجج**:

* `TITLE`: عنوان المجموعة. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم (اسم المستخدم أو المنظمة). الافتراضي هو المستخدم الموثّق.
* `--description TEXT`: وصف للمجموعة (بحد أقصى 150 حرفًا).
* `--private / --no-private`: إنشاء مجموعة خاصة. [الافتراضي: no-private]
* `--exists-ok / --no-exists-ok`: لا ترفع خطأً إذا كانت المجموعة موجودة مسبقًا. [الافتراضي: no-exists-ok]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections create "My Models" $ hf collections create "My Models" --description "A collection of my favorite models" --private $ hf collections create "Org Collection" --namespace my-org

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections delete`

حذف مجموعة من Hub.

**الاستخدام**:

```console
$ hf collections delete [OPTIONS] COLLECTION_SLUG
```

**الحجج**:

* `COLLECTION_SLUG`: مُعرّف المجموعة (e.g., 'username/collection-slug'). [إلزامي]

**الخيارات**:

* `--missing-ok / --no-missing-ok`: عدم رفع خطأ إذا لم يكن المجموع موجودًا. [الافتراضي: no-missing-ok]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections delete username/my-collection $ hf collections delete username/my-collection --missing-ok

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections delete-item`

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

**الاستخدام**:

```console
$ hf collections delete-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID
```

**الحجج**:

* `COLLECTION_SLUG`: مُعرّف المجموعة (e.g., 'username/collection-slug'). [إلزامي]
* `ITEM_OBJECT_ID`: المعرّف الخاص بالعنصر في المجموعة (يُستخرج من حقل `item_object_id` الذي تُرجعه الأداة 'hf collections info'. [إلزامي]

**الخيارات**:

* `--missing-ok / --no-missing-ok`: عدم رفع خطأ إذا لم يكن العنصر موجودًا. [الافتراضي: no-missing-ok]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

### `hf collections info`

احصل على معلومات حول مجموعة على Hub.

**الاستخدام**:

```console
$ hf collections info [OPTIONS] COLLECTION_SLUG
```

**الحجج**:

* `COLLECTION_SLUG`: مُعرّف المجموعة (e.g., 'username/collection-slug'). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections info username/my-collection-slug

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections list`

List collections on the Hub. [alias: ls]

**الاستخدام**:

```console
$ hf collections list [OPTIONS]
```

**الخيارات**:

* `--owner TEXT`: تصفية حسب اسم مستخدم المالك أو المنظمة.
* `--item TEXT`: تصفية المجموعات التي تحتوي على عنصر محدد (مثل "models/gpt2"، "datasets/squad"، "papers/2311.12983").
* `--sort [lastModified|trending|upvotes]`: فرز النتائج حسب آخر تعديل، أو الاتجاهات الرائجة، أو الأصوات الإيجابية.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 10]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections ls $ hf collections ls --owner nvidia $ hf collections ls --item models/teknium/OpenHermes-2.5-Mistral-7B --limit 10

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections update`

تحديث بيانات الوصف الخاصة بمجموعة على Hub.

**الاستخدام**:

```console
$ hf collections update [OPTIONS] COLLECTION_SLUG
```

**الحجج**:

* `COLLECTION_SLUG`: مُعرّف المجموعة (e.g., 'username/collection-slug'). [إلزامي]

**الخيارات**:

* `--title TEXT`: العنوان الجديد للمجموعة.
* `--description TEXT`: الوصف الجديد للمجموعة (بحد أقصى 150 حرفًا).
* `--position INTEGER`: الموقع الجديد للمجموعة في قائمة المالك.
* `--private / --no-private`: ما إذا كان يجب أن تكون المجموعة خاصة.
* `--theme TEXT`: لون السمة الخاص بالمجموعة (مثلًا: 'green'، 'blue').
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections update username/my-collection --title "New Title" $ hf collections update username/my-collection --description "Updated description" $ hf collections update username/my-collection --private --theme green

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf collections update-item`

تحديث عنصر في مجموعة.

**الاستخدام**:

```console
$ hf collections update-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID
```

**الحجج**:

* `COLLECTION_SLUG`: مُعرّف المجموعة (e.g., 'username/collection-slug'). [إلزامي]
* `ITEM_OBJECT_ID`: المعرّف الخاص بالعنصر في المجموعة (من حقل 'item_object_id' وليس repo_id). [إلزامي]

**الخيارات**:

* `--note TEXT`: ملاحظة جديدة للعنصر (بحد أقصى 500 حرف).
* `--position INTEGER`: الموضع الجديد للعنصر في المجموعة.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf collections update-item username/my-collection ITEM_OBJECT_ID --note "Updated note" $ hf collections update-item username/my-collection ITEM_OBJECT_ID --position 0

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf cp`

انسخ الملفات بين المسارات المحلية والمستودعات والدلاء.

يتعامل مع عمليات الرفع (محلي/مدخل قياسي -> مستودع/دلو) والتنزيل (مستودع/دلو -> محلي/مخرج قياسي) والنسخ من عن بُعد إلى عن بُعد (مستودع/دلو -> مستودع/دلو). لا يتم دعم النسخ من الدلو إلى المستودع أو من المحلي إلى المحلي. بالنسبة للمجلدات، استخدم `hf upload`/`hf download` (للمستودعات) أو `hf buckets sync` (للدلاء). تعمل عمليات النسخ من عن بُعد إلى عن بُعد فقط ضمن نفس منطقة التخزين (https://huggingface.co/docs/hub/storage-regions).

**الاستخدام**:

```console
$ hf cp [OPTIONS] SRC [DST]
```

**الحجج**:

* `SRC`: المصدر: ملف محلي، أو عنوان URI بصيغة hf:// (مستودع أو دلو)، أو - لمدخل المعيار. [إلزامي]
* `[DST]`: الوجهة: مسار محلي، أو URI بصيغة hf:// (مستودع أو دلو)، أو - لمخرج المعيار.

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf cp hf://username/my-model/config.json $ hf cp hf://username/my-model/config.json ./config.json $ hf cp hf://datasets/username/my-dataset/data.csv ./data/ $ hf cp hf://buckets/username/my-bucket/config.json - $ hf cp ./model.safetensors hf://username/my-model/model.safetensors $ hf cp ./config.json hf://buckets/username/my-bucket/logs/ $ hf cp - hf://buckets/username/my-bucket/config.json $ hf cp hf://username/source-model/ hf://username/dest-model/ $ hf cp hf://datasets/username/my-dataset/processed/ hf://buckets/username/my-bucket/processed/ $ hf cp hf://buckets/username/my-bucket/logs/ hf://buckets/username/archive-bucket/  # copies contents only

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf datasets`

التفاعل مع مجموعات البيانات على Hub.

**الاستخدام**:

```console
$ hf datasets [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `card`: احصل على بطاقة مجموعة البيانات (README) لمجموعة بيانات على Hub.
* `info`: احصل على معلومات حول مجموعة بيانات على Hub.
* `leaderboard`: قائمة درجات النماذج من لوحة صدارة مجموعة البيانات.
* `list`: قائمة مجموعات البيانات على Hub، أو الملفات في مستودع مجموعة بيانات. [مستعار: ls]
* `parquet`: قائمة عناوين URLs لملفات parquet المتاحة لمجموعة بيانات.
* `sql`: تنفيذ استعلام SQL خام باستخدام DuckDB على عناوين URLs لملفات parquet الخاصة بالبيانات.

### `hf datasets card`

احصل على بطاقة البيانات (README) لبيانات على Hub.

**الاستخدام**:

```console
$ hf datasets card [OPTIONS] DATASET_ID
```

**الحجج**:

* `DATASET_ID`: معرّف مجموعة البيانات (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--metadata`: إخراج البيانات الوصفية من البطاقة فقط.
* `--text`: إخراج نص المحتوى فقط (بدون بيانات وصفية).
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf datasets card HuggingFaceFW/fineweb $ hf datasets card HuggingFaceFW/fineweb --metadata $ hf datasets card HuggingFaceFW/fineweb --metadata --format json $ hf datasets card HuggingFaceFW/fineweb --text

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets info`

احصل على معلومات حول مجموعة بيانات على Hub.

**الاستخدام**:

```console
$ hf datasets info [OPTIONS] DATASET_ID
```

**الحجج**:

* `DATASET_ID`: معرّف مجموعة البيانات (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--expand TEXT`: خصائص مفصولة بفواصل للعودة بها. عند الاستخدام، تُعاد الخصائص المدرجة فقط (مع id). مثال: '--expand=downloads,likes,tags'. الصالحة: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf datasets info HuggingFaceFW/fineweb $ hf datasets info my-dataset --expand downloads,likes,tags

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets leaderboard`

عرض درجات النماذج من لوحة صدارة مجموعة بيانات. يساعد هذا الأمر في العثور على أفضل النماذج لمهمة معينة أو مقارنة النماذج بناءً على درجات المعايير. استخدم hf datasets ls --filter benchmark:official لعرض لوحات الصدارة المتاحة.

**الاستخدام**:

```console
$ hf datasets leaderboard [OPTIONS] DATASET_ID
```

**الحجج**:

* `DATASET_ID`: معرّف مجموعة البيانات المرجعية (مثل `SWE-bench/SWE-bench_Verified`). [إلزامي]

**الخيارات**:

* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 20]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf datasets leaderboard SWE-bench/SWE-bench_Verified $ hf datasets leaderboard SWE-bench/SWE-bench_Verified --limit 5 --format json $ hf datasets ls --filter benchmark:official  # list available leaderboards

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets list`

ls لعرض قوائم مجموعات البيانات على Hub، أو الملفات داخل مستودع مجموعة بيانات. [alias: ls]

عند الاستدعاء دون أي حجة، يعرض قائمة بمجموعات البيانات على Hub. وعند الاستدعاء مع معرف مجموعة بيانات، يعرض قائمة بالملفات في مستودع تلك المجموعة.

**الاستخدام**:

```console
$ hf datasets list [OPTIONS] [REPO_ID]
```

**الحجج**:

* `[REPO_ID]`: معرف مجموعة البيانات (مثل `username/repo-name`) لعرض الملفات منها. إذا تم تجاهله، يتم عرض مجموعات البيانات.

**الخيارات**:

* `--search TEXT`: استعلام البحث.
* `--author TEXT`: تصفية حسب المؤلف أو المنظمة.
* `--filter TEXT`: تصفية حسب الوسوم (مثلًا 'text-classification'). يمكن استخدامه عدة مرات.
* `--sort [created_at|downloads|last_modified|likes|trending_score]`: فرز النتائج.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 30]
* `--expand TEXT`: خصائص مفصولة بفواصل للعودة بها. عند الاستخدام، تُعاد الخصائص المدرجة فقط (مع id). مثال: '--expand=downloads,likes,tags'. الصالحة: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
* `-h, --human-readable`: عرض الأحجام بتنسيق قابل للقراءة البشرية (لإدراج الملفات فقط).
* `--tree`: قائمة الملفات بتنسيق الشجرة (لإدراج الملفات فقط).
* `-R, --recursive`: سرد الملفات بشكل متكرر (لعملية سرد الملفات فقط).
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf datasets ls $ hf datasets ls --sort downloads --limit 10 $ hf datasets ls --search "code" $ hf datasets ls --filter benchmark:official $ hf datasets ls HuggingFaceFW/fineweb $ hf datasets ls HuggingFaceFW/fineweb -R $ hf datasets ls HuggingFaceFW/fineweb --tree -h

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets parquet`

قائمة عناوين URLs لملفات parquet المتاحة لمجموعة بيانات.

**الاستخدام**:

```console
$ hf datasets parquet [OPTIONS] DATASET_ID
```

**الحجج**:

* `DATASET_ID`: معرّف مجموعة البيانات (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--subset TEXT`: تصفية إدخالات parquet حسب المجموعة الفرعية/الإعداد.
* `--split TEXT`: تصفية إدخالات parquet حسب split.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf datasets parquet cfahlgren1/hub-stats $ hf datasets parquet cfahlgren1/hub-stats --subset models $ hf datasets parquet cfahlgren1/hub-stats --split train $ hf datasets parquet cfahlgren1/hub-stats --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf datasets sql`

نفّذ استعلام SQL خام باستخدام DuckDB على عناوين URL لملفات parquet الخاصة بالبيانات.

**الاستخدام**:

```console
$ hf datasets sql [OPTIONS] SQL
```

**الحجج**:

* `SQL`: استعلام SQL خام للتنفيذ. [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf datasets sql "SELECT COUNT(*) AS rows FROM read_parquet('https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet')" $ hf datasets sql "SELECT * FROM read_parquet('https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet') LIMIT 5" --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf discussions`

إدارة النقاشات وطلبات الدمج على Hub.

**الاستخدام**:

```console
$ hf discussions [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `close`: إغلاق نقاش أو طلب سحب.
* `comment`: التعليق على نقاش أو طلب سحب.
* `create`: إنشاء نقاش جديد أو طلب سحب في مستودع.
* `diff`: عرض الفروقات الخاصة بطلب الدمج.
* `edit`: تعديل تعليق موجود على نقاش أو طلب سحب.
* `info`: احصل على معلومات حول نقاش أو طلب سحب.
* `list`: يعرض قائمة المناقشات وطلبات الدمج في المستودع. [اسم مستعار: ls]
* `merge`: دمج طلب سحب.
* `rename`: إعادة تسمية نقاش أو طلب سحب.
* `reopen`: إعادة فتح نقاش أو طلب سحب مغلق.

### `hf discussions close`

إغلاق نقاش أو طلب سحب.

**الاستخدام**:

```console
$ hf discussions close [OPTIONS] REPO_ID NUM
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]

**الخيارات**:

* `--comment TEXT`: تعليق اختياري للنشر عند الإغلاق.
* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions close username/my-model 5 $ hf discussions close username/my-model 5 --comment "Closing as resolved."

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions comment`

التعليق على نقاش أو طلب سحب.

**الاستخدام**:

```console
$ hf discussions comment [OPTIONS] REPO_ID NUM
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]

**الخيارات**:

* `--body TEXT`: نص التعليق (يدعم Markdown).
* `--body-file PATH`: قراءة التعليق من ملف. استخدم '-' لمدخل المعيار.
* `--attach TEXT`: إرفاق صورة أو فيديو أو ملف صوتي، بصيغة 'FILE' أو 'FILE#alt text'. يُستبدل أي مرجع '![alt](FILE)' في النص بالملف المرفوع، بينما تُضاف الملفات الأخرى. يمكن استخدام هذا الخيار عدة مرات.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions comment username/my-model 5 --body "Thanks for reporting!" $ hf discussions comment username/my-model 5 --body "LGTM!" $ hf discussions comment username/my-model 5 --body "Here is a demo:" --attach demo.mp4

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions create`

أنشئ نقاشاً جديداً أو طلب سحب في مستودع.

**الاستخدام**:

```console
$ hf discussions create [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--title TEXT`: عنوان المناقشة أو طلب الدمج. [إلزامي]
* `--body TEXT`: الوصف (يدعم Markdown).
* `--body-file PATH`: قراءة الوصف من ملف. استخدم '-' لمدخل المعيار.
* `--pull-request, --pr`: إنشاء طلب سحب بدلاً من نقاش.
* `--attach TEXT`: إرفاق صورة أو فيديو أو ملف صوتي، بصيغة 'FILE' أو 'FILE#alt text'. يُستبدل أي مرجع '![alt](FILE)' في النص بالملف المرفوع، بينما تُضاف الملفات الأخرى. يمكن استخدام هذا الخيار عدة مرات.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions create username/my-model --title "Bug report" $ hf discussions create username/my-model --title "Feature request" --body "Please add X" $ hf discussions create username/my-model --title "Fix typo" --pull-request $ hf discussions create username/my-dataset --type dataset --title "Data quality issue" $ hf discussions create username/my-model --title "Fix rendering" --pr --attach "./before.png#Before the fix" --attach ./after.png

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions diff`

عرض اختلافات طلب الدمج.

**الاستخدام**:

```console
$ hf discussions diff [OPTIONS] REPO_ID NUM
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions diff username/my-model 5

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions edit`

تعديل تعليق موجود على نقاش أو طلب سحب.

**الاستخدام**:

```console
$ hf discussions edit [OPTIONS] REPO_ID NUM COMMENT_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]
* `COMMENT_ID`: المعرّف الخاص بالتعليق الذي تريد تحريره (انظر 'hf discussions info ... --format json'). [إلزامي]

**الخيارات**:

* `--body TEXT`: نص التعليق الجديد (يدعم Markdown).
* `--body-file PATH`: قراءة التعليق الجديد من ملف. استخدم '-' لمدخل المعيار.
* `--attach TEXT`: إرفاق صورة أو فيديو أو ملف صوتي، بصيغة 'FILE' أو 'FILE#alt text'. يُستبدل أي مرجع '![alt](FILE)' في النص بالملف المرفوع، بينما تُضاف الملفات الأخرى. يمكن استخدام هذا الخيار عدة مرات.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions edit username/my-model 5 abc123 --body "Updated comment." $ hf discussions edit username/my-model 5 abc123 --body-file fixed.md $ hf discussions edit username/my-model 5 abc123 --body "Fixed: ![result](./after.png)" --attach ./after.png

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions info`

احصل على معلومات حول نقاش أو طلب سحب.

**الاستخدام**:

```console
$ hf discussions info [OPTIONS] REPO_ID NUM
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions info username/my-model 5 $ hf discussions info username/my-model 5 --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions list`

ls

**الاستخدام**:

```console
$ hf discussions list [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `-s, --status [open|closed|merged|draft|all]`: تصفية حسب الحالة (مفتوح، مغلق، مدمج، مسودة، الكل). [الافتراضي: مفتوح]
* `-k, --kind [all|discussion|pull_request]`: تصفية حسب النوع (discussion، pull_request، all). [الافتراضي: all]
* `--author TEXT`: تصفية حسب المؤلف أو المنظمة.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 30]
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions list username/my-model $ hf discussions list username/my-model --kind pull_request --status merged $ hf discussions list username/my-dataset --type dataset --status closed $ hf discussions list username/my-model --author alice --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions merge`

دمج طلب سحب.

**الاستخدام**:

```console
$ hf discussions merge [OPTIONS] REPO_ID NUM
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]

**الخيارات**:

* `--comment TEXT`: تعليق اختياري للنشر عند الدمج.
* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions merge username/my-model 5 $ hf discussions merge username/my-model 5 --comment "Merging, thanks!"

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions rename`

إعادة تسمية نقاش أو طلب سحب.

**الاستخدام**:

```console
$ hf discussions rename [OPTIONS] REPO_ID NUM NEW_TITLE
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]
* `NEW_TITLE`: العنوان الجديد. [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions rename username/my-model 5 "Updated title"

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf discussions reopen`

إعادة فتح نقاش أو طلب سحب مغلق.

**الاستخدام**:

```console
$ hf discussions reopen [OPTIONS] REPO_ID NUM
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `NUM`: رقم النقاش أو طلب الدمج. [إلزامي]

**الخيارات**:

* `--comment TEXT`: تعليق اختياري للنشر عند إعادة الفتح.
* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf discussions reopen username/my-model 5 $ hf discussions reopen username/my-model 5 --comment "Reopening for further investigation."

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf download`

تنزيل الملفات من Hub.

**الاستخدام**:

```console
$ hf download [OPTIONS] REPO_ID [FILENAMES]...
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `[FILENAMES]...`: الملفات التي سيتم تنزيلها (مثل `config.json`، `data/metadata.jsonl`).

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: (model)]
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--include TEXT`: أنماط Glob لتضمينها من الملفات التي سيتم تنزيلها. مثال: *.json
* `--exclude TEXT`: أنماط Glob لاستبعاد الملفات من التحميل.
* `--cache-dir TEXT`: المجلد الذي تُحفظ فيه الملفات.
* `--local-dir TEXT`: إذا تم ضبطه، فسيتم وضع الملف المُحمَّل تحت هذا المجلد. راجع https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-a-local-folder لمزيد من التفاصيل.
* `--force-download / --no-force-download`: إذا كانت القيمة True، سيتم تنزيل الملفات حتى لو كانت مخزنة مسبقًا في ذاكرة التخزين المؤقت. [الافتراضي: no-force-download]
* `--dry-run / --no-dry-run`: إذا كانت القيمة True، يتم تنفيذ تشغيل تجريبي دون تنزيل الملف فعليًا. [الافتراضي: no-dry-run]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--max-workers INTEGER`: الحد الأقصى لعدد العمال المستخدمين لتنزيل الملفات. الافتراضي هو 8. [الافتراضي: 8]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf download meta-llama/Llama-3.2-1B-Instruct $ hf download meta-llama/Llama-3.2-1B-Instruct config.json tokenizer.json $ hf download meta-llama/Llama-3.2-1B-Instruct --include "*.safetensors" --exclude "*.bin" $ hf download meta-llama/Llama-3.2-1B-Instruct --local-dir ./models/llama $ hf download HuggingFaceM4/FineVision art/ --repo-type dataset $ hf download hf://datasets/HuggingFaceH4/ultrachat_200k

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf endpoints`

إدارة نقاط الاستدلال الخاصة بـ Hugging Face.

**الاستخدام**:

```console
$ hf endpoints [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `catalog`: التفاعل مع كتالوج نقاط الاستدلال (Inference Endpoints).
* `delete`: حذف نقطة الاستدلال بشكل دائم.
* `deploy`: نشر نقطة استنتاج من مستودع في Hub.
* `describe`: الحصول على معلومات حول نقطة نهاية موجودة.
* `hardware`: قائمة بالأجهزة المتاحة لنشر نقطة استنتاج عليها.
* `list`: يعرض جميع نقاط الاستدلال (Inference Endpoints) الخاصة بالمساحة الاسم (namespace) المحددة. [اسم آخر: ls]
* `list-catalog`: يعرض قائمة بالنماذج المتاحة في كتالوج النماذج.
* `pause`: إيقاف نقطة نهاية الاستدلال.
* `resume`: استئناف نقطة استنتاج.
* `scale-to-zero`: تصفير نقطة النهاية للاستدلال.
* `update`: تحديث نقطة نهاية موجودة.

### `hf endpoints catalog`

تفاعل مع كتالوج نقاط الاستدلال.

**الاستخدام**:

```console
$ hf endpoints catalog [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `deploy`: نشر نقطة استنتاج من كتالوج النماذج.
* `list`: يعرض قائمة النماذج المتاحة في كتالوج النماذج. [مستعار: ls]

#### `hf endpoints catalog deploy`

قم بنشر نقطة استنتاج من كتالوج النماذج.

تُنفَّذ نماذج الكتالوج عبر وصفة: وهي تركيبة من العتاد والمحرك تم اختبارها لهذه النماذج. مرّر --repo لتنفيذ الوصفة الافتراضية لنموذج ما، مع إمكانية تضييق نطاقها اختيارياً باستخدام --accelerator و--gguf-file، أو مرّر --recipe لتنفيذ وصفة محددة مدرجة في قائمة `hf endpoints catalog ls`.

**الاستخدام**:

```console
$ hf endpoints catalog deploy [OPTIONS]
```

**الخيارات**:

* `--repo TEXT`: اسم مستودع النموذج المرتبط بنقطة الاستدلال (Inference Endpoint) (مثل 'openai/gpt-oss-120b'). يقوم بنشر وصفته الافتراضية. يتعارض مع --recipe.
* `--recipe TEXT`: المعرّف الخاص بوصفة الكتالوج التي سيتم نشرها، كما هو مذكور في 'hf endpoints catalog ls'. يتعارض مع --repo.
* `--name TEXT`: اسم نقطة النهاية.
* `--accelerator [cpu|gpu|neuron]`: مُسرِّع العتاد الذي سيُستخدم للاستدلال. يعمل فقط مع --repo.
* `--gguf-file TEXT`: ملف GGUF الذي سيتم نشره، وذلك للنماذج التي تحتوي على وصفة واحدة لكل عملية تكميم. يعمل فقط مع --repo.
* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints catalog deploy --repo meta-llama/Llama-3.2-1B-Instruct $ hf endpoints catalog deploy --recipe sizzling-biryani-g4xsi1ac

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf endpoints catalog list`

ls

صف واحد لكل وصفة، أي لكل طريقة مُختبَرة لنشر نموذج. انشر واحدة باستخدام `hf endpoints catalog deploy --recipe <RECIPE_ID>`.

**الاستخدام**:

```console
$ hf endpoints catalog list [OPTIONS]
```

**الخيارات**:

* `--accelerator [cpu|gpu|neuron]`: عرض الوصفات التي تعمل على هذا المعالج فقط.
* `--engine [llamacpp|sglang|tei|vllm]`: عرض الوصفات التي تعمل بهذا محرك الاستدلال فقط.
* `--license TEXT`: عرض النماذج المرخّصة بموجب هذا الترخيص فقط (مثل 'Apache 2.0').
* `--task TEXT`: عرض النماذج الخاصة بهذه المهمة فقط (مثل 'text-generation').
* `--search TEXT`: استعلام البحث.
* `--limit INTEGER`: تحديد عدد النماذج التي يجب إرجاعها.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints catalog ls $ hf endpoints catalog ls --engine vllm

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints delete`

حذف نقطة الاستدلال بشكل دائم.

**الاستخدام**:

```console
$ hf endpoints delete [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--yes`: تجاوز رسائل التأكيد.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints delete my-endpoint

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints deploy`

نشر نقطة استنتاج من مستودع في Hub.

شغّل `hf endpoints hardware` لعرض التوليفات الصالحة لـ `--vendor` و`--region` و`--accelerator` و`--instance-type` و`--instance-size`.

**الاستخدام**:

```console
$ hf endpoints deploy [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--repo TEXT`: اسم مستودع النموذج المرتبط بنقطة الاستدلال (Inference Endpoint) (مثل 'openai/gpt-oss-120b'). [إلزامي]
* `--framework TEXT`: إطار التعلم الآلي المستخدم للنموذج (مثل 'vllm'). [إلزامي]
* `--accelerator TEXT`: مُسرِّع العتاد الذي سيُستخدم للاستدلال (مثلًا 'cpu'). [إلزامي]
* `--instance-size TEXT`: حجم أو نوع المثيل الذي سيُستخدم لاستضافة النموذج (مثل 'x4'). [إلزامي]
* `--instance-type TEXT`: نوع مثيل السحابة الذي سيتم نشر نقطة الاستدلال عليه (مثل 'intel-icl'). [إلزامي]
* `--region TEXT`: منطقة السحابة التي سيتم فيها إنشاء نقطة الاستدلال (Inference Endpoint) (مثلًا 'us-east-1'). [إلزامي]
* `--vendor TEXT`: مزوّد السحابة أو الجهة التي سيُستضاف عليها نقطة الاستدلال (Inference Endpoint) (مثلًا 'aws'). [إلزامي]
* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--task TEXT`: المهمة التي سيتم نشر النموذج عليها (مثل 'text-classification').
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--min-replica INTEGER`: الحد الأدنى لعدد النسخ (المهام) التي يجب إبقاؤها قيد التشغيل لنقطة الاستدلال. [الافتراضي: 1]
* `--max-replica INTEGER`: الحد الأقصى لعدد النسخ (المهام) التي يمكن توسيعها إلى نقطة الاستدلال. [الافتراضي: 1]
* `--scale-to-zero-timeout INTEGER`: المدة بالدقائق قبل أن يُقلَّص الطرف غير النشط إلى الصفر.
* `--scaling-metric [pendingRequests|hardwareUsage]`: مقياس المرجع للتوسع.
* `--scaling-threshold FLOAT`: عتبة مقياس التوسيع المستخدمة لتفعيل التوسيع. يتم تجاهلها عندما لا يُوفَّر مقياس التوسيع.
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--custom-image TEXT`: عنوان صورة Docker للحاوية التي سيتم تشغيلها (مثل 'nexagi/sglang:v0.5.12'). يتطلب '--framework custom'.
* `--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]`: صورة محرك مُدارة لتشغيل --custom-image معها (مثل 'vllm'). الافتراضي هو حاوية عشوائية.
* `--health-route TEXT`: مسار فحص الحالة الذي يعرضه الحاوية (مثل '/health'). يتطلب --custom-image.
* `--port INTEGER`: المنفذ الذي يستمع عليه الحاوية (مثل 30000). يتطلب --custom-image.
* `--container-registry-username TEXT`: اسم المستخدم المستخدم للمصادقة مع المستودع الذي يستضيف --custom-image.
* `--container-registry-password TEXT`: كلمة مرور اختيارية تُستخدم للمصادقة مع المستودع الذي يستضيف --custom-image.
* `--tensor-parallel-size INTEGER`: عدد المعالجات التي يتم تقسيم نسخة واحدة من النموذج عليها (محركات vLLM وSGLang فقط).
* `--data-parallel-size INTEGER`: عدد نسخ النموذج التي سيتم تشغيلها، نسخة واحدة لكل معالج تسريع (محرك vLLM فقط).
* `--container-command TEXT`: تجاوز نقطة الدخول (entrypoint) للحاوية، كسلسلة محاطة بعلامات اقتباس ومقسّمة إلى رموز (مثل "python -m sglang.launch_server").
* `--container-args TEXT`: حُجج تُضاف إلى نقطة دخول الحاوية، كنص محاط بعلامات اقتباس يُقسَّم إلى رموز (مثل "--tp 8 --reasoning-parser qwen3").
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--type [public|authenticated|private]`: نوع الوصول إلى نقطة النهاية. القيمة الافتراضية هي 'authenticated' (محمي برمز وصول، وقابل للوصول العام).
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints deploy my-endpoint --repo gpt2 --framework pytorch ... $ hf endpoints deploy my-endpoint --repo openai/gpt-oss-120b --framework custom --engine vllm --custom-image vllm/vllm-openai:v0.23.0 --tensor-parallel-size 8 ...

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints describe`

احصل على معلومات حول نقطة نهاية موجودة.

**الاستخدام**:

```console
$ hf endpoints describe [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints describe my-endpoint

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints hardware`

list_hardware

يُعرض هنا فقط العتاد الذي يمكن للمساحة الاسميه نشره في الوقت الحالي: حالة قابلة للاستخدام، وميزانية كافية من المعجلات لتشغيل نسخة واحدة. استخدم `--all` لعرض كل التوليفات التي تُرجعها واجهة برمجة التطبيقات.

الحصة لكل مساحة أسماء، لذا مرّر نفس `--namespace` الذي ستمرّره إلى `hf endpoints deploy`. الأسعار بالدولار الأمريكي، لكل نسخة في الساعة.

**الاستخدام**:

```console
$ hf endpoints hardware [OPTIONS]
```

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--vendor TEXT`: عرض الأجهزة المادية التي تستضيفها هذه الخدمة السحابية فقط (مثل 'aws').
* `--region TEXT`: عرض الأجهزة المتوفرة في منطقة السحابة هذه فقط (مثل 'us-east-1').
* `--accelerator TEXT`: عرض الأجهزة التي تحتوي على هذا المعالج فقط (مثل 'cpu'، 'gpu'، 'neuron').
* `--instance-type TEXT`: عرض الأجهزة من هذا النوع فقط (مثل 'nvidia-l4').
* `-a, --all`: يعرض أيضاً الأجهزة التي لا يمكن نشرها حالياً (غير متاحة، أو متقادمة، أو خارج نطاق الحصة).
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints hardware $ hf endpoints hardware --vendor aws --accelerator gpu

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints list`

يُدرج جميع نقاط الاستدلال (Inference Endpoints) للمساحة (namespace) المحددة. [alias: ls]

**الاستخدام**:

```console
$ hf endpoints list [OPTIONS]
```

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints ls $ hf endpoints ls --namespace my-org

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints list-catalog`

قائمة النماذج المتاحة في كتالوج النماذج.

صف واحد لكل وصفة، أي لكل طريقة مُختبَرة لنشر نموذج. انشر واحدة باستخدام `hf endpoints catalog deploy --recipe <RECIPE_ID>`.

**الاستخدام**:

```console
$ hf endpoints list-catalog [OPTIONS]
```

**الخيارات**:

* `--accelerator [cpu|gpu|neuron]`: عرض الوصفات التي تعمل على هذا المعالج فقط.
* `--engine [llamacpp|sglang|tei|vllm]`: عرض الوصفات التي تعمل بهذا محرك الاستدلال فقط.
* `--license TEXT`: عرض النماذج المرخّصة بموجب هذا الترخيص فقط (مثل 'Apache 2.0').
* `--task TEXT`: عرض النماذج الخاصة بهذه المهمة فقط (مثل 'text-generation').
* `--search TEXT`: استعلام البحث.
* `--limit INTEGER`: تحديد عدد النماذج التي يجب إرجاعها.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

### `hf endpoints pause`

إيقاف نقطة استنتاج مؤقتًا.

**الاستخدام**:

```console
$ hf endpoints pause [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints pause my-endpoint

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints resume`

استئناف نقطة نهاية الاستدلال.

**الاستخدام**:

```console
$ hf endpoints resume [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--fail-if-already-running`: إذا كان `True`، فسيُطلق هذا الأسلوب خطأً إذا كان Inference Endpoint قيد التشغيل بالفعل.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints resume my-endpoint

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints scale-to-zero`

قم بتقليص نقطة نهاية الاستدلال إلى صفر.

**الاستخدام**:

```console
$ hf endpoints scale-to-zero [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints scale-to-zero my-endpoint

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf endpoints update`

تحديث نقطة نهاية موجودة.

**الاستخدام**:

```console
$ hf endpoints update [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم نقطة النهاية. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم المرتبطة بنقطة الاستدلال. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--repo TEXT`: اسم مستودع النموذج المرتبط بنقطة الاستدلال (Inference Endpoint) (مثل 'openai/gpt-oss-120b').
* `--accelerator TEXT`: مُسرِّع العتاد الذي سيُستخدم للاستدلال (مثلًا 'cpu').
* `--instance-size TEXT`: حجم أو نوع المثيل الذي سيُستخدم لاستضافة النموذج (مثل 'x4').
* `--instance-type TEXT`: نوع مثيل السحابة الذي سيتم نشر نقطة الاستدلال (Inference Endpoint) عليه (مثلًا 'intel-icl').
* `--framework TEXT`: إطار التعلم الآلي المستخدم للنموذج (مثل 'custom').
* `--revision TEXT`: المراجعة المحددة للنموذج التي سيتم نشرها على نقطة الاستدلال (Inference Endpoint) (مثل '6c0e6080953db56375760c0471a8c5f2929baf11').
* `--task TEXT`: المهمة التي سيتم نشر النموذج عليها (مثل 'text-classification').
* `--custom-image TEXT`: عنوان صورة Docker للحاوية التي سيتم تشغيلها (مثل 'nexagi/sglang:v0.5.12'). يستبدل الصورة المُهيأة حاليًا على نقطة النهاية بدلاً من تعديلها، لذا مرّر إعدادات المحرك والحاوية التي تريد الاحتفاظ بها معًا، وشغّل 'hf endpoints describe NAME' أولاً لرؤيتها.
* `--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]`: صورة محرك مُدارة لتشغيل --custom-image معها (مثل 'vllm'). الافتراضي هو حاوية عشوائية.
* `--health-route TEXT`: مسار فحص الحالة الذي يعرضه الحاوية (مثل '/health'). يتطلب --custom-image.
* `--port INTEGER`: المنفذ الذي يستمع عليه الحاوية (مثل 30000). يتطلب --custom-image.
* `--tensor-parallel-size INTEGER`: عدد المعالجات التي يتم تقسيم نسخة واحدة من النموذج عليها (محركات vLLM وSGLang فقط).
* `--data-parallel-size INTEGER`: عدد نسخ النموذج التي سيتم تشغيلها، نسخة واحدة لكل معالج تسريع (محرك vLLM فقط).
* `--container-command TEXT`: تجاوز نقطة الدخول (entrypoint) للحاوية، كسلسلة محاطة بعلامات اقتباس تُقسَّم إلى رموز (مثل "python -m sglang.launch_server"). يستبدل القيمة الحالية؛ مرّر سلسلة فارغة لمسحها.
* `--container-args TEXT`: حُجج تُضاف إلى نقطة دخول الحاوية، كسلسلة محاطة بعلامات اقتباس تُقسَّم إلى رموز (مثل "--enable-auto-tool-choice --tool-call-parser lfm2"). تحلّ محلّ الحُجج المُعيَّنة حاليًا على النقطة الطرفية بدلاً من إضافتها إليها، لذا شمل الحُجج التي تريد الإبقاء عليها، ونفّذ 'hf endpoints describe NAME' أولاً لرؤيتها. مرّر سلسلة فارغة لمسحها.
* `--min-replica INTEGER`: الحد الأدنى لعدد النسخ (المهام) التي يجب إبقاؤها قيد التشغيل لنقطة الاستدلال.
* `--max-replica INTEGER`: الحد الأقصى لعدد النسخ (المهام) التي يمكن توسيعها إلى نقطة الاستدلال.
* `--scale-to-zero-timeout INTEGER`: المدة بالدقائق قبل أن يُقلَّص الطرف غير النشط إلى الصفر.
* `--scaling-metric [pendingRequests|hardwareUsage]`: مقياس المرجع للتوسع.
* `--scaling-threshold FLOAT`: عتبة مقياس التوسيع المستخدمة لتفعيل التوسيع. يتم تجاهلها عندما لا يُوفَّر مقياس التوسيع.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf endpoints update my-endpoint --min-replica 2 $ hf endpoints update my-endpoint --tensor-parallel-size 8 $ hf endpoints update my-endpoint --container-args "--enable-auto-tool-choice --tool-call-parser lfm2"

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf env`

اطبع معلومات حول البيئة.

**الاستخدام**:

```console
$ hf env [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

## `hf extensions`

إدارة امتدادات hf CLI. [alias: ext]

تحذير أمني: الإضافات هي ملفات تنفيذية أو حزم بايثون من أطراف ثالثة. ثبّتها فقط من مصادر تثق بها.

**الاستخدام**:

```console
$ hf extensions [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `exec`: تنفيذ امتداد مثبّت.
* `install`: تثبيت إضافة من مستودع GitHub عام.
* `list`: يعرض قائمة أوامر الإضافات المثبتة. [اسم مستعار: ls]
* `remove`: إزالة امتداد مثبّت. [اسم مستعار: rm]
* `search`: البحث عن الإضافات المتاحة على GitHub (الموسومة بموضوع 'hf-extension').
* `update`: تحديث الامتدادات المثبتة إلى أحدث إصدار لها.

### `hf extensions exec`

تنفيذ امتداد مثبّت.

**الاستخدام**:

```console
$ hf extensions exec [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم الامتداد (مع أو بدون البادئة `hf-`). [إلزامي]

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf extensions exec claude -- --help $ hf extensions exec claude --model zai-org/GLM-5

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions install`

قم بتثبيت إضافة من مستودع GitHub عام.

تحذير أمني: هذا الأمر يقوم بتثبيت ملف تنفيذي أو حزمة بايثون من طرف ثالث. قم بالتثبيت فقط من مصادر تثق بها.

**الاستخدام**:

```console
$ hf extensions install [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: مستودع امتداد GitHub بصيغة `[OWNER/]hf-<name>`. [إلزامي]

**الخيارات**:

* `--force`: الكتابة فوقه إذا كان مثبتًا بالفعل.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf extensions install hf-claude $ hf extensions install hanouticelina/hf-claude $ hf extensions install alvarobartt/hf-mem

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions list`

عرض أوامر الإضافات المثبتة. [alias: ls]

**الاستخدام**:

```console
$ hf extensions list [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf extensions list

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions remove`

إزالة امتداد مثبّت. [alias: rm]

**الاستخدام**:

```console
$ hf extensions remove [OPTIONS] NAME
```

**الحجج**:

* `NAME`: اسم الامتداد المراد إزالته (مع أو بدون البادئة `hf-`). [إلزامي]

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf extensions remove claude

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions search`

ابحث عن الإضافات المتاحة على GitHub (الموسومة بموضوع 'hf-extension').

**الاستخدام**:

```console
$ hf extensions search [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf extensions search

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf extensions update`

حدّث الامتدادات المثبّتة إلى أحدث إصدار لها.

**الاستخدام**:

```console
$ hf extensions update [OPTIONS] [NAME]
```

**الحجج**:

* `[NAME]`: الامتداد المطلوب تحديثه (مع أو بدون البادئة `hf-`، ويمكن اختيارياً كتابته على شكل `OWNER/hf-<name>`). إذا تم تجاهله، يتم فحص جميع الامتدادات المثبتة وتحديث تلك التي لم تعد محدثة.

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf extensions update $ hf extensions update hf-claude $ hf extensions update alvarobartt/hf-mem

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf jobs`

تشغيل وإدارة المهام على Hub.

**الاستخدام**:

```console
$ hf jobs [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `cancel`: إلغاء مهمة
* `expose`: استبدال المنافذ المكشوفة في مهمة قيد التشغيل.
* `hardware`: قائمة خيارات الأجهزة المتاحة للمهام
* `inspect`: عرض معلومات مفصّلة عن مهمة واحدة أو أكثر
* `labels`: تحديث التسميات على مهمة.
* `list`: قائمة المهام. [مستعار: ls, ps]
* `logs`: جلب سجلات مهمة.
* `rerun`: تشغيل مهمة جديدة باستخدام مواصفات مهمة موجودة مسبقًا.
* `run`: تشغيل مهمة.
* `scheduled`: إنشاء وإدارة مهام مجدولة على Hub.
* `ssh`: الدخول إلى مهمة قيد التشغيل عبر SSH.
* `stats`: جلب إحصائيات ومؤشرات استخدام الموارد الخاصة بالمهام.
* `uv`: تشغيل سكربتات UV (بايثون مع تبعيات مضمّنة) على بنية HF التحتية.
* `wait`: انتظار وصول وظيفة أو أكثر إلى حالة نهائية.

### `hf jobs cancel`

إلغاء مهمة

**الاستخدام**:

```console
$ hf jobs cancel [OPTIONS] JOB_ID
```

**الحجج**:

* `JOB_ID`: معرّف المهمة (أو 'namespace/job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs cancel

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs expose`

استبدال المنافذ المكشوفة في مهمة قيد التشغيل.

**الاستخدام**:

```console
$ hf jobs expose [OPTIONS] JOB_ID [PORTS]...
```

**الحجج**:

* `JOB_ID`: معرّف المهمة (أو 'namespace/job_id') [إلزامي]
* `[PORTS]...`: المنافذ التي يجب كشفها عبر وكيل المهام. يتطلب الوصول رمز HF مع صلاحية القراءة في مساحة أسماء المهمة.

**الخيارات**:

* `--public INTEGER`: تعرِض منفذًا دون مصادقة. كرِّر هذا العلم لتعريض عدة منافذ. لا حاجة أيضًا إلى تمرير المنفذ كحجة موضعية.
* `--clear`: إغلاق جميع المنافذ المكشوفة.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs expose  8000 $ hf jobs expose  8000 --public 9000 $ hf jobs expose  --clear

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs hardware`

قائمة خيارات الأجهزة المتاحة للمهام

**الاستخدام**:

```console
$ hf jobs hardware [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs hardware

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs inspect`

عرض معلومات مفصّلة عن مهمة واحدة أو أكثر

**الاستخدام**:

```console
$ hf jobs inspect [OPTIONS] JOB_IDS...
```

**الحجج**:

* `JOB_IDS...`: معرّفات المهام التي سيتم فحصها (أو 'namespace/job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs inspect

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs labels`

تحديث التسميات على مهمة. عند تمرير --label يتم استبدال جميع التسميات الموجودة؛ أما عند تمرير --name وحده فتبقى التسميات كما هي.

**الاستخدام**:

```console
$ hf jobs labels [OPTIONS] JOB_ID
```

**الحجج**:

* `JOB_ID`: معرّف المهمة (أو 'namespace/job_id') [إلزامي]

**الخيارات**:

* `--name TEXT`: تسمية المهمة. تُخزَّن كوسم `name`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم الصورة أو السكربت مضافًا إليه تجزئة قصيرة من إعدادات التشغيل المُحدَّدة.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `--clear`: إزالة جميع التسميات من المهمة.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs labels  --name training-v2 $ hf jobs labels  --label env=prod --label team=ml $ hf jobs labels  --clear

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs list | ls | ps`

قائمة المهام.

استخدم `--status` للتصفية حسب الحالة (انظر [JobStage](/docs/huggingface_hub/v2.4.0/ar/package_reference/jobs#huggingface_hub.JobStage) للقيم الممكنة) و`--label` للتصفية حسب التسميات `key=value`. يجب أن يطابق كل مهمة جميع عوامل التصفية حتى تُدرج في القائمة.

**الاستخدام**:

```console
$ hf jobs list | ls | ps [OPTIONS]
```

**الخيارات**:

* `-a, --all`: عرض جميع المهام (الافتراضي يعرض المهام قيد التشغيل والجدولة). لا يمكن دمجه مع --status.
* `--status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING]`: عرض المهام التي تحمل الحالة المحددة فقط. يمكن فصلها بفواصل أو تكرارها، مثل `--status running,scheduling`.
* `-l, --label TEXT`: عرض المهام التي تحمل التسمية `key=value` المحددة فقط. كرر الخيار لطلب عدة تسميات، على سبيل المثال `--label env=prod --label team=ml`.
* `--name TEXT`: عرض المهام التي تحمل الاسم المحدد فقط (اختصار لـ `--label name=NAME`).
* `--limit INTEGER`: الحد الأقصى لعدد مهام Jobs التي يتم عرضها. اضبطها على 0 لعرض الكل (بدون حد). [الافتراضي: 100]
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs ls $ hf jobs ls -a $ hf jobs ls --status running,scheduling $ hf jobs ls --name training-v2 $ hf jobs ls --label env=prod --label team=ml $ hf jobs ls --all --label hf-sandbox=1

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs logs`

جلب سجلات مهمة.

يطبع السجلات المتاحة حاليًا ويخرج افتراضيًا (غير حاسم). استخدم --follow/-f لبث السجلات في الوقت الفعلي حتى اكتمال المهمة. استخدم --tail/-n لتحديد عدد الأسطر المُعاد (على جانب الخادم عند دعم ذلك).

ملاحظة: يتوقف التنفيذ عند انتهاء تدوينات السجل، بغض النظر عما إذا نجح Job أم فشل. شغّل `hf jobs inspect <job_id>` للتحقق من الحالة النهائية.

**الاستخدام**:

```console
$ hf jobs logs [OPTIONS] JOB_ID
```

**الحجج**:

* `JOB_ID`: معرّف المهمة (أو 'namespace/job_id') [إلزامي]

**الخيارات**:

* `-f, --follow`: متابعة مخرجات السجلات (بث مستمر حتى اكتمال المهمة). بدون هذا العلم، يتم طباعة السجلات المتاحة حاليًا فقط.
* `-n, --tail INTEGER`: عدد الأسطر التي يجب عرضها من نهاية السجلات. عند الجمع مع --follow، يبدأ البث من آخر N أسطر.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs logs $ hf jobs logs -f $ hf jobs logs --tail 20 $ hf jobs logs -f --tail 100

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs rerun`

شغّل مهمة جديدة باستخدام مواصفات مهمة موجودة مسبقًا.

**الاستخدام**:

```console
$ hf jobs rerun [OPTIONS] JOB_ID
```

**الحجج**:

* `JOB_ID`: معرّف المهمة (أو 'namespace/job_id') [إلزامي]

**الخيارات**:

* `-d, --detach`: تشغيل المهمة في الخلفية وطباعة معرّف المهمة.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs rerun $ hf jobs rerun --detach

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs run`

تشغيل مهمة.

**الاستخدام**:

```console
$ hf jobs run [OPTIONS] IMAGE COMMAND...
```

**الحجج**:

* `IMAGE`: صورة Docker التي سيتم استخدامها. [إلزامي]
* `COMMAND...`: الأمر الذي سيتم تنفيذه. [إلزامي]

**الخيارات**:

* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--name TEXT`: تسمية المهمة. تُخزَّن كوسم `name`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم الصورة أو السكربت مضافًا إليه تجزئة قصيرة من إعدادات التشغيل المُحدَّدة.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] أو LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. يكون TYPE أحد الخيارات التالية: models، datasets، spaces، buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. تُركَّب models وdatasets وspaces للقراءة فقط دائمًا. أما buckets فتُركَّب للقراءة والكتابة افتراضيًا. يُزامَن مصدر المجلد المحلي أولًا مع bucket ثم يُركَّب للقراءة فقط افتراضيًا. على سبيل المثال: -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro أو -v ./inputs:/inputs
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد. شغّل 'hf jobs hardware' لعرض الأنواع المتاحة. القيمة الافتراضية هي `cpu-basic`.
* `--timeout TEXT`: المدة القصوى: عدد صحيح مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام).
* `--attempts INTEGER RANGE`: الحد الأقصى لعدد المحاولات، بما في ذلك التشغيل الأولي. القيمة الافتراضية هي 1. [x>=1]
* `-d, --detach`: تشغيل المهمة في الخلفية وطباعة معرّف المهمة.
* `--dry-run`: طباعة إعدادات المهمة (Job) المُحدَّدة دون إرسالها.
* `--expose INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام. كرّر هذا العلم لتخصيص عدة منافذ (مثل `--expose 8000 --expose 8001`). يمكن الوصول إلى كل منفذ مكشوف عبر نطاق المهام العام؛ ويتطلب الوصول رمز HF يملك صلاحية القراءة على مساحة أسماء المهمة.
* `--expose-public INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام دون مصادقة. كرر هذا العلم لتكرار المنفذ. لا حاجة أيضًا لتمرير المنفذ مع `--expose`.
* `--ssh`: يجعل حاوية المهمة قابلة للوصول عبر SSH. اتصل باستخدام `hf jobs ssh <job_id>`. يتطلب ذلك مفتاح SSH عام مسجلاً على https://huggingface.co/settings/keys.
* `--network-group TEXT`: الانضمام إلى مجموعة شبكة. تُجمع المهام الموجودة في نفس مساحة الاسم ومجموعة الموارد والتي تتشارك مجموعة واحدة معًا، وتصل إلى بعضها البعض عبر كل منفذ. داخل كل عضو، يُحل `$HF_NETWORK_GROUP_HOSTNAME` إلى كل عضو. أحرف صغيرة وأرقام وشرطات، بحد أقصى 46 حرفًا.
* `--network-alias TEXT`: ادّعاء مستعار ضمن مجموعة الشبكة. تصل الأعضاء إلى المهام التي تدّعيه عبر `${HF_NETWORK_GROUP_PREFIX}<alias>`. كرّر العلم لعدة مستعرات. أحرف أبجدية رقمية صغيرة وشرطات، بحد أقصى 34 حرفًا، فريدة ضمن المهمة. يتطلب `--network-group`.
* `--resource-group-id TEXT`: المعرّف الخاص بمجموعة الموارد التي سيتم إنشاء المهمة (Job) فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--format [agent|auto|human|json|quiet]`: صيغة المخرجات. القيمة الافتراضية هي 'auto' والتي تختار 'agent' أو 'human' بناءً على الطرفية.
* `--json`: إخراج بصيغة JSON. يعادل '--format json'.
* `-q, --quiet`: إخراج هادئ (معرّف واحد في كل سطر). يعادل '--format quiet'.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs run --name hello-world python:3.12 python -c 'print("Hello!")' $ hf jobs run --detach python:3.12 python script.py $ hf jobs run -e FOO=foo python:3.12 python script.py $ hf jobs run --secrets HF_TOKEN python:3.12 python script.py $ hf jobs run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt python:3.12 python script.py

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs scheduled`

إنشاء وإدارة المهام المجدولة على Hub.

**الاستخدام**:

```console
$ hf jobs scheduled [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `delete`: حذف مهمة مجدولة.
* `inspect`: عرض معلومات مفصّلة عن مهمة مجدولة واحدة أو أكثر
* `labels`: تحديث التسميات على مهمة مجدولة.
* `list`: قائمة المهام المجدولة. [اختصار: ls, ps]
* `reschedule`: تغيير وقت تشغيل مهمة مجدولة.
* `resume`: استئناف (إلغاء إيقاف مؤقت) مهمة مجدولة.
* `run`: جدولة مهمة.
* `suspend`: إيقاف (تجميد) مهمة مجدولة.
* `trigger`: تشغيل مهمة مجدولة فورًا (دون تغيير الجدولة).
* `uv`: جدولة سكربتات UV على بنية HF التحتية.

#### `hf jobs scheduled delete`

حذف مهمة مجدولة.

**الاستخدام**:

```console
$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_ID
```

**الحجج**:

* `SCHEDULED_JOB_ID`: معرّف المهمة المجدولة (أو 'namespace/scheduled_job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة hf jobs scheduled delete

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled inspect`

عرض معلومات مفصّلة عن مهمة مجدولة واحدة أو أكثر

**الاستخدام**:

```console
$ hf jobs scheduled inspect [OPTIONS] SCHEDULED_JOB_IDS...
```

**الحجج**:

* `SCHEDULED_JOB_IDS...`: معرّفات المهام المجدولة التي سيتم فحصها (أو 'namespace/scheduled_job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs scheduled inspect

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled labels`

تحديث التسميات على مهمة مجدولة. عند تمرير --label يتم استبدال جميع التسميات الموجودة؛ أما عند تمرير --name وحده فتبقى التسميات كما هي.

**الاستخدام**:

```console
$ hf jobs scheduled labels [OPTIONS] SCHEDULED_JOB_ID
```

**الحجج**:

* `SCHEDULED_JOB_ID`: معرّف المهمة المجدولة (أو 'namespace/scheduled_job_id') [إلزامي]

**الخيارات**:

* `--name TEXT`: تسمية المهمة. تُخزَّن كوسم `name`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم الصورة أو السكربت مضافًا إليه تجزئة قصيرة من إعدادات التشغيل المُحدَّدة.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `--clear`: إزالة جميع التسميات من المهمة المجدولة.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs scheduled labels  --name daily-script $ hf jobs scheduled labels  --label env=prod --label team=ml $ hf jobs scheduled labels  --clear

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled list | ls | ps`

قائمة المهام المجدولة.

استخدم `--status` للتصفية حسب الحالة (`active` أو `suspended`) و`--label` للتصفية حسب التسميات `key=value`. يجب أن يتطابق كل Job مجدول مع جميع عوامل التصفية ليُدرج في القائمة.

**الاستخدام**:

```console
$ hf jobs scheduled list | ls | ps [OPTIONS]
```

**الخيارات**:

* `-a, --all`: يعرض جميع المهام المجدولة (يُخفي المهام الموقوفة افتراضيًا). لا يمكن دمجه مع --status.
* `--status [active|suspended]`: عرض المهام المجدولة ذات الحالة المحددة فقط. يمكن فصلها بفواصل أو تكرارها، على سبيل المثال `--status suspended`.
* `-l, --label TEXT`: عرض المهام المجدولة التي تحمل التسمية `key=value` المحددة فقط. كرر الخيار لطلب عدة تسميات، على سبيل المثال `--label env=prod --label team=ml`.
* `--name TEXT`: عرض المهام المجدولة التي تحمل الاسم المحدد فقط (اختصار لـ `--label name=NAME`).
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs scheduled ls $ hf jobs scheduled ls -a $ hf jobs scheduled ls --status suspended $ hf jobs scheduled ls --name daily-script $ hf jobs scheduled ls --label env=prod --label team=ml

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled reschedule`

تغيير وقت تشغيل مهمة مجدولة.

**الاستخدام**:

```console
$ hf jobs scheduled reschedule [OPTIONS] SCHEDULED_JOB_ID SCHEDULE
```

**الحجج**:

* `SCHEDULED_JOB_ID`: معرّف المهمة المجدولة (أو 'namespace/scheduled_job_id') [إلزامي]
* `SCHEDULE`: أحد @annually أو @yearly أو @monthly أو @weekly أو @daily أو @hourly أو تعبير جدولة CRON. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs scheduled reschedule  "0 9 * * 1"

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled resume`

Resume (إلغاء إيقاف) مهمة مجدولة.

**الاستخدام**:

```console
$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_ID
```

**الحجج**:

* `SCHEDULED_JOB_ID`: معرّف المهمة المجدولة (أو 'namespace/scheduled_job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة hf jobs scheduled resume

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled run`

جدولة مهمة.

**الاستخدام**:

```console
$ hf jobs scheduled run [OPTIONS] SCHEDULE IMAGE COMMAND...
```

**الحجج**:

* `SCHEDULE`: أحد @annually أو @yearly أو @monthly أو @weekly أو @daily أو @hourly أو تعبير جدولة CRON. [إلزامي]
* `IMAGE`: صورة Docker التي سيتم استخدامها. [إلزامي]
* `COMMAND...`: الأمر الذي سيتم تنفيذه. [إلزامي]

**الخيارات**:

* `--suspend / --no-suspend`: إيقاف (تجميد) المهمة المجدولة
* `--concurrency / --no-concurrency`: السماح بتشغيل عدة نسخ من هذا Job بشكل متزامن
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--name TEXT`: تسمية المهمة. تُخزَّن كوسم `name`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم الصورة أو السكربت مضافًا إليه تجزئة قصيرة من إعدادات التشغيل المُحدَّدة.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] أو LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. يكون TYPE أحد الخيارات التالية: models، datasets، spaces، buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. تُركَّب models وdatasets وspaces للقراءة فقط دائمًا. أما buckets فتُركَّب للقراءة والكتابة افتراضيًا. يُزامَن مصدر المجلد المحلي أولًا مع bucket ثم يُركَّب للقراءة فقط افتراضيًا. على سبيل المثال: -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro أو -v ./inputs:/inputs
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد. شغّل 'hf jobs hardware' لعرض الأنواع المتاحة. القيمة الافتراضية هي `cpu-basic`.
* `--timeout TEXT`: المدة القصوى: عدد صحيح مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام).
* `--attempts INTEGER RANGE`: الحد الأقصى لعدد المحاولات، بما في ذلك التشغيل الأولي. القيمة الافتراضية هي 1. [x>=1]
* `--dry-run`: طباعة إعدادات المهمة (Job) المُحدَّدة دون إرسالها.
* `--expose INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام. كرّر هذا العلم لتخصيص عدة منافذ (مثل `--expose 8000 --expose 8001`). يمكن الوصول إلى كل منفذ مكشوف عبر نطاق المهام العام؛ ويتطلب الوصول رمز HF يملك صلاحية القراءة على مساحة أسماء المهمة.
* `--expose-public INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام دون مصادقة. كرر هذا العلم لتكرار المنفذ. لا حاجة أيضًا لتمرير المنفذ مع `--expose`.
* `--resource-group-id TEXT`: المعرّف الخاص بمجموعة الموارد التي سيتم إنشاء المهمة (Job) فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--format [agent|auto|human|json|quiet]`: صيغة المخرجات. القيمة الافتراضية هي 'auto' والتي تختار 'agent' أو 'human' بناءً على الطرفية.
* `--json`: إخراج بصيغة JSON. يعادل '--format json'.
* `-q, --quiet`: إخراج هادئ (معرّف واحد في كل سطر). يعادل '--format quiet'.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs scheduled run "0 0 * * *" --name daily-script python:3.12 python script.py

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled suspend`

Suspend (إيقاف مؤقت) مهمة مجدولة.

**الاستخدام**:

```console
$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_ID
```

**الحجج**:

* `SCHEDULED_JOB_ID`: معرّف المهمة المجدولة (أو 'namespace/scheduled_job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة hf jobs scheduled suspend

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled trigger`

تشغيل مهمة مجدولة فوراً (لا يغيّر الجدولة).

**الاستخدام**:

```console
$ hf jobs scheduled trigger [OPTIONS] SCHEDULED_JOB_ID
```

**الحجج**:

* `SCHEDULED_JOB_ID`: معرّف المهمة المجدولة (أو 'namespace/scheduled_job_id') [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة hf jobs scheduled trigger

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf jobs scheduled uv`

جدولة سكربتات UV على بنية HF التحتية.

**الاستخدام**:

```console
$ hf jobs scheduled uv [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `run`: تشغيل سكريبت UV (ملف محلي أو رابط URL) على بنية HF التحتية

##### `hf jobs scheduled uv run`

تشغيل سكربت UV (ملف محلي أو رابط URL) على بنية HF التحتية

**الاستخدام**:

```console
$ hf jobs scheduled uv run [OPTIONS] SCHEDULE SCRIPT [SCRIPT_ARGS]...
```

**الحجج**:

* `SCHEDULE`: أحد @annually أو @yearly أو @monthly أو @weekly أو @daily أو @hourly أو تعبير جدولة CRON. [إلزامي]
* `SCRIPT`: سكريبت UV للتنفيذ (ملف محلي أو عنوان URL) [إلزامي]
* `[SCRIPT_ARGS]...`: حُجج السكربت

**الخيارات**:

* `--suspend / --no-suspend`: إيقاف (تجميد) المهمة المجدولة
* `--concurrency / --no-concurrency`: السماح بتشغيل عدة نسخ من هذا Job بشكل متزامن
* `--image TEXT`: استخدم صورة Docker مخصصة مع تثبيت `uv`.
* `--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد. شغّل 'hf jobs hardware' لعرض الأنواع المتاحة. القيمة الافتراضية هي `cpu-basic`.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--name TEXT`: تسمية المهمة. تُخزَّن كوسم `name`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم الصورة أو السكربت مضافًا إليه تجزئة قصيرة من إعدادات التشغيل المُحدَّدة.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] أو LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. يكون TYPE أحد الخيارات التالية: models، datasets، spaces، buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. تُركَّب models وdatasets وspaces للقراءة فقط دائمًا. أما buckets فتُركَّب للقراءة والكتابة افتراضيًا. يُزامَن مصدر المجلد المحلي أولًا مع bucket ثم يُركَّب للقراءة فقط افتراضيًا. على سبيل المثال: -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro أو -v ./inputs:/inputs
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--timeout TEXT`: المدة القصوى: عدد صحيح مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام).
* `--attempts INTEGER RANGE`: الحد الأقصى لعدد المحاولات، بما في ذلك التشغيل الأولي. القيمة الافتراضية هي 1. [x>=1]
* `--dry-run`: طباعة إعدادات المهمة (Job) المُحدَّدة دون إرسالها.
* `--expose INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام. كرّر هذا العلم لتخصيص عدة منافذ (مثل `--expose 8000 --expose 8001`). يمكن الوصول إلى كل منفذ مكشوف عبر نطاق المهام العام؛ ويتطلب الوصول رمز HF يملك صلاحية القراءة على مساحة أسماء المهمة.
* `--expose-public INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام دون مصادقة. كرر هذا العلم لتكرار المنفذ. لا حاجة أيضًا لتمرير المنفذ مع `--expose`.
* `--resource-group-id TEXT`: المعرّف الخاص بمجموعة الموارد التي سيتم إنشاء المهمة (Job) فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--with TEXT`: تشغيل البرنامج مع تثبيت الحزم المحددة
* `-p, --python TEXT`: مُفسّر بايثون الذي سيتم استخدامه لبيئة التشغيل
* `--format [agent|auto|human|json|quiet]`: صيغة المخرجات. القيمة الافتراضية هي 'auto' والتي تختار 'agent' أو 'human' بناءً على الطرفية.
* `--json`: إخراج بصيغة JSON. يعادل '--format json'.
* `-q, --quiet`: إخراج هادئ (معرّف واحد في كل سطر). يعادل '--format quiet'.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs scheduled uv run "0 0 * * *" --name daily-script script.py $ hf jobs scheduled uv run "0 0 * * *" script.py --with pandas

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs ssh`

The input is a single short phrase without any markup tags. I will translate it into natural Modern Standard Arabic, keeping the technical term "SSH" and "Job" in English as per the instructions for product/library/technical terms, while translating the surrounding prose.

إذا لم يكن Job قيد التشغيل بعد، ينتظر حتى يصل إلى حالة RUNNING قبل الاتصال. يتطلب بدء Job مع تفعيل SSH (`hf jobs run --ssh ...`) وتسجيل مفتاح SSH العام الخاص بك على https://huggingface.co/settings/keys.

**الاستخدام**:

```console
$ hf jobs ssh [OPTIONS] JOB_ID
```

**الحجج**:

* `JOB_ID`: معرّف المهمة (أو 'namespace/job_id') [إلزامي]

**الخيارات**:

* `-i, --identity-file PATH`: مسار ملف هوية SSH (يُمرَّر إلى `ssh -i`).
* `--dry-run`: طباعة أمر SSH بدلاً من تنفيذه.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs ssh $ hf jobs ssh  --dry-run $ hf jobs ssh  -i ~/.ssh/id_ed25519

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs stats`

جلب إحصائيات ومقاييس استخدام الموارد للوظائف.

يطبع لقطة إحصاءات الحالة الحالية ويخرج افتراضيًا (غير حاسم). استخدم --follow/-f لعرض الإحصاءات الحية حتى اكتمال المهام.

**الاستخدام**:

```console
$ hf jobs stats [OPTIONS] [JOB_IDS]...
```

**الحجج**:

* `[JOB_IDS]...`: معرّفات المهام (أو 'namespace/job_id')

**الخيارات**:

* `-f, --follow`: متابعة إحصاءات الإخراج (عرض مباشر حتى اكتمال المهام). بدون هذا العلم، يتم طبقة لقطة واحدة.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs stats $ hf jobs stats $ hf jobs stats -f

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs uv`

شغّل سكربتات UV (بايثون مع تبعيات مضمّنة) على بنية HF التحتية.

**الاستخدام**:

```console
$ hf jobs uv [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `run`: تشغيل سكريبت UV (ملف محلي أو رابط URL) على بنية HF التحتية

#### `hf jobs uv run`

تشغيل سكربت UV (ملف محلي أو رابط URL) على بنية HF التحتية

**الاستخدام**:

```console
$ hf jobs uv run [OPTIONS] SCRIPT [SCRIPT_ARGS]...
```

**الحجج**:

* `SCRIPT`: سكريبت UV للتنفيذ (ملف محلي أو عنوان URL) [إلزامي]
* `[SCRIPT_ARGS]...`: حُجج السكربت

**الخيارات**:

* `--image TEXT`: استخدم صورة Docker مخصصة مع تثبيت `uv`.
* `--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد. شغّل 'hf jobs hardware' لعرض الأنواع المتاحة. القيمة الافتراضية هي `cpu-basic`.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--name TEXT`: تسمية المهمة. تُخزَّن كوسم `name`. لا يجب أن تكون الأسماء فريدة. القيمة الافتراضية هي اسم الصورة أو السكربت مضافًا إليه تجزئة قصيرة من إعدادات التشغيل المُحدَّدة.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] أو LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. يكون TYPE أحد الخيارات التالية: models، datasets، spaces، buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. تُركَّب models وdatasets وspaces للقراءة فقط دائمًا. أما buckets فتُركَّب للقراءة والكتابة افتراضيًا. يُزامَن مصدر المجلد المحلي أولًا مع bucket ثم يُركَّب للقراءة فقط افتراضيًا. على سبيل المثال: -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro أو -v ./inputs:/inputs
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--timeout TEXT`: المدة القصوى: عدد صحيح مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام).
* `--attempts INTEGER RANGE`: الحد الأقصى لعدد المحاولات، بما في ذلك التشغيل الأولي. القيمة الافتراضية هي 1. [x>=1]
* `-d, --detach`: تشغيل المهمة في الخلفية وطباعة معرّف المهمة.
* `--dry-run`: طباعة إعدادات المهمة (Job) المُحدَّدة دون إرسالها.
* `--expose INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام. كرّر هذا العلم لتخصيص عدة منافذ (مثل `--expose 8000 --expose 8001`). يمكن الوصول إلى كل منفذ مكشوف عبر نطاق المهام العام؛ ويتطلب الوصول رمز HF يملك صلاحية القراءة على مساحة أسماء المهمة.
* `--expose-public INTEGER`: يُتيح الوصول إلى منفذ الحاوية عبر وكيل المهام دون مصادقة. كرر هذا العلم لتكرار المنفذ. لا حاجة أيضًا لتمرير المنفذ مع `--expose`.
* `--ssh`: يجعل حاوية المهمة قابلة للوصول عبر SSH. اتصل باستخدام `hf jobs ssh <job_id>`. يتطلب ذلك مفتاح SSH عام مسجلاً على https://huggingface.co/settings/keys.
* `--network-group TEXT`: الانضمام إلى مجموعة شبكة. تُجمع المهام الموجودة في نفس مساحة الاسم ومجموعة الموارد والتي تتشارك مجموعة واحدة معًا، وتصل إلى بعضها البعض عبر كل منفذ. داخل كل عضو، يُحل `$HF_NETWORK_GROUP_HOSTNAME` إلى كل عضو. أحرف صغيرة وأرقام وشرطات، بحد أقصى 46 حرفًا.
* `--network-alias TEXT`: ادّعاء مستعار ضمن مجموعة الشبكة. تصل الأعضاء إلى المهام التي تدّعيه عبر `${HF_NETWORK_GROUP_PREFIX}<alias>`. كرّر العلم لعدة مستعرات. أحرف أبجدية رقمية صغيرة وشرطات، بحد أقصى 34 حرفًا، فريدة ضمن المهمة. يتطلب `--network-group`.
* `--resource-group-id TEXT`: المعرّف الخاص بمجموعة الموارد التي سيتم إنشاء المهمة (Job) فيها. يُستخدم للتحكم في الوصول إلى الموارد داخل المنظمة وللميزات المتعلقة بتخصيص التكاليف وحدود الإنفاق.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--with TEXT`: تشغيل البرنامج مع تثبيت الحزم المحددة
* `-p, --python TEXT`: مُفسّر بايثون الذي سيتم استخدامه لبيئة التشغيل
* `--format [agent|auto|human|json|quiet]`: صيغة المخرجات. القيمة الافتراضية هي 'auto' والتي تختار 'agent' أو 'human' بناءً على الطرفية.
* `--json`: إخراج بصيغة JSON. يعادل '--format json'.
* `-q, --quiet`: إخراج هادئ (معرّف واحد في كل سطر). يعادل '--format quiet'.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs uv run --name my-script my_script.py $ hf jobs uv run --detach my_script.py $ hf jobs uv run --flavor a10g-small ml_training.py $ hf jobs uv run --with transformers train.py $ hf jobs uv run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt script.py $ hf jobs uv run --dry-run script.py

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf jobs wait`

انتظر حتى تصل وظيفة واحدة أو أكثر إلى حالة نهائية.

يتوقف حتى تنتهي جميع المهام (Jobs)، ثم يخرج برمز 0 إذا اكتملت جميع المهام بنجاح، أو برمز خروج غير صفري إذا أُلغيت أي مهمة أو حدث خطأ فيها أو حُذفت.

يجب أن تنتمي جميع المهام إلى نفس مساحة الاسم.

**الاستخدام**:

```console
$ hf jobs wait [OPTIONS] JOB_IDS...
```

**الحجج**:

* `JOB_IDS...`: معرّفات المهام التي يجب الانتظار لها (أو 'namespace/job_id'). [إلزامي]

**الخيارات**:

* `--timeout TEXT`: الحد الأقصى للوقت الذي يجب انتظاره: عدد صحيح مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام).
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf jobs wait $ hf jobs wait $ hf jobs ls -q | xargs hf jobs wait

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf lfs-enable-largefiles`

قم بإعداد مستودعك لتفعيل رفع الملفات التي يتجاوز حجمها 5 جيجابايت.

تقوم هذه الأوامر بإعداد git-lfs لاستخدام وكيل النقل متعدد الأجزاء المخصص، مما يتيح رفع الملفات الكبيرة بكفاءة على شكل أجزاء.

**الاستخدام**:

```console
$ hf lfs-enable-largefiles [OPTIONS] PATH
```

**الحجج**:

* `PATH`: المسار المحلي للمستودع الذي تريد تكوينه. [إلزامي]

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

## `hf lfs-multipart-upload`

وكيل نقل مخصص لـ git-lfs داخلي لعمليات رفع متعددة الأجزاء.

تنفّذ هذه الدالة بروتوكول النقل المخصّص لعمليات رفع متعددة الأجزاء عبر git-lfs. تتعامل مع عمليات رفع الملفات الكبيرة على شكل أجزاء إلى Hugging Face Hub.

**الاستخدام**:

```console
$ hf lfs-multipart-upload [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

## `hf models`

تفاعل مع النماذج على Hub.

**الاستخدام**:

```console
$ hf models [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `card`: احصل على بطاقة النموذج (README) لنموذج على Hub.
* `info`: احصل على معلومات حول نموذج على Hub.
* `list`: قائمة النماذج على Hub، أو الملفات في مستودع نموذج. [alias: ls]

### `hf models card`

احصل على بطاقة النموذج (README) لنموذج على Hub.

**الاستخدام**:

```console
$ hf models card [OPTIONS] MODEL_ID
```

**الحجج**:

* `MODEL_ID`: معرّف النموذج (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--metadata`: إخراج البيانات الوصفية من البطاقة فقط.
* `--text`: إخراج نص المحتوى فقط (بدون بيانات وصفية).
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf models card google/gemma-4-31B-it $ hf models card google/gemma-4-31B-it --metadata $ hf models card google/gemma-4-31B-it --metadata --format json $ hf models card google/gemma-4-31B-it --text

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf models info`

احصل على معلومات حول نموذج على Hub.

**الاستخدام**:

```console
$ hf models info [OPTIONS] MODEL_ID
```

**الحجج**:

* `MODEL_ID`: معرّف النموذج (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--expand TEXT`: خصائص مفصولة بفواصل للعودة بها. عند الاستخدام، تُعاد الخصائص المدرجة فقط (مع id). مثال: '--expand=downloads,likes,tags'. الصالحة: 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, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf models info meta-llama/Llama-3.2-1B-Instruct $ hf models info Qwen/Qwen3.5-9B --expand downloads,likes,tags

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf models list`

عرض النماذج على Hub أو الملفات في مستودع نموذج. [alias: ls]

عند الاستدعاء دون أي حجة، يعرض قائمة بالنماذج على Hub. وعند الاستدعاء مع معرّف نموذج، يعرض قائمة بالملفات في مستودع ذلك النموذج.

**الاستخدام**:

```console
$ hf models list [OPTIONS] [REPO_ID]
```

**الحجج**:

* `[REPO_ID]`: معرّف النموذج (مثل `username/repo-name`) لعرض الملفات منه. إذا تم تجاهله، يتم عرض النماذج.

**الخيارات**:

* `--search TEXT`: استعلام البحث.
* `--author TEXT`: تصفية حسب المؤلف أو المنظمة.
* `--filter TEXT`: تصفية حسب الوسوم (مثلًا 'text-classification'). يمكن استخدامه عدة مرات.
* `--pipeline-tag TEXT`: تصفية حسب وسم خط الأنابيب (المهمة الأساسية)، مثل 'summarization'.
* `--gated / --no-gated`: تصفية حسب حالة البوابة. استخدم '--gated' للبوابات فقط، و'--no-gated' للغير البوابات فقط.
* `--apps TEXT`: تصفية حسب التطبيق أو التطبيقات التي يمكنها تشغيل النموذج، مثل 'ollama' أو 'vllm'.
* `--num-parameters TEXT`: تصفية حسب عدد المعاملات، على سبيل المثال 'min:6B,max:128B'.
* `--inference-provider [baseten|cerebras|cohere|deepinfra|fal-ai|featherless-ai|fireworks-ai|groq|hf-inference|novita|nscale|openai|ovhcloud|publicai|replicate|scaleway|together|wavespeed|zai-org]`: تصفية حسب مزوّد الاستدلال الذي يقدّم النموذج، مثل 'fireworks-ai'.
* `--warm`: يعرض فقط النماذج التي يقدّمها مزوّد استدلال واحد على الأقل حاليًا.
* `--sort [created_at|downloads|last_modified|likes|trending_score]`: فرز النتائج.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 30]
* `--expand TEXT`: خصائص مفصولة بفواصل للعودة بها. عند الاستخدام، تُعاد الخصائص المدرجة فقط (مع id). مثال: '--expand=downloads,likes,tags'. الصالحة: 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, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.
* `-h, --human-readable`: عرض الأحجام بتنسيق قابل للقراءة البشرية (لإدراج الملفات فقط).
* `--tree`: قائمة الملفات بتنسيق الشجرة (لإدراج الملفات فقط).
* `-R, --recursive`: سرد الملفات بشكل متكرر (لعملية سرد الملفات فقط).
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf models ls --sort downloads --limit 10 $ hf models ls --search "llama" --author meta-llama $ hf models ls --pipeline-tag text-generation --warm $ hf models ls --num-parameters min:6B,max:128B --sort likes $ hf models ls --no-gated --author google $ hf models ls --apps llama.cpp --apps vllm $ hf models ls --inference-provider fireworks-ai --sort downloads $ hf models ls --warm --search llama $ hf models ls meta-llama/Llama-3.2-1B-Instruct $ hf models ls meta-llama/Llama-3.2-1B-Instruct -R $ hf models ls meta-llama/Llama-3.2-1B-Instruct --tree -h

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf papers`

تفاعل مع الأوراق البحثية على المنصة.

**الاستخدام**:

```console
$ hf papers [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `info`: احصل على معلومات حول ورقة بحثية على المنصة.
* `list`: يعرض قائمة الأوراق اليومية على Hub. [مستعار: ls]
* `read`: قراءة ورقة بحثية بصيغة Markdown.
* `search`: البحث عن الأوراق البحثية على المنصة.

### `hf papers info`

احصل على معلومات حول ورقة بحثية على المنصة.

**الاستخدام**:

```console
$ hf papers info [OPTIONS] PAPER_ID
```

**الحجج**:

* `PAPER_ID`: معرّف الورقة على arXiv (مثل '2502.08025'). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf papers info 2601.15621

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers list`

عرض الأوراق اليومية على Hub. [alias: ls]

**الاستخدام**:

```console
$ hf papers list [OPTIONS]
```

**الخيارات**:

* `--date TEXT`: التاريخ بتنسيق ISO (YYYY-MM-DD) أو 'اليوم'.
* `--week TEXT`: الأسبوع المعتمد وفق معيار ISO للترشيح، مثل '2025-W09'.
* `--month TEXT`: الشهر المراد التصفية به بتنسيق ISO (YYYY-MM)، مثل '2025-02'.
* `--submitter TEXT`: تصفية حسب اسم مستخدم المُقدِّم.
* `--sort [publishedAt|trending]`: فرز النتائج.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 50]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf papers ls $ hf papers ls --sort trending $ hf papers ls --date 2025-01-23 $ hf papers ls --week 2025-W09 $ hf papers ls --submitter akhaliq $ hf papers ls --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers read`

اقرأ ورقة بحثية بصيغة Markdown.

**الاستخدام**:

```console
$ hf papers read [OPTIONS] PAPER_ID
```

**الحجج**:

* `PAPER_ID`: معرّف الورقة على arXiv (مثل '2502.08025'). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf papers read 2601.15621

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf papers search`

ابحث عن الأوراق البحثية على Hub.

**الاستخدام**:

```console
$ hf papers search [OPTIONS] QUERY
```

**الحجج**:

* `QUERY`: نص استعلام البحث. [إلزامي]

**الخيارات**:

* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 20]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf papers search "vision language" $ hf papers search "attention mechanism" --limit 10 $ hf papers search "diffusion" --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf repos`

إدارة المستودعات على Hub.

**الاستخدام**:

```console
$ hf repos [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `branch`: إدارة الفروع في مستودع على Hub.
* `cp`: نسخ الملفات بين المسارات المحلية والمستودعات والدلاء.
* `create`: إنشاء مستودع جديد على Hub.
* `delete`: حذف مستودع من Hub.
* `delete-files`: حذف الملفات من مستودع على Hub.
* `duplicate`: نسخ مستودع على Hub (نموذج، مجموعة بيانات، أو مساحة).
* `list`: يعرض قائمة بجميع المستودعات (النماذج، مجموعات البيانات، المساحات، الدلاء) مع معلومات التخزين. [اسم آخر: ls]
* `move`: نقل مستودع من مساحة أسماء إلى مساحة أسماء أخرى.
* `settings`: تحديث إعدادات المستودع.
* `tag`: إدارة الوسوم الخاصة بمستودع على Hub.

### `hf repos branch`

إدارة الفروع في مستودع على Hub.

**الاستخدام**:

```console
$ hf repos branch [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `create`: إنشاء فرع جديد لمستودع على Hub.
* `delete`: حذف فرع من مستودع على Hub.

#### `hf repos branch create`

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

**الاستخدام**:

```console
$ hf repos branch create [OPTIONS] REPO_ID BRANCH
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `BRANCH`: اسم الفرع الذي سيتم إنشاؤه. [إلزامي]

**الخيارات**:

* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--exist-ok / --no-exist-ok`: إذا تم ضبطه على True، فلا يتم رفع خطأ إذا كان الفرع موجودًا مسبقًا. [الافتراضي: no-exist-ok]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos branch create my-model dev $ hf repos branch create my-model dev --revision abc123

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos branch delete`

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

**الاستخدام**:

```console
$ hf repos branch delete [OPTIONS] REPO_ID BRANCH
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `BRANCH`: اسم الفرع المراد حذفه. [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos branch delete my-model dev

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos cp`

انسخ الملفات بين المسارات المحلية والمستودعات والدلاء.

يتعامل مع عمليات الرفع (محلي/مدخل قياسي -> مستودع/دلو) والتنزيل (مستودع/دلو -> محلي/مخرج قياسي) والنسخ من عن بُعد إلى عن بُعد (مستودع/دلو -> مستودع/دلو). لا يتم دعم النسخ من الدلو إلى المستودع أو من المحلي إلى المحلي. بالنسبة للمجلدات، استخدم `hf upload`/`hf download` (للمستودعات) أو `hf buckets sync` (للدلاء). تعمل عمليات النسخ من عن بُعد إلى عن بُعد فقط ضمن نفس منطقة التخزين (https://huggingface.co/docs/hub/storage-regions).

**الاستخدام**:

```console
$ hf repos cp [OPTIONS] SRC [DST]
```

**الحجج**:

* `SRC`: المصدر: ملف محلي، أو عنوان URI بصيغة hf:// (مستودع أو دلو)، أو - لمدخل المعيار. [إلزامي]
* `[DST]`: الوجهة: مسار محلي، أو URI بصيغة hf:// (مستودع أو دلو)، أو - لمخرج المعيار.

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos cp hf://username/my-model/config.json config.json $ hf repos cp hf://datasets/username/my-dataset/data.csv data/ $ hf repos cp hf://username/my-model/config.json - $ hf repos cp model.safetensors hf://username/my-model/model.safetensors $ hf repos cp config.json hf://username/my-model/logs/ $ hf repos cp - hf://username/my-model/config.json $ hf repos cp hf://username/source-model/config.json hf://username/dest-model/config.json $ hf repos cp hf://datasets/username/my-dataset/processed/ hf://datasets/username/dest-dataset/processed/ $ hf repos cp hf://username/my-model/logs/ hf://username/archive-model/logs/

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos create`

أنشئ مستودعًا جديدًا على Hub.

**الاستخدام**:

```console
$ hf repos create [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--sdk, --space-sdk TEXT`: نوع SDK الخاص بـ Hugging Face Spaces. مطلوب عند ضبط --type على 'space'.
* `--template TEXT`: إنشاء مساحة من قالب رسمي. مرّر معرّف مستودع القالب (مثل 'SpacesExamples/jupyterlab') أو اسمه المختصر (مثل 'JupyterLab'). لعرض القوالب المتاحة، استخدم `hf spaces templates`. للمساحات فقط.
* `--private / --no-private`: ما إذا كان يجب إنشاء مستودع خاص إذا لم يكن المستودع موجودًا على Hub. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--public`: ما إذا كان سيتم جعل المستودع عامًا. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--protected`: ما إذا كان سيتم جعل المساحة محمية (المساحات فقط). يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--exist-ok / --no-exist-ok`: لا ترفع خطأً إذا كان المستودع موجودًا مسبقًا. [الافتراضي: no-exist-ok]
* `--resource-group-id TEXT`: مجموعة الموارد التي سيتم إنشاء المستودع فيها. مجموعات الموارد متاحة فقط لمنظمات Enterprise Hub.
* `--region [us|eu]`: منطقة السحابة التي سيتم فيها إنشاء المستودع. يمكن أن تكون إما 'us' أو 'eu'. يتطلب خطة Team أو أعلى.
* `--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد في Spaces (مثل 'cpu-basic'، 't4-medium'، 'l4x4'). خاص بـ Spaces فقط.
* `--sleep-time INTEGER`: عدد ثوانٍ من عدم النشاط قبل وضع المساحة في وضع السكون. استخدم -1 لتعطيل ذلك. خاص بالمساحات فقط.
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. يكون TYPE أحد ما يلي: models, datasets, spaces, buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. يتم تركيب models وdatasets وspaces للقراءة فقط دائمًا. يتم تركيب buckets للقراءة والكتابة افتراضيًا. على سبيل المثال: -v hf://org/m:/data أو -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos create my-model $ hf repos create my-dataset --repo-type dataset --private $ hf repos create my-space --type space --sdk gradio --flavor t4-medium --secrets HF_TOKEN -e THEME=dark --protected $ hf repos create my-jupyterlab --type space --template SpacesExamples/jupyterlab $ hf repos create my-space --type space --sdk gradio -v hf://org/my-model:/models -v hf://buckets/org/b:/data $ hf repos create my-model --region us

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos delete`

حذف مستودع من Hub. هذه عملية لا يمكن التراجع عنها.

**الاستخدام**:

```console
$ hf repos delete [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--missing-ok / --no-missing-ok`: إذا تم ضبطه على True، فلن يتم رفع خطأ إذا لم يكن المستودع موجودًا. [الافتراضي: no-missing-ok]
* `-y, --yes`: الإجابة بنعم تلقائيًا على الاستعلام.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos delete my-model

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos delete-files`

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

**الاستخدام**:

```console
$ hf repos delete-files [OPTIONS] REPO_ID PATTERNS...
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `PATTERNS...`: أنماط Glob لمطابقة الملفات المراد حذفها. مبنية على fnmatch، حيث يطابق '*' الملفات بشكل متكرر. [إلزامي]

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--commit-message TEXT`: ملخص / عنوان / السطر الأول للالتزام المولّد.
* `--commit-description TEXT`: وصف الالتزام المُولَّد.
* `--create-pr / --no-create-pr`: ما إذا كان سيتم إنشاء طلب سحب جديد لهذه التغييرات. [الافتراضي: no-create-pr]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos delete-files my-model file.txt $ hf repos delete-files my-model "*.json" $ hf repos delete-files my-model folder/

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos duplicate`

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

**الاستخدام**:

```console
$ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]
```

**الحجج**:

* `FROM_ID`: معرّف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `[TO_ID]`: معرف المستودع الوجهة (مثل `myorg/my-copy`). الافتراضي هو مساحة الأسماء الخاصة بك مع نفس اسم المستودع.

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--private / --no-private`: ما إذا كان يجب إنشاء مستودع خاص إذا لم يكن المستودع موجودًا على Hub. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--public`: ما إذا كان سيتم جعل المستودع عامًا. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--protected`: ما إذا كان سيتم جعل المساحة محمية (المساحات فقط). يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--exist-ok / --no-exist-ok`: لا ترفع خطأً إذا كان المستودع موجودًا مسبقًا. [الافتراضي: no-exist-ok]
* `--resource-group-id TEXT`: مجموعة الموارد التي سيتم إنشاء المستودع الجديد فيها. مجموعات الموارد متاحة فقط لمنظمات Enterprise Hub.
* `--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد في Spaces (مثل 'cpu-basic'، 't4-medium'، 'l4x4'). خاص بـ Spaces فقط.
* `--sleep-time INTEGER`: عدد ثوانٍ من عدم النشاط قبل وضع المساحة في وضع السكون. استخدم -1 لتعطيل ذلك. خاص بالمساحات فقط.
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. يكون TYPE أحد ما يلي: models, datasets, spaces, buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. يتم تركيب models وdatasets وspaces للقراءة فقط دائمًا. يتم تركيب buckets للقراءة والكتابة افتراضيًا. على سبيل المثال: -v hf://org/m:/data أو -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos duplicate openai/gdpval --type dataset $ hf repos duplicate multimodalart/dreambooth-training my-dreambooth --type space --flavor l4x4 --secrets HF_TOKEN --private $ hf repos duplicate org/my-space my-space --type space -v hf://org/my-model:/models -v hf://buckets/org/b:/data

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos list`

List all repos (models, datasets, spaces, buckets) with storage info. [alias: ls]

**الاستخدام**:

```console
$ hf repos list [OPTIONS]
```

**الخيارات**:

* `--namespace TEXT`: اسم المنظمة. إذا لم يُقدَّم، تُعرض مستودعات المستخدم المصادَق.
* `--type, --repo-type [model|dataset|space|bucket]`: تصفية حسب نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو دلو).
* `--search TEXT`: استعلام البحث.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 30]
* `--explore`: استكشف مستودعاتك كمدينة ثلاثية الأبعاد تفاعلية.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos ls $ hf repos ls --explore $ hf repos ls --namespace my-org --search bert

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos move`

نقل مستودع من مساحة أسماء إلى مساحة أسماء أخرى.

**الاستخدام**:

```console
$ hf repos move [OPTIONS] FROM_ID TO_ID
```

**الحجج**:

* `FROM_ID`: معرّف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `TO_ID`: معرّف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos move old-namespace/my-model new-namespace/my-model

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos settings`

تحديث إعدادات المستودع.

**الاستخدام**:

```console
$ hf repos settings [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--gated [auto|manual|false]`: حالة التفعيل (gated) للمستودع.
* `--private / --no-private`: ما إذا كان يجب إنشاء مستودع خاص إذا لم يكن المستودع موجودًا على Hub. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--public`: ما إذا كان سيتم جعل المستودع عامًا. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--protected`: ما إذا كان سيتم جعل المساحة محمية (المساحات فقط). يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos settings my-model --private $ hf repos settings my-model --gated auto $ hf repos settings my-space --repo-type space --protected

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf repos tag`

إدارة الوسوم الخاصة بمستودع على Hub.

**الاستخدام**:

```console
$ hf repos tag [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `create`: إنشاء وسم لمستودع.
* `delete`: حذف وسم من مستودع.
* `list`: قائمة وسوم مستودع. [مستعار: ls]

#### `hf repos tag create`

أنشئ وسمًا لخزينة.

**الاستخدام**:

```console
$ hf repos tag create [OPTIONS] REPO_ID TAG
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `TAG`: اسم الوسم الذي تريد إنشاؤه. [إلزامي]

**الخيارات**:

* `-m, --message TEXT`: وصف العلامة التي سيتم إنشاؤها.
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos tag create my-model v1.0 $ hf repos tag create my-model v1.0 -m "First release"

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos tag delete`

حذف وسم من مستودع.

**الاستخدام**:

```console
$ hf repos tag delete [OPTIONS] REPO_ID TAG
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `TAG`: اسم الوسم المراد حذفه. [إلزامي]

**الخيارات**:

* `-y, --yes`: الإجابة بنعم تلقائيًا على الاستعلام
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos tag delete my-model v1.0

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf repos tag list`

قائمة وسوم مستودع. [alias: ls]

**الاستخدام**:

```console
$ hf repos tag list [OPTIONS] REPO_ID
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: model]
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf repos tag list my-model

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf sandbox`

شغّل وأدر بيئات تجريبية على Hugging Face Jobs.

**الاستخدام**:

```console
$ hf sandbox [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `cp`: نسخ ملف بين الجهاز المحلي وعملية العزل (على غرار docker).
* `create`: إنشاء بيئة معزولة: جهاز افتراضي مخصص افتراضيًا، أو جهاز مشترك منخفض التكلفة باستخدام `--pool`.
* `exec`: تشغيل أمر في بيئة معزولة، مع بث المخرجات.
* `kill`: إنهاء بيئة العزل، أو مضيف مشترك بالكامل، أو كل شيء (--all).
* `pool`: مسابح مضيفين افتراضيين جاهزة، وتوليد بيئات معزولة تجريبية مشتركة للأحمال العاملة ضمن نفس حدود الثقة.
* `process`: قائمة العمليات الخلفية الجارية في بيئة العزل وإيقافها.
* `spawn`: بدء أمر طويل الأمد في الخلفية وإرجاع معرّف العملية الخاص به (دون انتظار).

### `hf sandbox cp`

نسخ ملف بين الجهاز المحلي وعزل (على غرار docker).

**الاستخدام**:

```console
$ hf sandbox cp [OPTIONS] SRC DST
```

**الحجج**:

* `SRC`: المصدر: مسار محلي أو :. [إلزامي]
* `DST`: الوجهة: مسار محلي أو :. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox cp data.csv :/data/data.csv $ hf sandbox cp :/app/result.json result.json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox create`

أنشئ بيئة معزولة: جهاز افتراضي مخصص افتراضيًا، أو جهاز مشترك منخفض التكلفة باستخدام `--pool`.

Env and idle-timeout apply to the sandbox in both modes. With `--pool`, the image and flavor come from the pool, so passing them here is an error; `--secrets` is also rejected since pooled sandboxes have no encrypted-secrets channel (use `--env`). Define a pool first with `hf sandbox pool create`.

**الاستخدام**:

```console
$ hf sandbox create [OPTIONS] [IMAGE]
```

**الحجج**:

* `[IMAGE]`: صورة Docker (تتطلب /bin/sh).

**الخيارات**:

* `--pool TEXT`: إنشاء صندوق رمل مشترك منخفض التكلفة في هذا المسبح (من `hf sandbox pool create`).
* `--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد. شغّل 'hf jobs hardware' لعرض الأنواع المتاحة. القيمة الافتراضية هي `cpu-basic`.
* `--idle-timeout TEXT`: إنهاء العزل تلقائيًا بعد هذه المدة من عدم النشاط (مثلًا '10m'). القيمة الافتراضية هي 10m.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `-l, --label TEXT`: تعيين التسميات. على سبيل المثال --label KEY=VALUE أو --label LABEL
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. يكون TYPE أحد ما يلي: models, datasets, spaces, buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. يتم تركيب models وdatasets وspaces للقراءة فقط دائمًا. يتم تركيب buckets للقراءة والكتابة افتراضيًا. على سبيل المثال: -v hf://org/m:/data أو -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--forward-hf-token`: حقن رمز HF الخاص بك في بيئة العزل كـ HF_TOKEN.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox create $ hf sandbox create ubuntu:24.04 $ hf sandbox create --flavor a10g-small $ hf sandbox create --label controller-run=run-42 $ hf sandbox create --pool pool-ab12cd34ef56 --env LOG_LEVEL=debug

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox exec`

نفّذ أمرًا في بيئة معزولة، مع بث المخرجات. ينتهي برمز الخروج الخاص بالأمر.

لبدء أمر يستغرق وقتًا طويلاً في الخلفية بدلاً من الانتظار حتى اكتماله، استخدم `hf sandbox spawn`.

**الاستخدام**:

```console
$ hf sandbox exec [OPTIONS] SANDBOX_ID COMMAND...
```

**الحجج**:

* `SANDBOX_ID`: معرّف بيئة العزل كما يطبعه `hf sandbox create`. [إلزامي]
* `COMMAND...`: الأمر الذي سيتم تنفيذه. [إلزامي]

**الخيارات**:

* `-w, --workdir TEXT`: مجلد العمل.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--timeout FLOAT`: إنهاء الأمر بعد هذا العدد من الثواني.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox exec  -- python -c "print(42)" $ hf sandbox exec -w /app  -- pytest -x

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox kill`

إنهاء صندوق رمل، مضيف مشترك كامل، أو كل شيء (--all).

**الاستخدام**:

```console
$ hf sandbox kill [OPTIONS] [SANDBOX_ID]
```

**الحجج**:

* `[SANDBOX_ID]`: معرّف بيئة العزل أو المضيف الذي سيتم إنهاءه.

**الخيارات**:

* `--all`: إنهاء جميع بيئات العزل والوحدات المضيفة في مساحة الاسم.
* `-y, --yes`: الإجابة بنعم على الطلبات تلقائيًا.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox kill $ hf sandbox kill    # kills a whole shared host (all its sandboxes) $ hf sandbox kill --all

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox pool`

أنشئ مجمّعات لأجهزة الاستضافة الدافئة وأطلق صناديق رملية مشتركة تجريبية لأحمال العمل ضمن حدود الثقة نفسها.

**الاستخدام**:

```console
$ hf sandbox pool [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `create`: تجهيز مجموعة: تشغيل مضيف افتراضي واحد الآن، مع وضع علامة عليه بحيث يمكن العثور عليه لاحقًا عبر معرّف المجموعة الخاص به.
* `delete`: إنهاء جميع مضيفات VM الخاصة بحوض (وبالتالي جميع بيئاته العازلة). [اسم مستعار: rm]
* `ls`: يعرض مجموعات الرمال قيد التشغيل (مجمّعة من وحداتها الافتراضية المضيفة). [اسم مستعار: list]

#### `hf sandbox pool create`

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

**الاستخدام**:

```console
$ hf sandbox pool create [OPTIONS] [IMAGE]
```

**الحجج**:

* `[IMAGE]`: صورة Docker للمضيفين (يتطلب /bin/sh).

**الخيارات**:

* `--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد. شغّل 'hf jobs hardware' لعرض الأنواع المتاحة. القيمة الافتراضية هي `cpu-basic`.
* `--per-host INTEGER RANGE`: عدد البيئات المعزولة المعبأة لكل جهاز افتراضي مضيف (الافتراضي 50). [الافتراضي: 50; x>=1]
* `--max-hosts INTEGER RANGE`: حد اختياري لعدد أجهزة الظل المستضيفة. [x>=1]
* `--idle-timeout TEXT`: إيقاف تشغيل مضيف بعد مرور هذه المدة دون وجود صناديق رملية (e.g. '10m'). القيمة الافتراضية هي 10m.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox pool create $ hf sandbox pool create python:3.12 --flavor cpu-basic $ hf sandbox pool create --per-host 50 --idle-timeout 30m

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox pool delete`

إنهاء كل آلة افتراضية مضيف في مجموعة (وبالتالي جميع بيئاتها المعزولة). [اسم مستعار: rm]

**الاستخدام**:

```console
$ hf sandbox pool delete [OPTIONS] POOL_ID
```

**الحجج**:

* `POOL_ID`: معرّف المجموعة المراد حذفها. [إلزامي]

**الخيارات**:

* `-y, --yes`: الإجابة بنعم على الطلبات تلقائيًا.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox pool delete

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox pool ls`

عرض أحواض العزل قيد التشغيل (مجمّعة من وحداتها الافتراضية المضيفة). [alias: list]

**الاستخدام**:

```console
$ hf sandbox pool ls [OPTIONS]
```

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox pool ls

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox process`

قائمة العمليات الخلفية الجارية في بيئة العزل وإيقافها.

**الاستخدام**:

```console
$ hf sandbox process [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `kill`: إيقاف عملية خلفية تعمل داخل بيئة معزولة.
* `ls`: يعرض قائمةً بالعمليات الخلفية العاملة داخل بيئة العزل (التي تم إطلاقها عبر `hf sandbox spawn`). [اسم آخر: list]

#### `hf sandbox process kill`

إيقاف عملية خلفية تعمل في بيئة معزولة.

**الاستخدام**:

```console
$ hf sandbox process kill [OPTIONS] SANDBOX_ID PID
```

**الحجج**:

* `SANDBOX_ID`: معرّف بيئة العزل كما يطبعه `hf sandbox create`. [إلزامي]
* `PID`: المعرف كما يظهره الأمر `hf sandbox process ls`. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox process kill

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf sandbox process ls`

قائمة العمليات الخلفية التي تعمل داخل بيئة العزل (التي تم إطلاقها عبر `hf sandbox spawn`). [alias: list]

**الاستخدام**:

```console
$ hf sandbox process ls [OPTIONS] SANDBOX_ID
```

**الحجج**:

* `SANDBOX_ID`: معرّف بيئة العزل كما يطبعه `hf sandbox create`. [إلزامي]

**الخيارات**:

* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox process ls

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf sandbox spawn`

ابدأ أمرًا طويل المدة في الخلفية وأعد معرّف العملية الخاص به (pid) دون انتظار.

استعرض عمليات بيئة العزل باستخدام `hf sandbox process ls` وأوقف إحداها باستخدام `hf sandbox process kill`.

**الاستخدام**:

```console
$ hf sandbox spawn [OPTIONS] SANDBOX_ID COMMAND...
```

**الحجج**:

* `SANDBOX_ID`: معرّف بيئة العزل كما يطبعه `hf sandbox create`. [إلزامي]
* `COMMAND...`: الأمر الذي سيتم تشغيله في الخلفية. [إلزامي]

**الخيارات**:

* `-w, --workdir TEXT`: مجلد العمل.
* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--namespace TEXT`: مساحة الاسم التي سيعمل فيها المهمة. الافتراضي هو مساحة اسم المستخدم الحالي.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf sandbox spawn  -- python -m http.server 8000 $ hf sandbox spawn -w /app  -- uvicorn app:app

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf skills`

إدارة المهارات لمساعدات الذكاء الاصطناعي.

**الاستخدام**:

```console
$ hf skills [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `add`: تثبيت مهارة من Hugging Face لمساعد ذكاء اصطناعي.
* `list`: يعرض المهارات المتاحة من سوق Hugging Face. [اختصار: ls]
* `preview`: طباعة الملف `hf-cli` SKILL.md المولّد إلى الإخراج القياسي.
* `update`: تحديث مهارات سوق Hugging Face المثبتة.

### `hf skills add`

قم بتثبيت مهارة من Hugging Face لمساعد ذكاء اصطناعي.

يتم توليد مهارة `hf-cli` الافتراضية محليًا من إصدار CLI المثبت؛ بينما تُحمَّل المهارات الأخرى من سوق Hugging Face. الموقع الافتراضي هو في المجلد الحالي (.agents/skills) أو على مستوى المستخدم (~/.agents/skills). كما يتم إنشاء رابط رمزي للمهارة داخل مجلد مهارات Claude Code (`.claude/skills` أو `~/.claude/skills`، مع مراعاة `CLAUDE_CONFIG_DIR` عند تعيينه)، ما لم يتم استخدام `--dest`.

**الاستخدام**:

```console
$ hf skills add [OPTIONS] [NAME]
```

**الحجج**:

* `[NAME]`: اسم مهارة السوق.

**الخيارات**:

* `-g, --global`: تثبيت على مستوى المستخدم بدلاً من تثبيتها في مجلد المشروع الحالي.
* `--dest PATH`: تثبيت في وجهة مخصصة (المسار إلى مجلد المهارات).
* `--force`: تجاوز المهارات الموجودة مسبقًا في الوجهة.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf skills add $ hf skills add huggingface-gradio --dest=~/my-skills $ hf skills add --global $ hf skills add huggingface-gradio --global

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf skills list`

قائمة المهارات المتاحة من سوق Hugging Face. [alias: ls]

**الاستخدام**:

```console
$ hf skills list [OPTIONS]
```

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf skills list $ hf skills list --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf skills preview`

اطبع ملف `hf-cli` SKILL.md المولّد إلى stdout.

**الاستخدام**:

```console
$ hf skills preview [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

### `hf skills update`

تحديث مهارات سوق Hugging Face المثبتة.

**الاستخدام**:

```console
$ hf skills update [OPTIONS] [NAME]
```

**الحجج**:

* `[NAME]`: اسم المهارة المثبتة الاختياري الذي سيتم تحديثه.

**الخيارات**:

* `-g, --global`: استخدام مجلدات المهارات العامة بدلاً من المشروع الحالي.
* `--dest PATH`: تحديث المهارات في دليل مخصص للمهارات.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf skills update $ hf skills update hf-cli $ hf skills update huggingface-gradio --dest=~/my-skills $ hf skills update -g

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf spaces`

التفاعل مع المساحات على Hub.

**الاستخدام**:

```console
$ hf spaces [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `card`: احصل على بطاقة المساحة (README) لمساحة على Hub.
* `dev-mode`: تفعيل أو تعطيل وضع التطوير على مساحة.
* `hardware`: قائمة خيارات الأجهزة المتاحة لـ Spaces.
* `hot-reload`: إعادة تحميل أي ملف بايثون في مساحة دون الحاجة إلى إعادة بناء كاملة وإعادة تشغيل.
* `info`: احصل على معلومات حول مساحة على Hub.
* `list`: يعرض قائمة بالمساحات على Hub أو الملفات داخل مستودع مساحة. [مستعار: ls]
* `logs`: جلب سجلات التشغيل أو البناء لمساحة.
* `pause`: إيقاف مساحة.
* `restart`: إعادة تشغيل مساحة.
* `search`: البحث في المساحات على Hub باستخدام البحث الدلالي.
* `secrets`: إدارة الأسرار الخاصة بمساحة على Hub.
* `settings`: تحديث إعدادات مساحة.
* `ssh`: الدخول إلى حاوية وضع التطوير (Dev Mode) الخاصة بـ Space عبر SSH.
* `templates`: قائمة قوالب المساحات المتاحة.
* `variables`: إدارة متغيرات البيئة لمساحة على Hub.
* `volumes`: إدارة أحجام التخزين لمساحة على Hub.
* `wait`: انتظار انتهاء مساحة من عملية البناء/التشغيل.
* `zero-gpu`: إدارة استخدامك لـ ZeroGPU على Hub.

### `hf spaces card`

احصل على بطاقة المساحة (README) لمساحة على Hub.

**الاستخدام**:

```console
$ hf spaces card [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--metadata`: إخراج البيانات الوصفية من البطاقة فقط.
* `--text`: إخراج نص المحتوى فقط (بدون بيانات وصفية).
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces card mteb/leaderboard $ hf spaces card mteb/leaderboard --metadata $ hf spaces card mteb/leaderboard --metadata --format json $ hf spaces card mteb/leaderboard --text

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces dev-mode`

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

يسهّل وضع التطوير في Spaces عملية تصحيح أخطاء تطبيقك ويجعل تكرار العمل على Spaces أسرع من خلال السماح لك بإعادة تشغيل تطبيقك دون إيقاف حاوية Space نفسها. يتطلب تفعيل وضع التطوير اشتراكًا بخطة PRO أو Team & Enterprise. أما تعطيله (`--stop`) فهو مسموح دائمًا.

راجع التوثيق: https://huggingface.co/docs/hub/spaces-dev-mode

**الاستخدام**:

```console
$ hf spaces dev-mode [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--stop / --no-stop`: إيقاف وضع التطوير. [الافتراضي: no-stop]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces dev-mode my-user-name/deepsite

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces hardware`

قائمة خيارات الأجهزة المتاحة للمساحات.

**الاستخدام**:

```console
$ hf spaces hardware [OPTIONS]
```

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces hardware

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces hot-reload`

إعادة تحميل أي ملف Python في مساحة دون الحاجة إلى إعادة بناء كاملة وإعادة تشغيل.

⚠ هذه الميزة تجريبية ⚠

يعمل فقط مع Gradio SDK (6.1+) يفتح محررًا تفاعليًا ما لم يتم تحديد --local-file/-f.

يعمل هذا الأمر على تعديل عملية بايثون النشطة باستخدام https://github.com/breuleux/jurigged (مقارنة فروق مبنية على AST، وتحديثات الدوال في مكانها، وما إلى ذلك)، مع تكامله مع دعم إعادة التحميل الفوري الأصلية في Gradio (أي أن تغييرات كائن عرض Gradio تنعكس في واجهة المستخدم)

ينشئ الأمر التزامًا عن بُعد. إذا كنت تعمل من نسخة محلية، فقم بتشغيل `git pull --autostash` بعد ذلك لجلب الالتزام وإبقاء حالة git المحلية متزامنة.

**الاستخدام**:

```console
$ hf spaces hot-reload [OPTIONS] SPACE_ID [FILENAME]
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]
* `[FILENAME]`: المسار إلى ملف بايثون في مستودع Space. يمكن تركه فارغًا عند تحديد --local-file إذا كان المسار في المستودع مطابقًا.

**الخيارات**:

* `-f, --local-file PATH`: مسار الملف المحلي. وضع المحرر التفاعلي إذا لم يتم تحديده
* `--skip-checks / --no-skip-checks`: تجاوز فحوصات توافق إعادة التحميل السريع. [الافتراضي: no-skip-checks]
* `--skip-summary / --no-skip-summary`: تجاوز عرض الملخص بعد تفعيل إعادة التحميل الساخن [الافتراضي: no-skip-summary]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces hot-reload username/repo-name app.py     # Open an interactive editor to the remote app.py file $ hf spaces hot-reload username/repo-name -f app.py  # Take local version from ./app.py and patch app.py remotely $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Take local version from ./src/app.py

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces info`

احصل على معلومات حول مساحة على Hub.

**الاستخدام**:

```console
$ hf spaces info [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--expand TEXT`: خصائص مفصولة بفواصل للعودة بها. عند الاستخدام، تُعاد الخصائص المدرجة فقط (مع id). مثال: '--expand=likes,tags'. الصالحة: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces info enzostvs/deepsite $ hf spaces info gradio/theme_builder --expand sdk,runtime,likes

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces list`

ls

عند الاستدعاء دون أي حجة، يعرض قائمة بالمساحات على Hub. عند الاستدعاء مع معرف مساحة، يعرض قائمة بالملفات في مستودع تلك المساحة.

**الاستخدام**:

```console
$ hf spaces list [OPTIONS] [REPO_ID]
```

**الحجج**:

* `[REPO_ID]`: معرف المساحة (مثل `username/repo-name`) لذكر الملفات منها. إذا تم تجاهله، يتم ذكر المساحات.

**الخيارات**:

* `--search TEXT`: استعلام البحث.
* `--author TEXT`: تصفية حسب المؤلف أو المنظمة.
* `--filter TEXT`: تصفية حسب الوسوم (مثلًا 'text-classification'). يمكن استخدامه عدة مرات.
* `--sort [created_at|last_modified|likes|trending_score]`: فرز النتائج.
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 30]
* `--expand TEXT`: خصائص مفصولة بفواصل للعودة بها. عند الاستخدام، تُعاد الخصائص المدرجة فقط (مع id). مثال: '--expand=likes,tags'. الصالحة: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage.
* `-h, --human-readable`: عرض الأحجام بتنسيق قابل للقراءة البشرية (لإدراج الملفات فقط).
* `--tree`: قائمة الملفات بتنسيق الشجرة (لإدراج الملفات فقط).
* `-R, --recursive`: سرد الملفات بشكل متكرر (لعملية سرد الملفات فقط).
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces ls --limit 10 $ hf spaces ls --search "chatbot" --author huggingface $ hf spaces ls victor/deepsite $ hf spaces ls victor/deepsite -R $ hf spaces ls victor/deepsite --tree -h

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces logs`

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

يطبع بشكل افتراضي سجلات التشغيل المتاحة حاليًا ثم يخرج (غير حاسم، مثل `docker logs`). استخدم --follow/-f لبث السجلات حتى يغلق الخادم البث. استخدم --build لعرض سجلات بناء الحاوية بدلاً من ذلك (مفيد عندما يكون Space عالقًا في BUILD_ERROR).

**الاستخدام**:

```console
$ hf spaces logs [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--build`: لجلب سجلات بناء الحاوية بدلاً من سجلات التشغيل. مفيد عندما يكون المساحة عالقة في حالة BUILD_ERROR.
* `-f, --follow`: متابعة مخرجات السجلات (بث مستمر حتى يغلق الخادم البث). بدون هذا العلم، يتم طباعة السجلات المتاحة حاليًا فقط.
* `-n, --tail INTEGER`: عدد الأسطر التي يجب عرضها من نهاية السجلات.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces logs username/my-space $ hf spaces logs username/my-space --build $ hf spaces logs -f username/my-space $ hf spaces logs -n 50 username/my-space

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces pause`

إيقاف مساحة مؤقتًا.

**الاستخدام**:

```console
$ hf spaces pause [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces pause username/my-space

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces restart`

إعادة تشغيل مساحة.

**الاستخدام**:

```console
$ hf spaces restart [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--factory-reboot`: إعادة بناء المساحة من الصفر دون استخدام ذاكرة التخزين المؤقت للبناء.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces restart username/my-space $ hf spaces restart username/my-space --factory-reboot

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces search`

استخدم البحث الدلالي للبحث في مساحات البحث على Hub.

**الاستخدام**:

```console
$ hf spaces search [OPTIONS] QUERY
```

**الحجج**:

* `QUERY`: استعلام البحث. [إلزامي]

**الخيارات**:

* `--filter TEXT`: تصفية حسب الوسوم (مثلًا 'text-classification'). يمكن استخدامه عدة مرات.
* `--sdk TEXT`: تصفية حسب SDK (مثل gradio، docker، static).
* `--include-non-running / --no-include-non-running`: تضمين المساحات غير النشطة في النتائج. [الافتراضي: no-include-non-running]
* `--description / --no-description`: عرض الأوصاف المولّدة بالذكاء الاصطناعي. [الافتراضي: no-description]
* `--limit INTEGER`: تحديد عدد النتائج. [الافتراضي: 10]
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces search "generate image" $ hf spaces search "identify objects in pictures" --sdk gradio --limit 5 $ hf spaces search "remove background from photo" --description --json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces secrets`

إدارة الأسرار الخاصة بمساحة على Hub.

**الاستخدام**:

```console
$ hf spaces secrets [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `add`: إضافة أو تحديث الأسرار الخاصة بمساحة.
* `delete`: إزالة سر من مساحة.
* `list`: قائمة الأسرار الخاصة بمساحة. [مستعار: ls]

#### `hf spaces secrets add`

إضافة أو تحديث الأسرار الخاصة بمساحة.

**الاستخدام**:

```console
$ hf spaces secrets add [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces secrets add username/my-space -s HF_TOKEN $ hf spaces secrets add username/my-space -s OPENAI_API_KEY=sk-... -s ANTHROPIC_API_KEY=sk-... $ hf spaces secrets add username/my-space --secrets-file .env.secrets

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces secrets delete`

إزالة سر من مساحة.

**الاستخدام**:

```console
$ hf spaces secrets delete [OPTIONS] SPACE_ID KEY
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]
* `KEY`: اسم السر المراد حذفه. [إلزامي]

**الخيارات**:

* `-y, --yes`: الإجابة بنعم تلقائيًا على الاستعلام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces secrets delete username/my-space HF_TOKEN $ hf spaces secrets delete username/my-space HF_TOKEN --yes

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces secrets list`

قائمة الأسرار الخاصة بمساحة. قيم الأسرار قابلة للكتابة فقط ولا تُعاد. [alias: ls]

**الاستخدام**:

```console
$ hf spaces secrets list [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces secrets ls username/my-space

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces settings`

تحديث إعدادات مساحة.

**الاستخدام**:

```console
$ hf spaces settings [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--sleep-time INTEGER`: وقت الخمول بالثواني الذي يذهب بعده المساحة إلى وضع النوم. استخدم -1 لعدم النوم أبدًا. متاح فقط على الأجهزة المطوّرة.
* `--hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]`: نوع العتاد في Space (مثل 'cpu-basic'، 't4-medium'، 'l4x4'). شغّل 'hf spaces hardware' لعرض الخيارات المتاحة.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces settings username/my-space --sleep-time 300 $ hf spaces settings username/my-space --hardware t4-medium

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces ssh`

ssh إلى حاوية وضع التطوير (Dev Mode) الخاصة بمساحة (Space).

يتطلب تشغيل وضع التطوير على المساحة وتسجيل مفتاح SSH العام الخاص بك على https://huggingface.co/settings/keys.

انظر إلى: https://huggingface.co/docs/hub/spaces-dev-mode

**الاستخدام**:

```console
$ hf spaces ssh [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `-i, --identity-file PATH`: مسار ملف هوية SSH (يُمرَّر إلى `ssh -i`).
* `--dry-run`: طباعة أمر SSH بدلاً من تنفيذه.
* `--auto`: تفعيل وضع التطوير دون طلب تأكيد إذا لم يكن مفعلاً مسبقًا.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces ssh username/my-space $ hf spaces ssh username/my-space --dry-run $ hf spaces ssh username/my-space -i ~/.ssh/id_ed25519 $ hf spaces ssh username/my-space --auto

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces templates`

قائمة قوالب المساحات المتاحة.

يمكن تمرير `repo_id` (أو `name`) للقالب إلى `hf repos create --template ...` لإنشاء مساحة جديدة من ذلك القالب.

**الاستخدام**:

```console
$ hf spaces templates [OPTIONS]
```

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces templates

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces variables`

إدارة متغيرات البيئة لمساحة على Hub.

**الاستخدام**:

```console
$ hf spaces variables [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `add`: إضافة متغيرات بيئة أو تحديثها لمساحة.
* `delete`: إزالة متغير بيئة من مساحة.
* `list`: قائمة متغيرات البيئة لمساحة. [مستعار: ls]

#### `hf spaces variables add`

إضافة متغيرات بيئة أو تحديثها لمساحة.

**الاستخدام**:

```console
$ hf spaces variables add [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `-e, --env TEXT`: تعيين متغيرات البيئة. على سبيل المثال --env ENV=value
* `--env-file TEXT`: قراءة ملف متغيرات البيئة. استخدم `-` لقراءتها من stdin.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces variables add username/my-space -e DEBUG=1 $ hf spaces variables add username/my-space -e MODEL_ID=gpt2 -e MAX_TOKENS=512 $ hf spaces variables add username/my-space --env-file .env

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces variables delete`

إزالة متغير بيئة من مساحة.

**الاستخدام**:

```console
$ hf spaces variables delete [OPTIONS] SPACE_ID KEY
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]
* `KEY`: اسم المتغيّر الذي يجب إزالته. [إلزامي]

**الخيارات**:

* `-y, --yes`: الإجابة بنعم تلقائيًا على الاستعلام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces variables delete username/my-space DEBUG $ hf spaces variables delete username/my-space DEBUG --yes

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces variables list`

ls

**الاستخدام**:

```console
$ hf spaces variables list [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces variables ls username/my-space

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces volumes`

إدارة أحجام التخزين لمساحة على Hub.

**الاستخدام**:

```console
$ hf spaces volumes [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `delete`: إزالة جميع الأحجام من مساحة.
* `list`: قائمة الأحجام (Volumes) المرفقة في مساحة (Space). [مستعار: ls]
* `set`: تعيين (استبدال) أحجام مساحة.

#### `hf spaces volumes delete`

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

**الاستخدام**:

```console
$ hf spaces volumes delete [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `-y, --yes`: الإجابة بنعم تلقائيًا على الاستعلام.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces volumes delete username/my-space $ hf spaces volumes delete username/my-space --yes

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces volumes list`

قائمة الأحجام (volumes) المثبتة في مساحة (Space). [alias: ls]

**الاستخدام**:

```console
$ hf spaces volumes list [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces volumes ls username/my-space

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

#### `hf spaces volumes set`

Set (استبدال) أحجام مساحة.

**الاستخدام**:

```console
$ hf spaces volumes set [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `-v, --volume TEXT`: تركيب حجم واحد أو أكثر. التنسيق: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. يكون TYPE أحد ما يلي: models, datasets, spaces, buckets. إذا تم حذف TYPE، فإن القيمة الافتراضية هي models. يتم تركيب models وdatasets وspaces للقراءة فقط دائمًا. يتم تركيب buckets للقراءة والكتابة افتراضيًا. على سبيل المثال: -v hf://org/m:/data أو -v hf://datasets/org/ds:/data أو -v hf://buckets/org/b:/mnt:ro
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces volumes set username/my-space -v hf://models/username/my-model:/models $ hf spaces volumes set username/my-space -v hf://buckets/username/my-bucket:/data -v hf://datasets/username/my-dataset:/datasets:ro

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces wait`

انتظر حتى ينتهي بناء/تشغيل مساحة.

يتوقف التنفيذ حتى يغادر المساحة مرحلة وسيطة (مثل BUILDING أو APP_STARTING) ويصل إلى مرحلة مستقرة. ينتهي التنفيذ برمز 0 إذا كانت المساحة في حالة RUNNING، أو برمز خروج غير صفري في الحالات الأخرى (مثل BUILD_ERROR أو RUNTIME_ERROR).

**الاستخدام**:

```console
$ hf spaces wait [OPTIONS] SPACE_ID
```

**الحجج**:

* `SPACE_ID`: معرّف المساحة (مثل `username/repo-name`). [إلزامي]

**الخيارات**:

* `--timeout TEXT`: الحد الأقصى للوقت الذي يجب انتظاره: عدد صحيح مع s (ثوانٍ، الافتراضي)، m (دقائق)، h (ساعات) أو d (أيام).
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces wait username/my-space $ hf spaces wait username/my-space --timeout 5m

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf spaces zero-gpu`

إدارة استخدامك لـ ZeroGPU على Hub.

**الاستخدام**:

```console
$ hf spaces zero-gpu [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `quota`: يعرض حصة ZeroGPU الخاصة بك (وقت GPU المتبقي وتاريخ إعادة الضبط).

#### `hf spaces zero-gpu quota`

اعرض حصة ZeroGPU الخاصة بك (وقت المعالج الرسومي المتبقي وتاريخ إعادة الضبط).

القيم معبّرة بالثواني على وحدة معالجة الرسوميات. عند استخدام `--quiet`، تُطبع ثواني وحدة معالجة الرسوميات المتبقية فقط.

**الاستخدام**:

```console
$ hf spaces zero-gpu quota [OPTIONS]
```

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf spaces zero-gpu quota $ hf spaces zero-gpu quota --format json

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf sync`

مزامنة الملفات بين المجلد المحلي ودلو التخزين.

**الاستخدام**:

```console
$ hf sync [OPTIONS] [SOURCE] [DEST]
```

**الحجج**:

* `[SOURCE]`: مسار المصدر: مجلد محلي أو hf://buckets/namespace/bucket_name(/prefix)
* `[DEST]`: مسار الوجهة: مجلد محلي أو hf://buckets/namespace/bucket_name(/prefix)

**الخيارات**:

* `--delete / --no-delete`: حذف الملفات الموجودة في الوجهة وغير الموجودة في المصدر. [الافتراضي: no-delete]
* `--ignore-times`: تخطي الملفات بناءً على الحجم فقط، مع تجاهل أوقات التعديل.
* `--ignore-sizes`: تخطي الملفات بناءً على أوقات التعديل فقط، مع تجاهل الأحجام.
* `--plan TEXT`: حفظ خطة المزامنة في ملف بصيغة JSONL للمراجعة بدلاً من التنفيذ.
* `--apply TEXT`: تطبيق ملف خطة محفوظ مسبقًا.
* `--dry-run`: طباعة خطة المزامنة إلى stdout بصيغة JSONL دون تنفيذها.
* `--include TEXT`: تضمين الملفات المطابقة للنمط (يمكن تحديد عدة أنماط).
* `--exclude TEXT`: استبعاد الملفات المطابقة للنمط (يمكن تحديد عدة أنماط).
* `--filter-from TEXT`: قراءة أنماط الإدراج/الاستبعاد من ملف.
* `--existing`: تخطي إنشاء ملفات جديدة على المستقبل (تحديث الملفات الموجودة فقط).
* `--ignore-existing`: تخطي تحديث الملفات الموجودة على المستقبل (إنشاء الملفات الجديدة فقط).
* `-v, --verbose`: عرض سجلات تفصيلية مع الاستدلال.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

## `hf update`

قم بتحديث واجهة سطر الأوامر `hf` إلى أحدث إصدار.

**الاستخدام**:

```console
$ hf update [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

## `hf upload`

ارفع ملفًا أو مجلدًا إلى Hub.

تُقسَّم المجلدات التي تحتوي على عدد كبير من الملفات إلى عدة التزامات. إذا انقطع رفع المجلد، أعد تشغيل الأمر نفسه لاستئناف العملية.

**الاستخدام**:

```console
$ hf upload [OPTIONS] REPO_ID [LOCAL_PATH] [PATH_IN_REPO]
```

**الحجج**:

* `REPO_ID`: معرف المستودع (مثلًا `username/repo-name` أو `spaces/username/repo-name`). [إلزامي]
* `[LOCAL_PATH]`: المسار المحلي للملف أو المجلد المرقي. تُدعم أنماط النجمة. القيمة الافتراضية هي المجلد الحالي.
* `[PATH_IN_REPO]`: مسار الملف أو المجلد في المستودع. القيمة الافتراضية هي المسار النسبي للملف أو المجلد.

**الخيارات**:

* `--type, --repo-type [model|dataset|space|kernel]`: نوع المستودع (نموذج، مجموعة بيانات، مساحة، أو نواة). [الافتراضي: (model)]
* `--revision TEXT`: معرف مراجعة Git يمكن أن يكون اسم فرع، أو وسم، أو تجزئة التزام.
* `--private / --no-private`: ما إذا كان يجب إنشاء مستودع خاص إذا لم يكن المستودع موجودًا على Hub. يتم تجاهل هذا الخيار إذا كان المستودع موجودًا بالفعل.
* `--include TEXT`: أنماط Glob لمطابقة الملفات المراد رفعها.
* `--exclude TEXT`: أنماط Glob لاستبعاد الملفات من قائمة الملفات المراد رفعها.
* `--delete TEXT`: أنماط Glob للملفات التي سيتم حذفها من المستودع أثناء الالتزام.
* `--commit-message TEXT`: ملخص / عنوان / السطر الأول للالتزام المولّد.
* `--commit-description TEXT`: وصف الالتزام المُولَّد.
* `--create-pr / --no-create-pr`: ما إذا كان سيتم رفع المحتوى كطلب سحب جديد. [الافتراضي: no-create-pr]
* `--every FLOAT`: إذا تم ضبطه، يُجدول عمل في الخلفية لإنشاء التزامات كل `every` دقيقة.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf upload my-cool-model . . $ hf upload Wauplin/my-cool-model ./models/model.safetensors $ hf upload Wauplin/my-cool-dataset ./data /train --repo-type=dataset $ hf upload Wauplin/my-cool-model ./models . --commit-message="Epoch 34/50" --commit-description="Val accuracy: 68%" $ hf upload bigcode/the-stack . . --repo-type dataset --create-pr

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

## `hf version`

اطبع معلومات حول إصدار hf.

**الاستخدام**:

```console
$ hf version [OPTIONS]
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

## `hf webhooks`

إدارة الخطافات البرمجية على Hub.

**الاستخدام**:

```console
$ hf webhooks [OPTIONS] COMMAND [ARGS]...
```

**الخيارات**:

* `--help`: عرض هذه الرسالة والخروج.

**الأوامر**:

* `create`: إنشاء خطاف ويب جديد.
* `delete`: حذف خطاف ويب بشكل دائم.
* `disable`: تعطيل خط ويب نشط.
* `enable`: تفعيل خطاف ويب معطّل.
* `info`: عرض التفاصيل الكاملة لخطاف ويب واحد.
* `list`: يعرض جميع الخطافات (webhooks) الخاصة بالمستخدم الحالي. [اختصار: ls]
* `update`: تحديث خطاف ويب (webhook) موجود.

### `hf webhooks create`

إنشاء webhook جديد.

قدّم إما --url (لإرسال نبضة إلى خادم بعيد) أو --job-id (لتشغيل مهمة)، لكن لا تقدّمهما معًا. لا تُنسخ أسرار المهمة المصدرية إلى خطاف الويب: مرّرها مرة أخرى باستخدام --secrets / --secrets-file.

**الاستخدام**:

```console
$ hf webhooks create [OPTIONS]
```

**الخيارات**:

* `--watch TEXT`: العنصر المراد مراقبته، بصيغة 'type:name' (مثل 'model:bert-base-uncased'). قابل للتكرار. [إلزامي]
* `--url TEXT`: عنوان URL لإرسال حمولات webhook إليه. يتعارض مع --job-id.
* `--job-id TEXT`: معرّف مهمة (Job) لإطلاقها (من job.id) بدلاً من إرسال إشارة إلى عنوان URL. يتعارض مع --url.
* `--domain [repo|discussion]`: المجال المراد مراقبته: 'repo' أو 'discussion'. يمكن تكراره. الافتراضي هو جميع المجالات.
* `--secret TEXT`: سر اختياري يُستخدم لتوقيع حمولات webhook.
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks create --url https://example.com/hook --watch model:bert-base-uncased $ hf webhooks create --url https://example.com/hook --watch org:HuggingFace --watch model:gpt2 --domain repo $ hf webhooks create --job-id 687f911eaea852de79c4a50a --watch user:julien-c $ hf webhooks create --job-id 687f911eaea852de79c4a50a --watch bucket:my-org/my-bucket --secrets HF_TOKEN

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks delete`

حذف خطاف ويب بشكل دائم.

**الاستخدام**:

```console
$ hf webhooks delete [OPTIONS] WEBHOOK_ID
```

**الحجج**:

* `WEBHOOK_ID`: المعرّف الخاص بالـ webhook المطلوب حذفه. [إلزامي]

**الخيارات**:

* `-y, --yes`: تجاوز مطالبة التأكيد.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks delete abc123 $ hf webhooks delete abc123 --yes

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks disable`

تعطيل خط ويب نشط.

**الاستخدام**:

```console
$ hf webhooks disable [OPTIONS] WEBHOOK_ID
```

**الحجج**:

* `WEBHOOK_ID`: المعرّف الخاص بالـ webhook الذي تريد تعطيله. [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks disable abc123

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks enable`

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

**الاستخدام**:

```console
$ hf webhooks enable [OPTIONS] WEBHOOK_ID
```

**الحجج**:

* `WEBHOOK_ID`: المعرّف الخاص بالـ webhook الذي تريد تفعيله. [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks enable abc123

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks info`

عرض جميع التفاصيل الخاصة بـ webhook واحد.

**الاستخدام**:

```console
$ hf webhooks info [OPTIONS] WEBHOOK_ID
```

**الحجج**:

* `WEBHOOK_ID`: المعرّف الخاص بالـ webhook. [إلزامي]

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks info abc123

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks list`

عرض جميع خطافات الويب للمستخدم الحالي. [alias: ls]

**الاستخدام**:

```console
$ hf webhooks list [OPTIONS]
```

**الخيارات**:

* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks ls $ hf webhooks ls --format json $ hf webhooks ls --format quiet

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli

### `hf webhooks update`

تحديث خط ويب (webhook) موجود. يتم تغيير الخيارات المُقدَّمة فقط.

تستبدل أسرار المهمة المُمرَّرة عبر --secrets القيم المخزَّنة التي تحمل الاسم نفسه، بينما تُحفظ القيم الأخرى.

**الاستخدام**:

```console
$ hf webhooks update [OPTIONS] WEBHOOK_ID
```

**الحجج**:

* `WEBHOOK_ID`: المعرّف الخاص بالـ webhook الذي تريد تحديثه. [إلزامي]

**الخيارات**:

* `--url TEXT`: عنوان URL جديد لإرسال حمولات webhook إليه.
* `--job-id TEXT`: معرف مهمة المصدر التي سيتم تشغيلها (يمكن أن تكون المهمة الحالية). مطلوب عند استخدام --secrets / --secrets-file.
* `--watch TEXT`: قائمة جديدة للعناصر المراد مراقبتها، بصيغة 'type:name'. يمكن تكرارها. تحل محل قائمة المراقبة الحالية بالكامل.
* `--domain [repo|discussion]`: قائمة جديدة للمجالات المراد مراقبتها: 'repo' أو 'discussion'. يمكن تكرارها.
* `--secret TEXT`: سر جديد يُستخدم لتوقيع حمولات webhook.
* `-s, --secrets TEXT`: تعيين متغيرات البيئة السرية. يُفضَّل استخدام `--secrets SECRET` لقراءة القيمة من بيئة النظام (مثل `--secrets HF_TOKEN` لتسليم رمز Hugging Face الخاص بك)؛ بينما يضع `--secrets SECRET=value` القيمة في سجلّ shell الخاص بك.
* `--secrets-file TEXT`: قراءة ملف متغيرات البيئة السرية. استخدم `-` لقراءتها من stdin.
* `--token TEXT`: رمز وصول للمستخدم (User Access Token) تم إنشاؤه من https://huggingface.co/settings/tokens.
* `--help`: عرض هذه الرسالة والخروج.

أمثلة $ hf webhooks update abc123 --url https://new-url.com/hook $ hf webhooks update abc123 --watch model:gpt2 --domain repo $ hf webhooks update abc123 --secret newsecret $ hf webhooks update abc123 --job-id 687f911eaea852de79c4a50a --secrets HF_TOKEN

للمزيد من المعلومات استخدم `hf <command> --help` للحصول على مزيد من التفاصيل حول أمر معين. اقرأ التوثيق على https://huggingface.co/docs/huggingface_hub/en/guides/cli