Hub Python Library documentation

Hub Python Library

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

hf

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

الاستخدام:

$ 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

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf auth list

الاستخدام:

$ 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.

الاستخدام:

$ 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 auth logout

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

الاستخدام:

$ hf auth logout [OPTIONS]

الخيارات:

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

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

hf auth switch

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

الاستخدام:

$ 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 auth token

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

الاستخدام:

$ hf auth token [OPTIONS]

الخيارات:

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

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

hf auth whoami

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

الاستخدام:

$ hf auth whoami [OPTIONS]

الخيارات:

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

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

hf buckets

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

الاستخدام:

$ 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).

الاستخدام:

$ 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 buckets create

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

الاستخدام:

$ 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 buckets delete

حذف دلو.

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

الاستخدام:

$ 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 buckets info

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

الاستخدام:

$ 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 buckets list

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

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

الاستخدام:

$ 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 buckets move

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

الاستخدام:

$ 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 buckets remove

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

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

الاستخدام:

$ 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

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

الاستخدام:

$ 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 buckets sync

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

الاستخدام:

$ 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 cache

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf cache list

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

الاستخدام:

$ 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’ افتراضيًا ‘desc’ (الأحدث/الأكبر أولًا)؛ و‘name’ افتراضيًا ‘asc’ (أبجدي).
--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 cache prune

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

الاستخدام:

$ 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 cache rm

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

الاستخدام:

$ 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 <revision_hash> $ hf cache rm model/gpt2 —dry-run $ hf cache rm model/gpt2 —yes

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

الاستخدام:

$ 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 collections

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

الاستخدام:

$ 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

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

الاستخدام:

$ 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 collections create

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

الاستخدام:

$ 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 collections delete

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

الاستخدام:

$ 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 collections delete-item

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

الاستخدام:

$ 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.

الاستخدام:

$ 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 collections list

List collections on the Hub. [alias: ls]

الاستخدام:

$ 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 collections update

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

الاستخدام:

$ 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 collections update-item

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

الاستخدام:

$ 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 cp

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

الاستخدام:

$ 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 datasets

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

الاستخدام:

$ 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

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

الاستخدام:

$ 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 datasets info

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

الاستخدام:

$ 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 datasets leaderboard

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

الاستخدام:

$ 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 datasets list

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

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

الاستخدام:

$ 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 datasets parquet

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

الاستخدام:

$ 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 datasets sql

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

الاستخدام:

$ 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 discussions

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf discussions close

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

الاستخدام:

$ 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 discussions comment

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

الاستخدام:

$ hf discussions comment [OPTIONS] REPO_ID NUM

الحجج:

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

الخيارات:

--body TEXT: نص التعليق (يدعم Markdown).
--body-file PATH: قراءة التعليق من ملف. استخدم ’-’ لمدخل المعيار (stdin).
--attach TEXT: إرفاق صورة أو فيديو أو ملف صوتي، بصيغة ‘FILE’ أو ‘FILE#alt text’. يُستبدل مرجع ‘’ في النص بالملف المرفوع، بينما تُضاف الملفات الأخرى. يمكن استخدام هذا الخيار عدة مرات.
--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 discussions create

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

الاستخدام:

$ hf discussions create [OPTIONS] REPO_ID

الحجج:

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

الخيارات:

--title TEXT: عنوان المناقشة أو طلب الدمج. [إلزامي]
--body TEXT: الوصف (يدعم Markdown).
--body-file PATH: قراءة الوصف من ملف. استخدم ’-’ لمدخل المعيار (stdin).
--pull-request, --pr: إنشاء طلب سحب بدلاً من نقاش.
--attach TEXT: إرفاق صورة أو فيديو أو ملف صوتي، بصيغة ‘FILE’ أو ‘FILE#alt text’. يُستبدل مرجع ‘’ في النص بالملف المرفوع، بينما تُضاف الملفات الأخرى. يمكن استخدام هذا الخيار عدة مرات.
--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 discussions diff

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

الاستخدام:

$ 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 discussions edit

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

الاستخدام:

$ 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: قراءة التعليق الجديد من ملف. استخدم ’-’ لمدخل المعيار (stdin).
--attach TEXT: إرفاق صورة أو فيديو أو ملف صوتي، بصيغة ‘FILE’ أو ‘FILE#alt text’. يُستبدل مرجع ‘’ في النص بالملف المرفوع، بينما تُضاف الملفات الأخرى. يمكن استخدام هذا الخيار عدة مرات.
--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 ” —attach ./after.png

hf discussions info

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

الاستخدام:

$ 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 discussions list

الاستخدام:

$ 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 discussions merge

دمج طلب سحب.

الاستخدام:

$ 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 discussions rename

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

الاستخدام:

$ 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

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

الاستخدام:

$ 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 download

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

الاستخدام:

$ 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 endpoints

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

الاستخدام:

$ 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

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf endpoints catalog deploy

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

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

الاستخدام:

$ 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 endpoints catalog list

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

الاستخدام:

$ 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 endpoints delete

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

الاستخدام:

$ 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 endpoints deploy

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

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

الاستخدام:

$ 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: عنوان URL لصورة 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 endpoints describe

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

الاستخدام:

$ 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 endpoints hardware

list_hardware

يُعرض هنا فقط العتاد الذي يمكن للمساحة الاسم (namespace) نشره عليه في الوقت الحالي: حالة قابلة للاستخدام، ومقدار كافٍ من حصة المعالج التسريعي (accelerator quota) لتكرار واحد. استخدم --all لعرض كل التوليفات التي تُرجعها واجهة برمجة التطبيقات (API).

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

الاستخدام:

$ 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 endpoints list

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

الاستخدام:

$ 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 endpoints list-catalog

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

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

الاستخدام:

$ 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

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

الاستخدام:

$ 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 endpoints resume

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

الاستخدام:

$ 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 endpoints scale-to-zero

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

الاستخدام:

$ 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 endpoints update

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

الاستخدام:

$ 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: نوع مثيل السحابة الذي سيتم نشر نقطة الاستدلال عليه (مثل ‘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: تجاوز نقطة الدخول الأصلية للحاوية، كسلسلة محاطة بعلامات اقتباس تُقسَّم إلى رموز (مثل “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 env

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

الاستخدام:

$ hf env [OPTIONS]

الخيارات:

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

hf extensions

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

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf extensions exec

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

الاستخدام:

$ hf extensions exec [OPTIONS] NAME

الحجج:

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

الخيارات:

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

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

hf extensions install

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

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

الاستخدام:

$ 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 extensions list

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

الاستخدام:

$ hf extensions list [OPTIONS]

الخيارات:

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

أمثلة $ hf extensions list

hf extensions remove

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

الاستخدام:

$ hf extensions remove [OPTIONS] NAME

الحجج:

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

الخيارات:

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

أمثلة $ hf extensions remove claude

hf extensions search

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

الاستخدام:

$ hf extensions search [OPTIONS]

الخيارات:

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

أمثلة $ hf extensions search

hf extensions update

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

الاستخدام:

$ 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 jobs

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

الاستخدام:

$ 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

إلغاء مهمة

الاستخدام:

$ 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 <job_id>

hf jobs expose

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

الاستخدام:

$ 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 <job_id> 8000 $ hf jobs expose <job_id> 8000 —public 9000 $ hf jobs expose <job_id> —clear

hf jobs hardware

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

الاستخدام:

$ hf jobs hardware [OPTIONS]

الخيارات:

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

أمثلة $ hf jobs hardware

hf jobs inspect

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

الاستخدام:

$ 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 <job_id>

hf jobs labels

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

الاستخدام:

$ 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 <job_id> —name training-v2 $ hf jobs labels <job_id> —label env=prod —label team=ml $ hf jobs labels <job_id> —clear

hf jobs list | ls | ps

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

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

الاستخدام:

$ 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 jobs logs

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

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

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

الاستخدام:

$ 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 <job_id> $ hf jobs logs -f <job_id> $ hf jobs logs —tail 20 <job_id> $ hf jobs logs -f —tail 100 <job_id>

hf jobs rerun

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

الاستخدام:

$ 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 <job_id> $ hf jobs rerun —detach <job_id>

hf jobs run

تشغيل مهمة.

الاستخدام:

$ 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 jobs scheduled

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

الاستخدام:

$ 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

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

الاستخدام:

$ 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 <id>

hf jobs scheduled inspect

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

الاستخدام:

$ 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 <id>

hf jobs scheduled labels

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

الاستخدام:

$ 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 <id> —name daily-script $ hf jobs scheduled labels <id> —label env=prod —label team=ml $ hf jobs scheduled labels <id> —clear

hf jobs scheduled list | ls | ps

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

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

الاستخدام:

$ 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 jobs scheduled إعادة الجدولة

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

الاستخدام:

$ 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 <id> “0 9 * * 1”

hf jobs scheduled resume

استئناف (إلغاء إيقاف مؤقت) مهمة مجدولة.

الاستخدام:

$ 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 <id>

hf jobs scheduled run

جدولة مهمة.

الاستخدام:

$ 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 jobs scheduled suspend

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

الاستخدام:

$ 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 <id>

hf jobs scheduled trigger

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

الاستخدام:

$ 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 <id>

hf jobs scheduled uv

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf jobs scheduled uv run

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

الاستخدام:

$ 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 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.

If the Job is not yet running, waits until it reaches the RUNNING state before connecting. Requires the Job to be started with SSH enabled (hf jobs run --ssh ...) and your SSH public key to be registered at https://huggingface.co/settings/keys.

الاستخدام:

$ 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 <job_id> $ hf jobs ssh <job_id> —dry-run $ hf jobs ssh <job_id> -i ~/.ssh/id_ed25519

إحصاءات وظائف hf

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

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

الاستخدام:

$ 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 <job_id> $ hf jobs stats -f <job_id>

hf jobs uv

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

hf jobs uv run

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

الاستخدام:

$ 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 jobs wait

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

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

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

الاستخدام:

$ 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 <job_id> $ hf jobs wait <job_id_1> <job_id_2> $ hf jobs ls -q | xargs hf jobs wait

hf lfs-enable-largefiles

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

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

الاستخدام:

$ hf lfs-enable-largefiles [OPTIONS] PATH

الحجج:

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

الخيارات:

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

hf lfs-multipart-upload

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

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

الاستخدام:

$ hf lfs-multipart-upload [OPTIONS]

الخيارات:

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

hf models

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

الاستخدام:

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

الخيارات:

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

الأوامر:

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

بطاقة نموذج hf

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

الاستخدام:

$ 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 models info

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

الاستخدام:

$ 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 models list

عرض النماذج على Hub أو الملفات في مستودع نموذج. [alias: ls]

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

الاستخدام:

$ 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 papers

تفاعل مع الأوراق البحثية على المنصة.

الاستخدام:

$ hf papers [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

info: احصل على معلومات حول ورقة بحثية على المنصة.
list: يعرض قائمة الأوراق اليومية على Hub. [مستعار: ls]
read: قراءة ورقة بحثية بصيغة Markdown.
search: البحث عن الأوراق البحثية على المنصة.

hf papers info

احصل على معلومات حول ورقة بحثية على المنصة.

الاستخدام:

$ 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 papers list

عرض الأوراق اليومية على Hub. [alias: ls]

الاستخدام:

$ 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 papers read

اقرأ ورقة بحثية بصيغة Markdown.

الاستخدام:

$ 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 papers search

ابحث عن الأوراق البحثية على Hub.

الاستخدام:

$ 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 repos

إدارة المستودعات على Hub.

الاستخدام:

$ 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.

الاستخدام:

$ hf repos branch [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

create: إنشاء فرع جديد لمستودع على Hub.
delete: حذف فرع من مستودع على Hub.

hf repos branch create

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

الاستخدام:

$ 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 repos branch delete

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

الاستخدام:

$ 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 repos cp

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

الاستخدام:

$ 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 repos create

أنشئ مستودعًا جديدًا على Hub.

الاستخدام:

$ 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 repos delete

حذف مستودع من Hub. هذه عملية لا يمكن التراجع عنها.

الاستخدام:

$ 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 repos delete-files

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

الاستخدام:

$ 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 repos duplicate

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

الاستخدام:

$ 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 repos list

List all repos (models, datasets, spaces, buckets) with storage info. [alias: ls]

الاستخدام:

$ 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 repos move

نقل مستودع من مساحة أسماء إلى مساحة أسماء أخرى.

الاستخدام:

$ 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 repos settings

تحديث إعدادات المستودع.

الاستخدام:

$ 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 repos tag

إدارة الوسوم الخاصة بمستودع على Hub.

الاستخدام:

$ hf repos tag [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

create: إنشاء وسم لمستودع.
delete: حذف وسم من مستودع.
list: قائمة وسوم مستودع. [مستعار: ls]

hf repos tag create

أنشئ وسمًا لخزينة.

الاستخدام:

$ 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 repos tag delete

حذف وسم من مستودع.

الاستخدام:

$ 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 repos tag list

قائمة وسوم مستودع. [alias: ls]

الاستخدام:

$ 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 sandbox

شغّل وأدر بيئات تجريبية على Hugging Face Jobs.

الاستخدام:

$ hf sandbox [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

cp: نسخ ملف بين الجهاز المحلي وعملية العزل (على غرار docker).
create: إنشاء بيئة معزولة: جهاز افتراضي مخصص افتراضيًا، أو جهاز مشترك منخفض التكلفة باستخدام --pool.
exec: تشغيل أمر في بيئة معزولة، مع بث المخرجات.
kill: إنهاء بيئة العزل، أو مضيف مشترك بالكامل، أو كل شيء (—all).
pool: مسابح مضيفين افتراضيين جاهزة، وتوليد بيئات معزولة تجريبية مشتركة للأحمال العاملة ضمن نفس حدود الثقة.
process: قائمة العمليات الخلفية الجارية في بيئة العزل وإيقافها.
spawn: بدء أمر طويل الأمد في الخلفية وإرجاع معرّف العملية الخاص به (دون انتظار).

hf sandbox cp

نسخ ملف بين الجهاز المحلي وعزل (على غرار docker).

الاستخدام:

$ hf sandbox cp [OPTIONS] SRC DST

الحجج:

SRC: المصدر: مسار محلي أو <sandbox_id>:<path>. [إلزامي]
DST: الوجهة: مسار محلي أو <sandbox_id>:<path>. [إلزامي]

الخيارات:

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

أمثلة $ hf sandbox cp data.csv <sandbox_id>:/data/data.csv $ hf sandbox cp <sandbox_id>:/app/result.json result.json

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.

الاستخدام:

$ 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 sandbox exec

نفّذ أمرًا في بيئة معزولة، مع بث المخرجات. ينتهي برمز الخروج الخاص بالأمر.

لبدء أمر يستغرق وقتًا طويلاً في الخلفية بدلاً من الانتظار حتى اكتماله، استخدم hf sandbox spawn.

الاستخدام:

$ 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 <sandbox_id> — python -c “print(42)” $ hf sandbox exec -w /app <sandbox_id> — pytest -x

hf sandbox kill

إنهاء بيئة اختبار، أو مضيف مشترك بالكامل، أو كل شيء (—all).

الاستخدام:

$ 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 <sandbox_id> $ hf sandbox kill <host_id> # kills a whole shared host (all its sandboxes) $ hf sandbox kill —all

hf sandbox pool

أنشئ مجمّعات لأجهزة الاستضافة الدافئة وأطلق صناديق رملية مشتركة تجريبية لأحمال العمل ضمن حدود الثقة نفسها.

الاستخدام:

$ hf sandbox pool [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

create: تجهيز مجموعة: تشغيل مضيف افتراضي واحد الآن، مع وضع علامة عليه بحيث يمكن العثور عليه لاحقًا عبر معرّف المجموعة الخاص به.
delete: إنهاء جميع مضيفات VM الخاصة بحوض (وبالتالي جميع بيئاته العازلة). [اسم مستعار: rm]
ls: يعرض مجموعات الرمال قيد التشغيل (مجمّعة من وحداتها الافتراضية المضيفة). [اسم مستعار: list]

hf sandbox pool create

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

الاستخدام:

$ 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 sandbox pool delete

إنهاء كل آلة افتراضية مضيف في مجموعة (وبالتالي جميع بيئاتها المعزولة). [اسم مستعار: rm]

الاستخدام:

$ 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 <pool_id>

hf sandbox pool ls

عرض أحواض العزل قيد التشغيل (مجمّعة من وحداتها الافتراضية المضيفة). [alias: list]

الاستخدام:

$ hf sandbox pool ls [OPTIONS]

الخيارات:

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

أمثلة $ hf sandbox pool ls

hf sandbox process

قائمة العمليات الخلفية الجارية في بيئة العزل وإيقافها.

الاستخدام:

$ hf sandbox process [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

kill: إيقاف عملية خلفية تعمل داخل بيئة معزولة.
ls: يعرض قائمةً بالعمليات الخلفية العاملة داخل بيئة العزل (التي تم إطلاقها عبر hf sandbox spawn). [اسم آخر: list]

hf sandbox process kill

إيقاف عملية خلفية تعمل في بيئة معزولة.

الاستخدام:

$ 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 <sandbox_id> <pid>

hf sandbox process ls

قائمة العمليات الخلفية التي تعمل داخل بيئة العزل (التي تم إطلاقها عبر hf sandbox spawn). [alias: list]

الاستخدام:

$ 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 <sandbox_id>

hf sandbox spawn

ابدأ أمرًا طويل المدة في الخلفية وأعد معرّف العملية الخاص به (pid) (لا تنتظر).

استعرض عمليات بيئة العزل باستخدام hf sandbox process ls وأوقف إحداها باستخدام hf sandbox process kill.

الاستخدام:

$ 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 <sandbox_id> — python -m http.server 8000 $ hf sandbox spawn -w /app <sandbox_id> — uvicorn app:app

hf skills

إدارة المهارات لمساعدات الذكاء الاصطناعي.

الاستخدام:

$ 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.

الاستخدام:

$ 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 skills list

قائمة المهارات المتاحة من سوق Hugging Face. [alias: ls]

الاستخدام:

$ hf skills list [OPTIONS]

الخيارات:

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

أمثلة $ hf skills list $ hf skills list —format json

معاينة مهارات hf

اطبع ملف hf-cli SKILL.md المولّد إلى stdout.

الاستخدام:

$ hf skills preview [OPTIONS]

الخيارات:

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

hf skills update

تحديث مهارات سوق Hugging Face المثبتة.

الاستخدام:

$ 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 spaces

التفاعل مع المساحات على Hub.

الاستخدام:

$ 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

احصل على بطاقة المساحة (README) لمساحة على Hub.

الاستخدام:

$ 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 spaces dev-mode

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

يسهّل وضع التطوير في Spaces عملية تصحيح أخطاء تطبيقك ويجعل تكرار العمل على Spaces أسرع من خلال السماح لك بإعادة تشغيل تطبيقك دون إيقاف حاوية Space نفسها. يتطلب تفعيل وضع التطوير خطة PRO أو Team & Enterprise. أما تعطيله (--stop) فهو مسموح به دائمًا.

راجع التوثيق: https://huggingface.co/docs/hub/spaces-dev-mode

الاستخدام:

$ 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 spaces

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

الاستخدام:

$ hf spaces hardware [OPTIONS]

الخيارات:

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

أمثلة $ hf spaces hardware

hf spaces hot-reload

إعادة تحميل أي ملف Python في مساحة دون الحاجة إلى إعادة بناء كاملة وإعادة تشغيل.

⚠ هذه الميزة تجريبية ⚠

يعمل فقط مع Gradio SDK (6.1+) يفتح محررًا تفاعليًا ما لم يتم تحديد —local-file/-f.

يعمل هذا الأمر على تعديل عملية بايثون النشطة باستخدام https://github.com/breuleux/jurigged (مقارنة فروق مبنية على AST، وتحديثات الدوال في مكانها، وما إلى ذلك)، مع تكامله مع دعم إعادة التحميل الفوري الأصلية في Gradio (أي أن التغييرات على كائن عرض Gradio تنعكس في واجهة المستخدم)

ينشئ الأمر التزامًا عن بُعد. إذا كنت تعمل من نسخة محلية، فقم بتشغيل git pull --autostash بعد ذلك لإرجاع الالتزام والحفاظ على مزامنة حالة git المحلية لديك.

الاستخدام:

$ 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 spaces info

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

الاستخدام:

$ 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 spaces list

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

الاستخدام:

$ 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 spaces logs

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

يطبع سجلات التشغيل المتاحة حاليًا ويخرج افتراضيًا (غير حاسم، مثل docker logs). استخدم —follow/-f لبث السجلات حتى يغلق الخادم البث. استخدم —build لعرض سجلات بناء الحاوية بدلاً من ذلك (مفيد عندما يكون Space عالقًا في BUILD_ERROR).

الاستخدام:

$ 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 spaces pause

إيقاف مساحة مؤقتًا.

الاستخدام:

$ 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 spaces restart

إعادة تشغيل مساحة.

الاستخدام:

$ 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 spaces search

استخدم البحث الدلالي للبحث في مساحات البحث على Hub.

الاستخدام:

$ 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 spaces secrets

إدارة الأسرار الخاصة بمساحة على Hub.

الاستخدام:

$ hf spaces secrets [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

add: إضافة أو تحديث الأسرار الخاصة بمساحة.
delete: إزالة سر من مساحة.
list: قائمة الأسرار الخاصة بمساحة. [مستعار: ls]

hf spaces secrets add

إضافة أو تحديث الأسرار الخاصة بمساحة.

الاستخدام:

$ 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 spaces secrets delete

إزالة سر من مساحة.

الاستخدام:

$ 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 spaces secrets list

قائمة الأسرار الخاصة بمساحة. قيم الأسرار قابلة للكتابة فقط ولا تُعاد. [alias: ls]

الاستخدام:

$ 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

تحديث إعدادات مساحة.

الاستخدام:

$ 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 spaces ssh

ssh إلى حاوية وضع التطوير (Dev Mode) الخاصة بمساحة (Space).

يتطلب تشغيل وضع التطوير على المساحة وتسجيل مفتاح SSH العام الخاص بك في https://huggingface.co/settings/keys.

انظر إلى: https://huggingface.co/docs/hub/spaces-dev-mode

الاستخدام:

$ 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

قائمة قوالب المساحات المتاحة.

يمكن تمرير repo_id (أو name) للقالب إلى hf repos create --template ... لإنشاء مساحة جديدة من ذلك القالب.

الاستخدام:

$ hf spaces templates [OPTIONS]

الخيارات:

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

أمثلة $ hf spaces templates

متغيرات hf spaces

إدارة متغيرات البيئة لمساحة على Hub.

الاستخدام:

$ hf spaces variables [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

add: إضافة متغيرات بيئة أو تحديثها لمساحة.
delete: إزالة متغير بيئة من مساحة.
list: قائمة متغيرات البيئة لمساحة. [مستعار: ls]

hf spaces variables add

إضافة متغيرات بيئة أو تحديثها لمساحة.

الاستخدام:

$ 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 spaces variables delete

إزالة متغير بيئة من مساحة.

الاستخدام:

$ 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 spaces variables list

الاستخدام:

$ 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 spaces volumes

إدارة أحجام التخزين لمساحة على Hub.

الاستخدام:

$ hf spaces volumes [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

delete: إزالة جميع الأحجام من مساحة.
list: قائمة الأحجام (Volumes) المرفقة في مساحة (Space). [مستعار: ls]
set: تعيين (استبدال) أحجام مساحة.

hf spaces volumes delete

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

الاستخدام:

$ 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 spaces volumes list

قائمة الأحجام (volumes) المثبتة في مساحة (Space). [alias: ls]

الاستخدام:

$ 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 spaces volumes set

تعيين (استبدال) الأحجام لمساحة.

الاستخدام:

$ 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 spaces wait

انتظر حتى ينتهي بناء/تشغيل مساحة.

يتوقف التنفيذ حتى يغادر المساحة مرحلة وسيطة (مثل BUILDING أو APP_STARTING) ويصل إلى مرحلة مستقرة. ينتهي التنفيذ برمز 0 إذا كانت المساحة في حالة RUNNING، أو برمز إنهاء غير صفري في الحالات الأخرى (مثل BUILD_ERROR أو RUNTIME_ERROR).

الاستخدام:

$ 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 spaces zero-gpu

إدارة استخدامك لـ ZeroGPU على Hub.

الاستخدام:

$ hf spaces zero-gpu [OPTIONS] COMMAND [ARGS]...

الخيارات:

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

الأوامر:

quota: يعرض حصة ZeroGPU الخاصة بك (وقت GPU المتبقي وتاريخ إعادة الضبط).

hf spaces zero-gpu quota

اعرض حصة ZeroGPU الخاصة بك (وقت المعالج الرسومي المتبقي وتاريخ إعادة الضبط).

القيم معبّرة بالثواني على وحدة معالجة الرسوميات. عند استخدام --quiet، تُطبع ثواني وحدة معالجة الرسوميات المتبقية فقط.

الاستخدام:

$ 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 sync

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

الاستخدام:

$ 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 إلى أحدث إصدار.

الاستخدام:

$ hf update [OPTIONS]

الخيارات:

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

hf upload

ارفع ملفًا أو مجلدًا إلى Hub.

تُقسَّم المجلدات التي تحتوي على عدد كبير من الملفات إلى عدة التزامات. إذا انقطع رفع المجلد، أعد تشغيل الأمر نفسه لاستئناف العملية.

الاستخدام:

$ 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 version

اطبع معلومات حول إصدار hf.

الاستخدام:

$ hf version [OPTIONS]

الخيارات:

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

hf webhooks

إدارة الخطافات البرمجية على Hub.

الاستخدام:

$ 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.

الاستخدام:

$ 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 webhooks delete

حذف خطاف ويب بشكل دائم.

الاستخدام:

$ 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 webhooks disable

تعطيل خط ويب نشط.

الاستخدام:

$ 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 webhooks enable

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

الاستخدام:

$ 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 webhooks info

عرض جميع التفاصيل الخاصة بـ webhook واحد.

الاستخدام:

$ 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 webhooks list

عرض جميع خطافات الويب للمستخدم الحالي. [alias: ls]

الاستخدام:

$ 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 webhooks update

تحديث خط ويب (webhook) موجود. يتم تغيير الخيارات المُقدَّمة فقط.

تستبدل أسرار المهمة المُمرَّرة عبر —secrets القيم المخزّنة التي تحمل الاسم نفسه، بينما تُحفظ القيم الأخرى.

الاستخدام:

$ 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

Update on GitHub

←واجهة Hugging Face Hub API تنزيل الملفات→