Hub Python Library documentation
Gestionar el tiempo de ejecución de tu Space
Gestionar el tiempo de ejecución de tu Space
Consulte la página de documentación de HfApi para obtener la referencia de los métodos para gestionar su Space en el Hub.
- Obtener el tiempo de ejecución actual: get_space_runtime()
- Obtener registros de compilación o ejecución: fetch_space_logs()
- Gestionar secretos: add_space_secret() y delete_space_secret()
- Gestionar el hardware: request_space_hardware()
- Gestionar el estado: pause_space(), restart_space(), set_space_sleep_time()
- Espera a que Space esté listo: wait_for_space()
- Comprueba tu cuota de ZeroGPU: get_zero_gpu_quota()
Estructuras de datos
SpaceRuntime
clase huggingface_hub.SpaceRuntime
< source >( data: dict )
Parámetros
- stage (
str) — Etapa actual del espacio. Ejemplo: RUNNING. - hardware (
stroNone) — Hardware actual del espacio. Ejemplo: “cpu-basic”. Puede serNonesi el Space está enBUILDINGpor primera vez. - requested_hardware (
stroNone) — Hardware solicitado. Puede ser diferente dehardware, especialmente si la solicitud acaba de realizarse. Ejemplo: “t4-medium”. Puede serNonesi aún no se ha solicitado hardware. - sleep_time (
intorNone) — Número de segundos que el Space se mantendrá activo después de la última solicitud. De forma predeterminada (si el valor esNone), el Space nunca entrará en modo de suspensión si se ejecuta en un hardware actualizado, mientras que entrará en modo de suspensión después de 48 horas en un hardware gratuito ‘cpu-basic’. Para más detalles, consulte https://huggingface.co/docs/hub/spaces-gpus#sleep-time. - volumes (
list[Volume]oNone) — Lista de volúmenes montados en el Space. Cada volumen es un objeto Volume que describe su tipo, origen, ruta de montaje y ajustes opcionales.Nonesi no hay volúmenes adjuntos. - raw (
dict) — Respuesta cruda del servidor. Contiene más información sobre el tiempo de ejecución del Space, como el número de réplicas, el número de cpu, el tamaño de memoria,…
Contiene información sobre el tiempo de ejecución actual de un Space.
SpaceHardware
clase huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumeración de los hardware disponibles para ejecutar tu Space en el Hub.
Tomado de https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (url privada).
SpaceStage
clase huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumeración de las posibles etapas de un Space en el Hub.
Tomado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (url privada).
SpaceStorage
clase huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumeración del almacenamiento persistente disponible para tu Space en el Hub.
Tomado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (url privada).
SpaceVariable
clase huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Parámetros
- key (
str) — Clave de la variable. Ejemplo:"MODEL_REPO_ID" - value (
str) — Valor de la variable. Ejemplo:"the_model_repo_id". - description (
stro None) — Descripción de la variable. Ejemplo:"Model Repo ID of the implemented model". - updatedAt (
datetimeo None) — fecha y hora de la última actualización de la variable (si la variable se ha actualizado al menos una vez).
Contiene información sobre las variables actuales de un Space.
SpaceTemplate
clase huggingface_hub.SpaceTemplate
< source >( data: dict )
Parámetros
- name (
str) — Nombre legible para humanos de la plantilla (p. ej.,"JupyterLab","chatbot"). - repo_id (
str) — Id del repositorio del Space de plantilla (p. ej."SpacesExamples/jupyterlab"). - sdk (
str) — SDK con el que se construye la plantilla (p. ej."gradio","docker","static"). - preferred_private (
bool) — Si se recomienda que los Spaces creados a partir de esta plantilla sean privados.
Contiene información sobre una plantilla de Space disponible en el Hub.
Devuelto por HfApi.list_space_templates(). El repo_id se puede pasar como space_template a HfApi.create_repo() para crear un nuevo Space a partir de esa plantilla.
ZeroGpuQuota
clase huggingface_hub.ZeroGpuQuota
< source >( data: dict )
Parámetros
- base (
float) — Cuota total, en segundos de GPU. - remaining (
float) — Cuota restante, en segundos de GPU. - resets_at (
datetimeoNone) — Fecha en la que se restablecerá la cuota.Nonesi la cuota aún no se ha utilizado. - overquota_used (
floatoNone) — Segundos de GPU de sobre cuota (de pago) consumidos una vez agotada la cuota base. Los usuarios de PRO, Team y Enterprise pueden comprar créditos para superar la cuota base en https://huggingface.co/settings/billing?add-credits=true.
Contiene información sobre la cuota de ZeroGPU del usuario autenticado.
La cuota de ZeroGPU se consume cada vez que utilizas un Space de ZeroGPU (desde la interfaz de usuario o a través de su API) y se restablece periódicamente. Consulta https://huggingface.co/docs/hub/spaces-zerogpu para más detalles.
Devuelto por HfApi.get_zero_gpu_quota().