Hub Python Library documentation

Gerenciando o runtime do seu Space

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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.

Estruturas de dados

SpaceRuntime

classe huggingface_hub.SpaceRuntime

< >

( data: dict )

Parâmetros

  • stage (str) — Etapa atual do espaço. Exemplo: RUNNING.
  • hardware (str ou None) — Hardware atual do espaço. Exemplo: “cpu-basic”. Pode ser None se o Espaço estiver BUILDING pela primeira vez.
  • requested_hardware (str ou None) — Hardware solicitado. Pode ser diferente de hardware, especialmente se a solicitação acabou de ser feita. Exemplo: “t4-medium”. Pode ser None se nenhum hardware ainda tiver sido solicitado.
  • sleep_time (int or None) — Número de segundos que o Space permanecerá ativo após a última solicitação. Por padrão (se o valor for None), 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] ou None) — Lista de volumes montados no Space. Cada volume é um objeto Volume que descreve seu tipo, origem, caminho de montagem e configurações opcionais. None se 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

< >

( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )

Enumeração dos hardwares disponíveis para executar seu Space no Hub.

O valor pode ser comparado a uma string:

assert SpaceHardware.CPU_BASIC == "cpu-basic"

Retirado de https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (URL privada).

SpaceStage

classe huggingface_hub.SpaceStage

< >

( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )

Enumeração dos possíveis estágios de um Space no Hub.

O valor pode ser comparado a uma string:

assert SpaceStage.BUILDING == "BUILDING"

Retirado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (url privada).

SpaceStorage

classe huggingface_hub.SpaceStorage

< >

( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )

Enumeração do armazenamento persistente disponível para seu Space no Hub.

O valor pode ser comparado a uma string:

assert SpaceStorage.SMALL == "small"

Retirado de https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (url privada).

SpaceVariable

classe huggingface_hub.SpaceVariable

< >

( 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 (str or None) — Descrição da variável. Exemplo: "Model Repo ID of the implemented model".
  • updatedAt (datetime ou 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

< >

( 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

< >

( data: dict )

Parâmetros

  • base (float) — Cota total, em segundos de GPU.
  • remaining (float) — Cota restante, em segundos de GPU.
  • resets_at (datetime ou None) — Data em que a cota será redefinida. None se a cota ainda não tiver sido utilizada.
  • overquota_used (float ou None) — 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().

Update on GitHub