Hub Python Library documentation
إدارة وقت تشغيل مساحة
إدارة وقت تشغيل مساحة
راجع صفحة توثيق HfApi للاطلاع على مرجع الطرق لإدارة مساحتك على Hub.
- جلب وقت التشغيل الحالي: get_space_runtime()
- جلب سجلات البناء أو التشغيل: fetch_space_logs()
- إدارة الأسرار: add_space_secret() و delete_space_secret()
- إدارة العتاد: request_space_hardware()
- إدارة الحالة: pause_space()، restart_space()، set_space_sleep_time()
- انتظر حتى يصبح Space جاهزًا: wait_for_space()
- تحقق من حصة ZeroGPU الخاصة بك: get_zero_gpu_quota()
هياكل البيانات
SpaceRuntime
فئة huggingface_hub.SpaceRuntime
< source >( data: dict )
المعاملات
- stage (
str) — المرحلة الحالية للمساحة. مثال: RUNNING. - hardware (
strأوNone) — المعدات الحالية للمساحة. مثال: “cpu-basic”. يمكن أن تكونNoneإذا كانت المساحة في حالةBUILDINGلأول مرة. - requested_hardware (
strأوNone) — العتاد المطلوب. قد يختلف عنhardwareخاصةً إذا كان الطلب قد تم تقديمه للتو. مثال: “t4-medium”. يمكن أن يكونNoneإذا لم يتم طلب أي عتاد بعد. - sleep_time (
intorNone) — عدد الثواني التي سيبقى فيها المساحة نشطة بعد آخر طلب. افتراضيًا (إذا كانت القيمةNone)، لن تدخل المساحة في وضع السLEEP أبدًا إذا كانت تعمل على عتاد مُحدَّث، بينما ستدخل في وضع السLEEP بعد 48 ساعة على عتاد 'cpu-basic' المجاني. لمزيد من التفاصيل، راجع https://huggingface.co/docs/hub/spaces-gpus#sleep-time. - volumes (
list[Volume]أوNone) — قائمة بالأحجام (volumes) المرفقة في المساحة (Space). كل حجم هو كائن Volume يصف نوعه ومصدره ومسار التركيب والإعدادات الاختيارية.Noneإذا لم تكن هناك أحجام مرفقة. - raw (
dict) — الاستجابة الخام من الخادم. تحتوي على مزيد من المعلومات حول بيئة تشغيل Space مثل عدد النسخ، وعدد وحدات المعالجة المركزية، وحجم الذاكرة،...
تحتوي على معلومات حول وقت التشغيل الحالي لمساحة.
SpaceHardware
فئة huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
قائمة بالأجهزة المتاحة لتشغيل مساحتك على Hub.
مأخوذة من https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (رابط خاص).
SpaceStage
فئة huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
قائمة بالمراحل الممكنة لمساحة على Hub.
مأخوذة من https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (رابط خاص).
SpaceStorage
فئة huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
قائمة بتخزين البيانات الدائم المتاح لمساحتك على Hub.
مأخوذة من https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (رابط خاص).
SpaceVariable
تحتوي على معلومات حول المتغيرات الحالية لمساحة.
SpaceTemplate
فئة huggingface_hub.SpaceTemplate
< source >( data: dict )
المعاملات
- name (
str) — اسم قابل للقراءة البشرية للقالب (مثل"JupyterLab"،"chatbot"). - repo_id (
str) — معرّف المستودع الخاص بمساحة القالب (مثل"SpacesExamples/jupyterlab"). - sdk (
str) — SDK الذي بُني به القالب (مثل"gradio"،"docker"،"static"). - preferred_private (
bool) — ما إذا كان يُوصى بأن تكون المساحات (Spaces) المُنشأة من هذا القالب خاصة.
تحتوي على معلومات حول قالب مساحة متاح على Hub.
تُعاد بواسطة HfApi.list_space_templates(). يمكن تمرير repo_id كـ space_template إلى HfApi.create_repo() لإنشاء مساحة جديدة من ذلك القالب.
ZeroGpuQuota
فئة huggingface_hub.ZeroGpuQuota
< source >( data: dict )
المعاملات
- base (
float) — الحصة الإجمالية، بالثواني على وحدة معالجة الرسوميات. - remaining (
float) — الحصة المتبقية، بالثواني على وحدة معالجة الرسومات. - resets_at (
datetimeأوNone) — التاريخ الذي ستُعاد فيه الضبط الحصة.Noneإذا لم تُستخدم الحصة بعد. - overquota_used (
floatأوNone) — ثوانٍ GPU المدفوعة (المستخدمة فوق الحد) المستهلكة بعد استنفاد الحد الأساسي. يمكن للمستخدمين من فئات PRO وTeam وEnterprise شراء أرصدة للتجاوز فوق الحد الأساسي عبر https://huggingface.co/settings/billing?add-credits=true.
تحتوي على معلومات حول حصة ZeroGPU للمستخدم الموثّق.
يُستهلك حصة ZeroGPU في كل مرة تستخدم فيها مساحة ZeroGPU (سواءً من واجهة المستخدم أو عبر واجهة برمجية التطبيقات الخاصة بها) وتُعاد ضبطها بشكل دوري. راجع https://huggingface.co/docs/hub/spaces-zerogpu لمزيد من التفاصيل.
تُعاد بواسطة HfApi.get_zero_gpu_quota().