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

You can specify custom resource sizes for your Devboxes. We offer granular customization in these ranges:
  • CPU: must be multiple of 2. Min is 1 core, max is 16 cores.
  • Memory: must be multiple of 2. Min is 2GiB, max is 64GiB.
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. Both parameters are required when using resource_size_request: CUSTOM_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": "CUSTOM_SIZE",
      "custom_cpu_cores": 4,
      "custom_gb_memory": 32
    }
  }'