Hub Python Library documentation

Space 런타임 관리

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Space 런타임 관리

Hub에서 Space를 관리하는 메서드에 대한 참조는 HfApi 문서 페이지를 확인하세요.

데이터 구조

SpaceRuntime

class huggingface_hub.SpaceRuntime

< >

( data: dict )

매개변수

  • stage (str) — 현재 space의 단계입니다. 예: RUNNING.
  • hardware (str 또는 None) — Space의 현재 하드웨어입니다. 예: “cpu-basic”. Space가 처음 BUILDING 상태일 경우 None일 수 있습니다.
  • requested_hardware (str 또는 None) — 요청된 하드웨어입니다. 요청이 방금 이루어진 경우 hardware와 다를 수 있습니다. 예: “t4-medium”. 아직 하드웨어가 요청되지 않은 경우 None일 수 있습니다.
  • sleep_time (int 또는 None) — 마지막 요청 이후 Space가 유지되는 초 수입니다. 기본값(값이 None인 경우)으로, 업그레이드된 하드웨어에서 실행 중이라면 Space는 절대 수면 상태로 전환되지 않으며, 무료 ‘cpu-basic’ 하드웨어에서는 48시간 후 수면 상태로 전환됩니다. 자세한 내용은 https://huggingface.co/docs/hub/spaces-gpus#sleep-time을 참조하세요.
  • volumes (list[Volume] 또는 None) — Space에 마운트된 볼륨 목록입니다. 각 볼륨은 유형, 소스, 마운트 경로 및 선택적 설정을 설명하는 Volume 객체입니다. 볼륨이 연결되어 있지 않으면 None입니다.
  • raw (dict) — 서버에서 반환된 원시 응답입니다. Space 런타임에 대한 추가 정보(예: 리플리카 수, CPU 수, 메모리 크기 등)를 포함합니다.

Space의 현재 런타임에 대한 정보를 포함합니다.

SpaceHardware

class huggingface_hub.SpaceHardware

< >

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

Hub에서 Space를 실행할 수 있는 하드웨어 목록

Value는 문자열과 비교할 수 있습니다:

assert SpaceHardware.CPU_BASIC == "cpu-basic"

https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts(비공개 URL)에서 가져왔습니다.

SpaceStage

class huggingface_hub.SpaceStage

< >

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

Hub의 Space에서 가능한 단계의 열거형입니다.

Value는 문자열과 비교할 수 있습니다:

assert SpaceStage.BUILDING == "BUILDING"

https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (private url)에서 가져왔습니다.

SpaceStorage

class huggingface_hub.SpaceStorage

< >

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

Hub의 Space에서 사용할 수 있는 영속적 스토리지의 목록

Value는 문자열과 비교할 수 있습니다:

assert SpaceStorage.SMALL == "small"

Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (private url).

SpaceVariable

class huggingface_hub.SpaceVariable

< >

( key: strvalues: dict )

매개변수

  • key (str) — 변수 키. 예: "MODEL_REPO_ID"
  • value (str) — 변수 값. 예: "the_model_repo_id".
  • description (str 또는 None) — 변수의 설명. 예: "Model Repo ID of the implemented model".
  • updatedAt (datetime 또는 None) — 변수가 마지막으로 업데이트된 datetime (변수가 최소 한 번 이상 업데이트된 경우).

Space의 현재 변수에 대한 정보를 포함합니다.

SpaceTemplate

class huggingface_hub.SpaceTemplate

< >

( data: dict )

매개변수

  • name (str) — 템플릿의 사람이 읽기 쉬운 이름 (예: "JupyterLab", "chatbot").
  • repo_id (str) — 템플릿 Space의 Repo id (예: "SpacesExamples/jupyterlab").
  • sdk (str) — 템플릿이 구축된 SDK (예: "gradio", "docker", "static").
  • preferred_private (bool) — 이 템플릿에서 생성된 Spaces가 비공개로 설정되는 것이 권장되는지 여부

Hub에서 사용할 수 있는 Space 템플릿에 대한 정보를 포함합니다.

HfApi.list_space_templates()에서 반환됩니다. repo_id를 HfApi.create_repo()의 space_template으로 전달하여 해당 템플릿에서 새로운 Space를 생성할 수 있습니다.

ZeroGpuQuota

class huggingface_hub.ZeroGpuQuota

< >

( data: dict )

매개변수

  • base (float) — GPU-초 단위의 총 할당량입니다.
  • remaining (float) — GPU-초 단위로 남은 할당량입니다.
  • resets_at (datetime 또는 None) — 할당이 리셋되는 날짜입니다. 할당이 아직 사용되지 않은 경우 None입니다.
  • overquota_used (float 또는 None) — 기본 할당량이 소진된 후 소비된 과금 대상 GPU-초입니다. PRO, Team 및 Enterprise 사용자는 https://huggingface.co/settings/billing?add-credits=true에서 크레딧을 구매하여 기본 할당량을 초과할 수 있습니다.

인증된 사용자의 ZeroGPU 할당량에 대한 정보를 포함합니다.

ZeroGPU Space를 사용할 때마다(UI 또는 해당 API를 통해) ZeroGPU 할당량이 소모되며, 주기적으로 초기화됩니다. 자세한 내용은 https://huggingface.co/docs/hub/spaces-zerogpu를 참조하세요.

HfApi.get_zero_gpu_quota()에서 반환됩니다.

Update on GitHub