Hub Python Library documentation
Gérer le runtime de votre Space
Gérer le runtime de votre Space
Consultez la page de documentation de HfApi pour la référence des méthodes permettant de gérer votre Space sur le Hub.
- Récupérer le runtime actuel : get_space_runtime()
- Récupérer les journaux de build ou d’exécution : fetch_space_logs()
- Gérer les secrets : add_space_secret() et delete_space_secret()
- Gérer le matériel : request_space_hardware()
- Gérer l'état : pause_space(), restart_space(), set_space_sleep_time()
- Attendez que Space soit prêt : wait_for_space()
- Vérifiez votre quota ZeroGPU : get_zero_gpu_quota()
Structures de données
SpaceRuntime
classe huggingface_hub.SpaceRuntime
< source >( data: dict )
Paramètres
- stage (
str) — Étape actuelle de l’espace. Exemple : RUNNING. - hardware (
strouNone) — Matériel actuel de l’espace. Exemple : “cpu-basic”. Peut êtreNonesi l’espace est en cours deBUILDINGpour la première fois. - requested_hardware (
strouNone) — Matériel demandé. Peut différer dehardware, notamment si la demande vient d’être effectuée. Exemple : « t4-medium ». Peut êtreNonesi aucun matériel n’a encore été demandé. - sleep_time (
intouNone) — Nombre de secondes pendant lesquelles le Space reste actif après la dernière requête. Par défaut (si la valeur estNone), le Space ne s’endormira jamais s’il fonctionne sur un matériel amélioré, tandis qu’il s’endormira après 48 heures sur un matériel gratuit « cpu-basic ». Pour plus de détails, voir https://huggingface.co/docs/hub/spaces-gpus#sleep-time. - volumes (
list[Volume]ouNone) — Liste des volumes montés dans le Space. Chaque volume est un objet Volume décrivant son type, sa source, son chemin de montage et ses paramètres optionnels.Nonesi aucun volume n'est attaché. - raw (
dict) — Réponse brute du serveur. Contient des informations supplémentaires sur le runtime de l’espace, comme le nombre de répliques, le nombre de CPU, la taille de la mémoire, etc.
Contient des informations sur l'exécution actuelle d'un Space.
SpaceHardware
classe huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Énumération des matériels disponibles pour exécuter votre Space sur le Hub.
La valeur peut être comparée à une chaîne de caractères :
assert SpaceHardware.CPU_BASIC == "cpu-basic"Extrait de https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (URL privée).
SpaceStage
classe huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Énumération des stades possibles d'un Space sur le Hub.
Extrait de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (URL privée).
SpaceStorage
classe huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Énumération du stockage persistant disponible pour votre Space sur le Hub.
Extrait de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (URL privée).
SpaceVariable
classe huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Paramètres
- key (
str) — Clé de la variable. Exemple :"MODEL_REPO_ID" - value (
str) — Valeur de la variable. Exemple :"the_model_repo_id". - description (
stror None) — Description de la variable. Exemple :"Model Repo ID of the implemented model". - updatedAt (
datetimeou None) — datetime de la dernière mise à jour de la variable (si la variable a été mise à jour au moins une fois).
Contient des informations sur les variables actuelles d'un Space.
SpaceTemplate
classe huggingface_hub.SpaceTemplate
< source >( data: dict )
Paramètres
- name (
str) — Nom lisible du modèle (par exemple"JupyterLab","chatbot"). - repo_id (
str) — Identifiant du dépôt de l'Espace modèle (par ex."SpacesExamples/jupyterlab"). - sdk (
str) — SDK avec lequel le modèle est construit (par ex."gradio","docker","static"). - preferred_private (
bool) — Indique si les Spaces créés à partir de ce modèle sont recommandés comme privés.
Contient des informations sur un modèle de Space disponible sur le Hub.
Retourné par HfApi.list_space_templates(). Le repo_id peut être passé en tant que space_template à HfApi.create_repo() pour initialiser un nouvel espace à partir de ce modèle.
ZeroGpuQuota
classe huggingface_hub.ZeroGpuQuota
< source >( data: dict )
Paramètres
- base (
float) — Quota total, en secondes-GPU. - remaining (
float) — Quota restant, en secondes-GPU. - resets_at (
datetimeouNone) — Date à laquelle le quota sera réinitialisé.Nonesi le quota n'a pas encore été utilisé. - overquota_used (
floatouNone) — Secondes-GPU facturées consommées une fois la quota de base épuisée. Les utilisateurs PRO, Team et Enterprise peuvent acheter des crédits pour dépasser la quota de base sur https://huggingface.co/settings/billing?add-credits=true.
Contient des informations sur le quota ZeroGPU de l'utilisateur authentifié.
Le quota ZeroGPU est consommé à chaque utilisation d'un Space ZeroGPU (depuis l'interface utilisateur ou via son API) et est réinitialisé périodiquement. Consultez https://huggingface.co/docs/hub/spaces-zerogpu pour plus de détails.
Retourné par HfApi.get_zero_gpu_quota().