> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/fabric/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/fabric/_mcp/server.
# Errors
> Structured exception hierarchy for config, capability, state, and runtime failures.
# module `nemo_fabric.errors`
Public exception hierarchy for the NeMo Fabric Python SDK.
---
## class `FabricError`
Base class for structured SDK-level NeMo Fabric errors.
Catch this type to handle any SDK failure while preserving machine-readable stage, code, retryability, and detail fields.
**Attributes:**
- `stage`: Lifecycle stage that failed, when known.
- `code`: Stable machine-readable error code, when available.
- `retryable`: Whether retrying may succeed without changing the request.
- `details`: Detached structured error details.
### Inheritance
Direct base: `RuntimeError`.
### method `__init__`
```python
def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None
```
Initialize a structured NeMo Fabric exception.
**Args:**
- `message`: Human-readable failure description.
- `stage`: Optional lifecycle stage that failed.
- `code`: Optional stable machine-readable error code.
- `retryable`: Whether callers may safely retry unchanged input.
- `details`: Optional structured diagnostic context. The exception stores a deep copy.
---
## class `FabricConfigError`
Invalid SDK input, request shape, factory, or resolved config.
### Inheritance
Direct base: `FabricError`.
### method `__init__`
```python
def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None
```
Initialize a structured NeMo Fabric exception.
**Args:**
- `message`: Human-readable failure description.
- `stage`: Optional lifecycle stage that failed.
- `code`: Optional stable machine-readable error code.
- `retryable`: Whether callers may safely retry unchanged input.
- `details`: Optional structured diagnostic context. The exception stores a deep copy.
---
## class `FabricRuntimeError`
Failure while starting, invoking, stopping, or otherwise driving a runtime.
### Inheritance
Direct base: `FabricError`.
### method `__init__`
```python
def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None
```
Initialize a structured NeMo Fabric exception.
**Args:**
- `message`: Human-readable failure description.
- `stage`: Optional lifecycle stage that failed.
- `code`: Optional stable machine-readable error code.
- `retryable`: Whether callers may safely retry unchanged input.
- `details`: Optional structured diagnostic context. The exception stores a deep copy.
---
## class `FabricStateError`
Operation rejected because a local runtime is in the wrong state.
### Inheritance
Direct base: `FabricRuntimeError`.
### method `__init__`
```python
def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None
```
Initialize a structured NeMo Fabric exception.
**Args:**
- `message`: Human-readable failure description.
- `stage`: Optional lifecycle stage that failed.
- `code`: Optional stable machine-readable error code.
- `retryable`: Whether callers may safely retry unchanged input.
- `details`: Optional structured diagnostic context. The exception stores a deep copy.
---
## class `FabricCapabilityError`
Operation rejected by resolved runtime capabilities or implementation status.
### Inheritance
Direct base: `FabricRuntimeError`.
### method `__init__`
```python
def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None
```
Initialize a structured NeMo Fabric exception.
**Args:**
- `message`: Human-readable failure description.
- `stage`: Optional lifecycle stage that failed.
- `code`: Optional stable machine-readable error code.
- `retryable`: Whether callers may safely retry unchanged input.
- `details`: Optional structured diagnostic context. The exception stores a deep copy.
---
## class `FabricNativeUnavailableError`
SDK call requires the PyO3 extension, but it is not installed or importable.
### Inheritance
Direct base: `FabricRuntimeError`.
### method `__init__`
```python
def __init__(
message: str,
*,
stage: str | None = None,
code: str | None = None,
retryable: bool = False,
details: Mapping[str, Any] | None = None,
) -> None
```
Initialize a structured NeMo Fabric exception.
**Args:**
- `message`: Human-readable failure description.
- `stage`: Optional lifecycle stage that failed.
- `code`: Optional stable machine-readable error code.
- `retryable`: Whether callers may safely retry unchanged input.
- `details`: Optional structured diagnostic context. The exception stores a deep copy.
---
_This file was automatically generated via [lazydocs](https://github.com/ml-tooling/lazydocs)._