Skip to content

RunPod

skyward.RunPod

RunPod serverless GPU provider.

Parameters:

Name Type Description Default
cluster_mode Literal['instant', 'individual']

"instant" for RunPod's managed cluster, "individual" for individual pod provisioning.

'individual'
global_networking bool | None

Enable global networking. None auto-detects.

None
api_key str | None

RunPod API key. None reads from RUNPOD_API_KEY env var.

None
cloud_type Literal['community', 'secure']

"secure" for verified data centers, "community" for community-hosted GPUs.

'secure'
ubuntu Literal['20.04', '22.04', '24.04', 'newest'] | str

Ubuntu version for the base image.

'newest'
container_disk_gb int

Container root disk size in GB.

50
volume_gb int

Persistent volume size in GB.

20
volume_mount_path str

Mount path for the persistent volume.

'/workspace'
data_center_ids tuple[str, ...] | Literal['global']

Specific data center IDs or "global" for any.

'global'
ports tuple[str, ...]

Network ports to expose.

('22/tcp',)
provision_timeout float

Max seconds to wait for pod provisioning.

300.0
bootstrap_timeout float

Max seconds to wait for bootstrap completion.

600.0
bid_multiplier float

Multiplier for spot bid price.

1
base_image Literal['nvidia', 'runpod-base', 'runpod-pytorch']

Docker Hub image family for automatic resolution. "nvidia" uses nvidia/cuda cudnn-runtime images (default), "runpod-base" uses runpod/base images, "runpod-pytorch" uses runpod/pytorch images. Ignored when container_image is set.

'nvidia'
container_image DockerImage | None

Override the container image for pods. Skips automatic image resolution from Docker Hub when set.

None
min_inet_down float | None

Minimum download speed in Mbps. None disables filter.

None
min_inet_up float | None

Minimum upload speed in Mbps. None disables filter.

None

Examples:

>>> sky.RunPod(cloud_type="secure", container_disk_gb=100)

type property

__init__(*, cluster_mode='individual', base_image='nvidia', global_networking=None, api_key=None, cloud_type='secure', ubuntu='newest', container_disk_gb=50, volume_gb=20, volume_mount_path='/workspace', data_center_ids='global', ports=('22/tcp',), provision_timeout=300.0, bootstrap_timeout=600.0, request_timeout=30, cpu_clock='3c', bid_multiplier=1, container_image=None, registry_auth='docker hub', min_inet_down=None, min_inet_up=None)

create_provider() async

default_options()