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

# nemo_automodel.components.launcher.nemo_run.utils

## Module Contents

### Functions

| Name                                                                                                    | Description                                                            |
| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| [`apply_overrides`](#nemo_automodel-components-launcher-nemo_run-utils-apply_overrides)                 | Apply arbitrary YAML overrides to an executor via `setattr`.           |
| [`load_executor_from_file`](#nemo_automodel-components-launcher-nemo_run-utils-load_executor_from_file) | Load a named executor from a Python file containing an `EXECUTOR_MAP`. |
| [`submit_nemo_run_job`](#nemo_automodel-components-launcher-nemo_run-utils-submit_nemo_run_job)         | Submit a job via NeMo-Run's Experiment API.                            |

### Data

[`logger`](#nemo_automodel-components-launcher-nemo_run-utils-logger)

### API

```python
nemo_automodel.components.launcher.nemo_run.utils.apply_overrides(
    executor: typing.Any,
    overrides: dict
) -> None
```

Apply arbitrary YAML overrides to an executor via `setattr`.

Dict and list values are *merged* with existing executor attributes
(dicts are updated, lists are extended).  All other values are set
directly.

```python
nemo_automodel.components.launcher.nemo_run.utils.load_executor_from_file(
    name: str,
    executors_file: str
) -> typing.Any
```

Load a named executor from a Python file containing an `EXECUTOR_MAP`.

The file (typically `$NEMORUN_HOME/executors.py`) must define a module-level
`EXECUTOR_MAP` dictionary whose keys are executor names and whose values
are pre-built `nemo_run` executor instances (or zero-arg callables that
return one).

**Parameters:**

Key to look up in `EXECUTOR_MAP`.

Absolute path to the Python file.

**Returns:** `Any`

The executor object.

**Raises:**

* `FileNotFoundError`: If *executors\_file* does not exist.
* `KeyError`: If *name* is not found in the `EXECUTOR_MAP`.

```python
nemo_automodel.components.launcher.nemo_run.utils.submit_nemo_run_job(
    script: typing.Any,
    executor: typing.Any,
    job_name: str,
    detach: bool,
    tail_logs: bool
) -> int
```

Submit a job via NeMo-Run's Experiment API.

**Parameters:**

A `nemo_run.Script` object.

A NeMo-Run executor instance.

Experiment and task name.

If True, return immediately after submission.

If True, stream logs after submission.

**Returns:** `int`

0 on successful submission.

```python
nemo_automodel.components.launcher.nemo_run.utils.logger = logging.getLogger(__name__)
```