Skip to main content

Runner

Source: src/cwsandbox/_discovery.py:128
class Runner(*, runner_id: str, runner_group_id: str, tags: tuple[str, ...], healthy: bool, profile_names: tuple[str, ...], connected_at: datetime, max_cpu_millicores: int, max_memory_bytes: int, max_gpu_count: int, supported_gpu_types: tuple[str, ...], supported_architectures: tuple[str, ...], supports_privileged: bool, available_storage_classes: tuple[str, ...], resources: RunnerResources | None = None)
A runner registered with the discovery service. Runners are the compute nodes that run sandboxes. Each runner advertises its capabilities (CPU, memory, GPU) and the profiles it supports. Attributes
  • resources (RunnerResources | None): Live resource availability, or None if not reported.

RunnerResources

Source: src/cwsandbox/_discovery.py:111
class RunnerResources(*, available_cpu_millicores: int, available_memory_bytes: int, available_gpu_count: int, running_sandboxes: int)
Live resource availability for a runner.

Profile

Source: src/cwsandbox/_discovery.py:192
class Profile(*, profile_name: str, runner_id: str, supported_gpu_types: tuple[str, ...], supported_architectures: tuple[str, ...], service_exposure_modes: tuple[ServiceExposureMode, ...], egress_modes: tuple[EgressMode, ...])
A profile configuration on a specific runner. Profiles define execution environments with specific service exposure modes, egress modes, and hardware capabilities.

ServiceExposureMode

Source: src/cwsandbox/_discovery.py:89
class ServiceExposureMode(*, name: str)
A service exposure mode supported by a profile.

EgressMode

Source: src/cwsandbox/_discovery.py:100
class EgressMode(*, name: str)
An egress mode supported by a profile.
Last modified on May 29, 2026