Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.runloop.ai/llms.txt

Use this file to discover all available pages before exploring further.

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$/hr
X_SMALL0.51 GB4 GB$0.0806
SMALL12 GB4 GB$0.1598
MEDIUM24 GB8 GB$0.3195
LARGE28 GB16 GB$0.4231
X_LARGE416 GB16 GB$0.8407
XX_LARGE832 GB16 GB$1.6760
Compute is billed only while devbox status is one of [initializing, running, suspending, resuming].

​
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.devbox.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.devbox.create(
    launch_parameters={
        "resource_size_request": "CUSTOM_SIZE",
        "custom_cpu_cores": 4,
        "custom_gb_memory": 32
    }
)
print(f"Devbox created with ID: {devbox.id}")