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[Literal['EU-RO-1', 'CA-MTL-1', 'EU-SE-1', 'US-IL-1', 'EUR-IS-1', 'EU-CZ-1', 'US-TX-3', 'EUR-IS-2', 'US-KS-2', 'US-GA-2', 'US-WA-1', 'US-TX-1', 'CA-MTL-3', 'EU-NL-1', 'US-TX-4', 'US-CA-2', 'US-NC-1', 'OC-AU-1', 'US-DE-1', 'EUR-IS-3', 'CA-MTL-2', 'AP-JP-1', 'EUR-NO-1', 'EU-FR-1', 'US-KS-3', 'US-GA-1'] | str, ...] | Literal['EU-RO-1', 'CA-MTL-1', 'EU-SE-1', 'US-IL-1', 'EUR-IS-1', 'EU-CZ-1', 'US-TX-3', 'EUR-IS-2', 'US-KS-2', 'US-GA-2', 'US-WA-1', 'US-TX-1', 'CA-MTL-3', 'EU-NL-1', 'US-TX-4', 'US-CA-2', 'US-NC-1', 'OC-AU-1', 'US-DE-1', 'EUR-IS-3', 'CA-MTL-2', 'AP-JP-1', 'EUR-NO-1', 'EU-FR-1', 'US-KS-3', 'US-GA-1', 'global'] | str

Specific data center IDs — a tuple, a single ID string, or "global" for any.

'global'
country_codes tuple[str, ...] | str | None

Allowlist of ISO country codes (e.g. ("US", "CA")). None means any country. Applied via countryCode/countryCodes in deploy requests; useful especially for Community Cloud where hosts often have no dataCenterId.

None
exclude_country_codes tuple[str, ...] | str

Country codes to exclude. Applied on top of country_codes; when country_codes is None, exclusion runs against the built-in known-country list.

()
ports tuple[str, ...]

Network ports to expose.

('22/tcp',)
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', country_codes=None, exclude_country_codes=(), ports=('22/tcp',), 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()