> This page is for version dev.
> For other versions, use one of these documentation indexes:
> - 1.8.1 (default): https://docs.nvidia.com/networking/cloudai/1.8.1/llms.txt
> - 1.7.1: https://docs.nvidia.com/networking/cloudai/1.7.1/llms.txt
> - 1.6.1: https://docs.nvidia.com/networking/cloudai/1.6.1/llms.txt
> - dev: https://docs.nvidia.com/networking/cloudai/dev/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/networking/cloudai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/networking/cloudai/_mcp/server.

This chapter lists all the systems supported by CloudAI. The attributes shown for each system can be set in TOML configuration files.

| System                           | Scheduler Value |
| -------------------------------- | --------------- |
| [Slurm](#slurm-system)           | `slurm`         |
| [Kubernetes](#kubernetes-system) | `kubernetes`    |
| [RunAI](#runai-system)           | `runai`         |
| [LSF](#lsf-system)               | `lsf`           |
| [Standalone](#standalone-system) | `standalone`    |

## Slurm

### `SlurmSystem`

Represents a Slurm system.

| Field                                   | Type                                                              | Default                    | Description              |
| --------------------------------------- | ----------------------------------------------------------------- | -------------------------- | ------------------------ |
| `name`                                  | `str`                                                             | Required                   |                          |
| `scheduler`                             | `str`                                                             | `'slurm'`                  |                          |
| `install_path`                          | `pathlib.Path`                                                    | Required                   |                          |
| `output_path`                           | `pathlib.Path`                                                    | Required                   |                          |
| `hf_home_path`                          | `pathlib.Path`                                                    | Factory: `System.<lambda>` |                          |
| `global_env_vars`                       | `dict[str, typing.Any]`                                           | Factory: `dict`            |                          |
| `monitor_interval`                      | `float`                                                           | `60.0`                     |                          |
| `sol`                                   | `dict[str, list[cloudai.metrics.SOLTarget]]`                      | Factory: `dict`            |                          |
| `default_partition`                     | `str`                                                             | Required                   |                          |
| `partitions`                            | `List[cloudai.systems.slurm.slurm_system.SlurmPartition]`         | Required                   |                          |
| `account`                               | `str \| None`                                                     | `None`                     |                          |
| `distribution`                          | `str \| None`                                                     | `None`                     |                          |
| `mpi`                                   | `str`                                                             | `'pmix'`                   |                          |
| `gpus_per_node`                         | `int \| None`                                                     | `None`                     |                          |
| `ntasks_per_node`                       | `int \| None`                                                     | `None`                     |                          |
| `cache_docker_images_locally`           | `bool`                                                            | `False`                    |                          |
| `docker_image_import_extra_sbatch_args` | `list[str]`                                                       | Factory: `list`            |                          |
| `extra_srun_args`                       | `str \| None`                                                     | `None`                     |                          |
| `extra_sbatch_args`                     | `list[str]`                                                       | Factory: `list`            |                          |
| `extra_transient_status_errors`         | `list[str]`                                                       | Factory: `list`            |                          |
| `status_retry_pause_seconds`            | `int`                                                             | `10`                       | Constraints: `Ge(ge=0)`. |
| `container_mount_home`                  | `bool`                                                            | `False`                    |                          |
| `slurm_api`                             | `cloudai.systems.slurm.slurm_rest_client.SlurmAPIConfig \| None`  | `None`                     |                          |
| `data_repository`                       | `cloudai.systems.slurm.slurm_system.DataRepositoryConfig \| None` | `None`                     |                          |
| `reports`                               | `dict[str, cloudai.models.scenario.ReportConfig] \| None`         | `None`                     |                          |

### `SlurmPartition`

Represents a partition within a Slurm system.

| Field    | Type                                                  | Default  | Description |
| -------- | ----------------------------------------------------- | -------- | ----------- |
| `name`   | `str`                                                 | Required |             |
| `groups` | `List[cloudai.systems.slurm.slurm_system.SlurmGroup]` | `[]`     |             |

### `SlurmGroup`

Represents a group of nodes within a partition.

| Field   | Type        | Default  | Description |
| ------- | ----------- | -------- | ----------- |
| `name`  | `str`       | Required |             |
| `nodes` | `List[str]` | Required |             |

### `DataRepositoryConfig`

Configuration for a data repository.

| Field          | Type   | Default  | Description |
| -------------- | ------ | -------- | ----------- |
| `endpoint`     | `str`  | Required |             |
| `verify_certs` | `bool` | `True`   |             |

## Kubernetes

### `KubernetesSystem`

Represents a Kubernetes system.

| Field               | Type                                         | Default                    | Description |
| ------------------- | -------------------------------------------- | -------------------------- | ----------- |
| `name`              | `str`                                        | Required                   |             |
| `scheduler`         | `str`                                        | `'kubernetes'`             |             |
| `install_path`      | `pathlib.Path`                               | Required                   |             |
| `output_path`       | `pathlib.Path`                               | Required                   |             |
| `hf_home_path`      | `pathlib.Path`                               | Factory: `System.<lambda>` |             |
| `global_env_vars`   | `dict[str, typing.Any]`                      | Factory: `dict`            |             |
| `monitor_interval`  | `float`                                      | `1.0`                      |             |
| `sol`               | `dict[str, list[cloudai.metrics.SOLTarget]]` | Factory: `dict`            |             |
| `kube_config_path`  | `pathlib.Path`                               | Required                   |             |
| `default_namespace` | `str`                                        | Required                   |             |
| `gpus_per_node`     | `int`                                        | `1`                        |             |
| `use_host_network`  | `bool \| None`                               | `None`                     |             |

## RunAI

### `RunAISystem`

RunAISystem integrates with the RunAI platform to manage and monitor jobs and nodes.

| Field              | Type                                         | Default                    | Description |
| ------------------ | -------------------------------------------- | -------------------------- | ----------- |
| `name`             | `str`                                        | Required                   |             |
| `scheduler`        | `str`                                        | `'runai'`                  |             |
| `install_path`     | `pathlib.Path`                               | Required                   |             |
| `output_path`      | `pathlib.Path`                               | Required                   |             |
| `hf_home_path`     | `pathlib.Path`                               | Factory: `System.<lambda>` |             |
| `global_env_vars`  | `dict[str, typing.Any]`                      | Factory: `dict`            |             |
| `monitor_interval` | `float`                                      | `60.0`                     |             |
| `sol`              | `dict[str, list[cloudai.metrics.SOLTarget]]` | Factory: `dict`            |             |
| `base_url`         | `str`                                        | Required                   |             |
| `verify_certs`     | `bool`                                       | `True`                     |             |
| `user_email`       | `str`                                        | Required                   |             |
| `app_id`           | `str`                                        | Required                   |             |
| `app_secret`       | `str`                                        | Required                   |             |
| `project_id`       | `str`                                        | Required                   |             |
| `cluster_id`       | `str`                                        | Required                   |             |

### `RunAINode`

Represent a node in the RunAI cluster.

| Field               | Type                                          | Default                           | Description               |
| ------------------- | --------------------------------------------- | --------------------------------- | ------------------------- |
| `status`            | `cloudai.systems.runai.runai_node.NodeStatus` | `<NodeStatus.UNKNOWN: 'Unknown'>` | Alias: `status`.          |
| `conditions`        | `List[Dict[str, Any]]`                        | Factory: `list`                   | Alias: `conditions`.      |
| `taints`            | `List[Dict[str, Any]]`                        | Factory: `list`                   | Alias: `taints`.          |
| `node_pool`         | `str`                                         | `''`                              | Alias: `nodePool`.        |
| `created_at`        | `str`                                         | `''`                              | Alias: `createdAt`.       |
| `gpu_type`          | `str \| None`                                 | `None`                            | Alias: `gpuType`.         |
| `gpu_count`         | `int \| None`                                 | `None`                            | Alias: `gpuCount`.        |
| `nvlink_domain_uid` | `str \| None`                                 | `None`                            | Alias: `nvLinkDomainUid`. |
| `nvlink_clique_id`  | `str \| None`                                 | `None`                            | Alias: `nvLinkCliqueId`.  |
| `name`              | `str`                                         | `''`                              | Alias: `name`.            |
| `id`                | `str`                                         | `''`                              | Alias: `id`.              |
| `cluster_uuid`      | `str`                                         | `''`                              | Alias: `clusterUuid`.     |
| `updated_at`        | `str`                                         | `''`                              | Alias: `updatedAt`.       |

## LSF

### `LSFSystem`

Represents an LSF system.

| Field              | Type                                            | Default                    | Description                                                 |
| ------------------ | ----------------------------------------------- | -------------------------- | ----------------------------------------------------------- |
| `name`             | `str`                                           | Required                   |                                                             |
| `scheduler`        | `str`                                           | `'lsf'`                    |                                                             |
| `install_path`     | `pathlib.Path`                                  | Required                   |                                                             |
| `output_path`      | `pathlib.Path`                                  | Required                   |                                                             |
| `hf_home_path`     | `pathlib.Path`                                  | Factory: `System.<lambda>` |                                                             |
| `global_env_vars`  | `dict[str, typing.Any]`                         | Factory: `dict`            |                                                             |
| `monitor_interval` | `float`                                         | `60.0`                     |                                                             |
| `sol`              | `dict[str, list[cloudai.metrics.SOLTarget]]`    | Factory: `dict`            |                                                             |
| `queues`           | `List[cloudai.systems.lsf.lsf_system.LSFQueue]` | Factory: `list`            | A list of queues in the LSF system, filled in automatically |
| `account`          | `str \| None`                                   | `None`                     |                                                             |
| `project_name`     | `str \| None`                                   | `None`                     |                                                             |
| `default_queue`    | `str \| None`                                   | `None`                     |                                                             |
| `app`              | `str \| None`                                   | `None`                     |                                                             |
| `os_version`       | `str \| None`                                   | `None`                     |                                                             |

### `LSFQueue`

Represents a queue within the LSF system.

| Field    | Type                                            | Default  | Description |
| -------- | ----------------------------------------------- | -------- | ----------- |
| `name`   | `str`                                           | Required |             |
| `groups` | `List[cloudai.systems.lsf.lsf_system.LSFGroup]` | `[]`     |             |

### `LSFGroup`

Represents a group of nodes within a queue.

| Field   | Type        | Default  | Description |
| ------- | ----------- | -------- | ----------- |
| `name`  | `str`       | Required |             |
| `nodes` | `List[str]` | Required |             |

## Standalone

### `StandaloneSystem`

Class representing a Standalone system.

This class is used for systems that execute commands directly without a job scheduler.

| Field              | Type                                         | Default                    | Description |
| ------------------ | -------------------------------------------- | -------------------------- | ----------- |
| `name`             | `str`                                        | Required                   |             |
| `scheduler`        | `str`                                        | `'standalone'`             |             |
| `install_path`     | `pathlib.Path`                               | Required                   |             |
| `output_path`      | `pathlib.Path`                               | Required                   |             |
| `hf_home_path`     | `pathlib.Path`                               | Factory: `System.<lambda>` |             |
| `global_env_vars`  | `dict[str, typing.Any]`                      | Factory: `dict`            |             |
| `monitor_interval` | `float`                                      | `1.0`                      |             |
| `sol`              | `dict[str, list[cloudai.metrics.SOLTarget]]` | Factory: `dict`            |             |