Managing your Space runtime
Check theHfApi documentation page for the reference of methods to manage your Space on the Hub.
- Duplicate a Space:duplicate_space()
- Fetch current runtime:get_space_runtime()
- Manage secrets:add_space_secret() anddelete_space_secret()
- Manage hardware:request_space_hardware()
- Manage state:pause_space(),restart_space(),set_space_sleep_time()
Data structures
SpaceRuntime
classhuggingface_hub.SpaceRuntime
<source>(data: dict)
Parameters
- stage (
str) —Current stage of the space. Example: RUNNING. - hardware (
strorNone) —Current hardware of the space. Example: “cpu-basic”. Can beNoneif SpaceisBUILDINGfor the first time. - requested_hardware (
strorNone) —Requested hardware. Can be different fromhardwareespecially if the requesthas just been made. Example: “t4-medium”. Can beNoneif no hardware hasbeen requested yet. - sleep_time (
intorNone) —Number of seconds the Space will be kept alive after the last request. By default (if value isNone), theSpace will never go to sleep if it’s running on an upgraded hardware, while it will go to sleep after 48hours on a free ‘cpu-basic’ hardware. For more details, seehttps://huggingface.co/docs/hub/spaces-gpus#sleep-time. - raw (
dict) —Raw response from the server. Contains more information about the Spaceruntime like number of replicas, number of cpu, memory size,…
Contains information about the current runtime of a Space.
SpaceHardware
classhuggingface_hub.SpaceHardware
<source>(valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1)
Enumeration of hardwares available to run your Space on the Hub.
Taken fromhttps://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (private url).
SpaceStage
classhuggingface_hub.SpaceStage
<source>(valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1)
Enumeration of possible stage of a Space on the Hub.
Taken fromhttps://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (private url).
SpaceStorage
classhuggingface_hub.SpaceStorage
<source>(valuenames = Nonemodule = Nonequalname = Nonetype = Nonestart = 1)
Enumeration of persistent storage available for your Space on the Hub.
Taken fromhttps://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (private url).
SpaceVariable
classhuggingface_hub.SpaceVariable
<source>(key: strvalues: dict)
Parameters
- key (
str) —Variable key. Example:"MODEL_REPO_ID" - value (
str) —Variable value. Example:"the_model_repo_id". - description (
stror None) —Description of the variable. Example:"Model Repo ID of the implemented model". - updatedAt (
datetimeor None) —datetime of the last update of the variable (if the variable has been updated at least once).
Contains information about the current variables of a Space.