Hub Python Library documentation
Gerenciando o runtime do seu Space
Gerenciando o runtime do seu Space
Consulte a página de documentação do HfApi para a referência dos métodos de gerenciamento do seu Space no Hub.
- Obter o runtime atual: get_space_runtime()
- Obter logs de build ou execução: fetch_space_logs()
- Gerenciar segredos: add_space_secret() e delete_space_secret()
- Gerenciar hardware: request_space_hardware()
- Gerenciar estado: pause_space(), restart_space(), set_space_sleep_time()
- Aguarde até que o Space esteja pronto: wait_for_space()
- Verifique sua cota de ZeroGPU: get_zero_gpu_quota()
Estruturas de dados
SpaceRuntime
classe huggingface_hub.SpaceRuntime
< source >( data: dict )
Parâmetros
- stage (
str) — Etapa atual do espaço. Exemplo: RUNNING. - hardware (
strouNone) — Hardware atual do espaço. Exemplo: “cpu-basic”. Pode serNonese o Espaço estiverBUILDINGpela primeira vez. - requested_hardware (
strouNone) — Hardware solicitado. Pode ser diferente dehardware, especialmente se a solicitação acabou de ser feita. Exemplo: “t4-medium”. Pode serNonese nenhum hardware ainda tiver sido solicitado. - sleep_time (
intorNone) — Número de segundos que o Space permanecerá ativo após a última solicitação. Por padrão (se o valor forNone), o Space nunca entrará em modo de suspensão se estiver executado em hardware atualizado, enquanto entrará em modo de suspensão após 48 horas em um hardware gratuito 'cpu-basic'. Para mais detalhes, consulte https://huggingface.co/docs/hub/spaces-gpus#sleep-time. - volumes (
list[Volume]ouNone) — Lista de volumes montados no Space. Cada volume é um objeto Volume que descreve seu tipo, origem, caminho de montagem e configurações opcionais.Nonese nenhum volume estiver anexado. - raw (
dict) — Resposta bruta do servidor. Contém mais informações sobre o runtime do Space, como número de réplicas, número de CPUs, tamanho da memória, …
Contém informações sobre o tempo de execução atual de um Space.
SpaceHardware
classe huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumeração dos hardwares disponíveis para executar seu Space no Hub.
Retirado de https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (URL privada).
SpaceStage
classe huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumeração dos possíveis estágios de um Space no Hub.
Retirado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (url privada).
SpaceStorage
classe huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Enumeração do armazenamento persistente disponível para seu Space no Hub.
Retirado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (url privada).
SpaceVariable
classe huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Parâmetros
- key (
str) — Chave da variável. Exemplo:"MODEL_REPO_ID" - value (
str) — Valor da variável. Exemplo:"the_model_repo_id". - description (
stror None) — Descrição da variável. Exemplo:"Model Repo ID of the implemented model". - updatedAt (
datetimeou None) — datetime da última atualização da variável (se a variável tiver sido atualizada pelo menos uma vez).
Contém informações sobre as variáveis atuais de um Space.
SpaceTemplate
classe huggingface_hub.SpaceTemplate
< source >( data: dict )
Parâmetros
- name (
str) — Nome amigável do template (por exemplo,"JupyterLab","chatbot"). - repo_id (
str) — ID do repositório do Space de modelo (por exemplo,"SpacesExamples/jupyterlab"). - sdk (
str) — SDK com o qual o template é construído (por exemplo,"gradio","docker","static"). - preferred_private (
bool) — Se os Spaces criados a partir deste modelo são recomendados para serem privados.
Contém informações sobre um modelo de Space disponível no Hub.
Retornado por HfApi.list_space_templates(). O repo_id pode ser passado como space_template para HfApi.create_repo() para criar um novo Space a partir desse modelo.
ZeroGpuQuota
classe huggingface_hub.ZeroGpuQuota
< source >( data: dict )
Parâmetros
- base (
float) — Cota total, em segundos de GPU. - remaining (
float) — Cota restante, em segundos de GPU. - resets_at (
datetimeouNone) — Data em que a cota será redefinida.Nonese a cota ainda não tiver sido utilizada. - overquota_used (
floatouNone) — Segundos de GPU de excedente (pago) consumidos após o esgotamento da cota base. Usuários PRO, Team e Enterprise podem comprar créditos para ultrapassar a cota base em https://huggingface.co/settings/billing?add-credits=true.
Contém informações sobre a cota ZeroGPU do usuário autenticado.
A cota ZeroGPU é consumida cada vez que você usa um Space ZeroGPU (pela interface ou por meio de sua API) e é redefinida periodicamente. Consulte https://huggingface.co/docs/hub/spaces-zerogpu para mais detalhes.
Retornado por HfApi.get_zero_gpu_quota().