Skip to main content
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: 
curl -X POST 'https://api.runloop.ai/v1/devboxes' \
  -H "Authorization: Bearer $RUNLOOP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "launch_parameters": {
      "resource_size_request": "MEDIUM"
    }
  }'
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 when 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.
curl -X POST 'https://api.runloop.ai/v1/devboxes' \
  -H "Authorization: Bearer $RUNLOOP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "launch_parameters": {
      "resource_size_request": "CUSTOM_SIZE",
      "custom_cpu_cores": 4,
      "custom_gb_memory": 32
    }
  }'