Functions

​

list_runners

list_runners(*, auth: AuthConfig | None = None, runner_group_id: str | None = None, gpu_type: str | None = None, architecture: str | None = None, healthy_only: bool = False, include_resources: bool = False, min_available_cpu_millicores: int | None = None, min_available_memory_bytes: int | None = None, min_available_gpu_count: int | None = None, service_visibility: str | None = None) -> list[Runner]

• auth (AuthConfig | None): Authentication strategy, resolved headers, or provider for this request.
• runner_group_id (str | None): Restrict results to this runner group.
• gpu_type (str | None): Only return runners that support this GPU type.
• architecture (str | None): Only return runners that support this CPU architecture.
• healthy_only (bool): Only return healthy runners.
• include_resources (bool): If True, include live resource availability.
• min_available_cpu_millicores (int | None): Client-side filter on unreserved CPU.
• min_available_memory_bytes (int | None): Client-side filter on unreserved memory.
• min_available_gpu_count (int | None): Client-side filter on unreserved GPUs.
• service_visibility (str | None): Require a runner that can enforce this typed visibility (public / private / custom).

• list[Runner]: List of Runner objects matching the filters.

​

get_runner

get_runner(runner_id: str, *, organization_id: str, auth: AuthConfig | None = None) -> Runner

• runner_id (str): Runner identifier (not globally unique alone).
• organization_id (str): Organization that owns the runner.
• auth (AuthConfig | None): Authentication strategy, resolved headers, or provider for this request.

• Runner: Runner with full details.

​

format_bytes

format_bytes(value: int) -> str

​

Format bytes as a human-readable string using binary units.

​

format_cpu

format_cpu(millicores: int) -> str

​

Format CPU millicores as a human-readable string.