Hub Python Library documentation
Spaceランタイムの管理
Spaceランタイムの管理
Hub上のSpaceを管理するためのメソッドの参考情報については、HfApiのドキュメントページを確認してください。
- 現在のランタイムを取得します: 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 (
strまたはNone) — スペースの現在のハードウェアです。例: “cpu-basic”。スペースが初めてBUILDING状態にある場合、Noneになることがあります。 - 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 )
Hub上のSpaceを実行するために利用可能なハードウェアの列挙。
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 )
Hub上のSpaceのステージとして考えられる値の列挙。
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 )
Hub上のSpaceで利用可能な永続ストレージの列挙。
https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (非公開URL)より引用。
SpaceVariable
クラス huggingface_hub.SpaceVariable
< source >( key: strvalues: dict )
Spaceの現在の変数に関する情報を含みます。
SpaceTemplate
クラス huggingface_hub.SpaceTemplate
< source >( data: dict )
Hubで利用可能なSpaceテンプレートに関する情報を含みます。
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 (
floatまたはNone) — ベースクォータを使い切った後に消費されたオーバークォータ(有料)GPU 秒数です。PRO、Team、Enterprise ユーザーは、https://huggingface.co/settings/billing?add-credits=true でクレジットを購入し、ベースクォータを超えて利用できます。
認証済みユーザーのZeroGPUクォータに関する情報を含みます。
ZeroGPUのクォータは、ZeroGPU Spaceを使用するたびに(UIからでも、そのAPIを通じてでも)消費され、定期的にリセットされます。詳細はhttps://huggingface.co/docs/hub/spaces-zerogpuを参照してください。
HfApi.get_zero_gpu_quota()によって返されます。