Hub Python Library documentation
Управление средой выполнения вашего Space
Управление средой выполнения вашего Space
См. страницу документации HfApi для справочника методов управления вашим Space на Hub.
- Получить текущее время выполнения: get_space_runtime()
- Получить журналы сборки или выполнения: fetch_space_logs()
- Управление секретами: add_space_secret() и delete_space_secret()
- Управление оборудованием: request_space_hardware()
- Управление состоянием: pause_space(), restart_space(), set_space_sleep_time()
- Дождитесь, пока Space будет готов: wait_for_space()
- Проверьте вашу квоту ZeroGPU: get_zero_gpu_quota()
Структуры данных
SpaceRuntime
класс huggingface_hub.SpaceRuntime
< source >( data: dict )
Параметры
- stage (
str) — Текущий этап пространства. Пример: RUNNING. - hardware (
strorNone) — Текущее оборудование Space. Пример: “cpu-basic”. Может бытьNone, если Space находится в состоянииBUILDINGпри первой сборке. - requested_hardware (
strилиNone) — Запрованное оборудование. Может отличаться отhardware, особенно если запрос только что был сделан. Пример: “t4-medium”. Может бытьNone, если оборудование еще не запрашивалось. - sleep_time (
intorNone) — Количество секунд, в течение которых 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
класс huggingface_hub.SpaceHardware
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Перечень доступных аппаратных конфигураций для запуска вашего Space на Hub.
Взято из https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (приватный URL).
SpaceStage
класс huggingface_hub.SpaceStage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Перечисление возможных стадий Space на Hub.
Взято из https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (приватный URL).
SpaceStorage
класс huggingface_hub.SpaceStorage
< source >( valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1 )
Перечень вариантов постоянного хранилища, доступных для вашего Space на Hub.
Взято из https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (приватный URL).
SpaceVariable
класс huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Параметры
- key (
str) — Ключ переменной. Пример:"MODEL_REPO_ID" - value (
str) — Значение переменной. Пример:"the_model_repo_id". - description (
stror None) — Описание переменной. Пример:"Model Repo ID of the implemented model". - updatedAt (
datetimeили None) — datetime последнего обновления переменной (если переменная была обновлена хотя бы один раз).
Содержит информацию о текущих переменных Space.
SpaceTemplate
класс huggingface_hub.SpaceTemplate
< source >( data: dict )
Параметры
- name (
str) — Человекочитаемое имя шаблона (например,"JupyterLab","chatbot"). - repo_id (
str) — Идентификатор репозитория пространства-шаблона (например,"SpacesExamples/jupyterlab"). - sdk (
str) — SDK, с которым создан шаблон (например,"gradio","docker","static"). - preferred_private (
bool) — Определяет, рекомендуется ли создавать Spaces из этого шаблона как частные.
Содержит информацию о шаблоне Space, доступном на Hub.
Возвращается методом HfApi.list_space_templates(). Значение repo_id можно передать в качестве параметра space_template в метод HfApi.create_repo(), чтобы создать новое Space на основе этого шаблона.
ZeroGpuQuota
класс huggingface_hub.ZeroGpuQuota
< source >( data: dict )
Параметры
- base (
float) — Общий лимит, в секундах GPU. - remaining (
float) — Оставшаяся квота, в секундах GPU. - resets_at (
datetimeилиNone) — Дата, к которой будет сброшен лимит.None, если лимит ещё не использовался. - overquota_used (
floatorNone) — Количество оплаченных GPU-секунд, потребленных сверх базовой квоты после ее исчерпания. Пользователи PRO, Team и Enterprise могут приобрести кредиты для превышения базовой квоты по адресу https://huggingface.co/settings/billing?add-credits=true.
Содержит информацию о квоте ZeroGPU для аутентифицированного пользователя.
Квота ZeroGPU расходуется каждый раз, когда вы используете Space с ZeroGPU (через интерфейс или через его API), и периодически сбрасывается. Подробнее см. в https://huggingface.co/docs/hub/spaces-zerogpu.
Возвращается методом HfApi.get_zero_gpu_quota().