Skip to main content
Start with the Runloop Quickstart to use the examples below.
Runloop offers flexible options to tailor your Devbox resources and lifecycle to your specific AI workloads. This guide covers predefined resource sizes for standardized configurations.

​
Predefined Resource Sizes

Runloop provides the following resource configurations for Devboxes:
SizeCPUMemoryStorage
X_SMALL0.51GB4GB
SMALL12GB4GB
MEDIUM24GB8GB
LARGE28GB16GB
X_LARGE416GB16GB
XX_LARGE832GB16GB

​
Launch Parameters

When creating a Devbox, use LaunchParameters to specify the desired configuration.

​
Resource Size

Set the resource_size_request parameter to choose a predefined size: 
devbox = await runloop.devboxes.create(
    launch_parameters={
        "resource_size_request": "MEDIUM"
    }
)

print(f"Devbox created with ID: {devbox.id}")
This example creates a Devbox with 2 CPU cores and 2Gi of memory.

​
Custom Resource Sizes

To use custom resource sizes, set the resource_size_request parameter to CUSTOM_SIZE and specify the desired resource sizes in the custom_cpu_cores and custom_gb_memory parameters. We offer granular customization in these ranges:
Both custom_cpu_cores and custom_gb_memory parameters are required using resource_size_request: CUSTOM_SIZE.
  • CPU: Must be multiple of 2. Min is 0.5 core, max is 16 cores.
  • Memory: Must be multiple of 2. Min is 1GiB, max is 64GiB.
  • Storage: Optional. Must be multiple of 2. Min is 2GiB, max is 64GiB. If not specified, the default of 16GiB will be used.
devbox = await runloop.devboxes.create(
    launch_parameters={
        "resource_size_request": "CUSTOM_SIZE",
        "custom_cpu_cores": 4,
        "custom_gb_memory": 32
    }
)
print(f"Devbox created with ID: {devbox.id}")