> 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.

# Python SDK Reference

> Complete reference for the public NeMo Fabric Python SDK.

# API Overview

## Modules

- [`nemo_fabric.client`](/nemo/fabric/reference/api/python-library-reference/client#module-nemo_fabricclient): Native Python client for resolving and running NVIDIA NeMo Fabric agents.
- [`nemo_fabric.runtime`](/nemo/fabric/reference/api/python-library-reference/runtime#module-nemo_fabricruntime): Runtime lifecycle support for the NVIDIA NeMo Fabric Python SDK.
- [`nemo_fabric.streaming`](/nemo/fabric/reference/api/python-library-reference/streaming#module-nemo_fabricstreaming): NVIDIA NeMo Relay streaming support for the NVIDIA NeMo Fabric Python SDK.
- [`nemo_fabric.models`](/nemo/fabric/reference/api/python-library-reference/models#module-nemo_fabricmodels): Pydantic SDK models for NVIDIA NeMo Fabric configuration and requests.
- [`nemo_fabric.types`](/nemo/fabric/reference/api/python-library-reference/types#module-nemo_fabrictypes): Public data contracts for the NeMo Fabric Python SDK.
- [`nemo_fabric.errors`](/nemo/fabric/reference/api/python-library-reference/errors#module-nemo_fabricerrors): Public exception hierarchy for the NeMo Fabric Python SDK.

## Classes

- [`client.Fabric`](/nemo/fabric/reference/api/python-library-reference/client#class-fabric): Primary Python entrypoint for NeMo Fabric.
- [`runtime.Runtime`](/nemo/fabric/reference/api/python-library-reference/runtime#class-runtime): One logical, stateful harness execution.
- [`runtime.RuntimeStatus`](/nemo/fabric/reference/api/python-library-reference/runtime#class-runtimestatus): Lifecycle state of a runtime.
- [`streaming.InvokeStream`](/nemo/fabric/reference/api/python-library-reference/streaming#class-invokestream): Async iterator of raw ATOF records for one runtime invocation.
- [`models.EnvironmentConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-environmentconfig): Execution environment configuration supplied by the consumer.
- [`models.FabricBaseModel`](/nemo/fabric/reference/api/python-library-reference/models#class-fabricbasemodel): Base class for SDK-facing Pydantic models.
- [`models.FabricConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-fabricconfig): SDK-facing typed NeMo Fabric agent configuration.
- [`models.HarnessConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-harnessconfig): Harness adapter selection plus adapter-owned settings.
- [`models.InstructionConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-instructionconfig): One portable instruction value.
- [`models.InstructionsConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-instructionsconfig): Harness-neutral agent instructions.
- [`models.McpConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-mcpconfig): MCP capability configuration.
- [`models.McpServerConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-mcpserverconfig): MCP server configuration.
- [`models.MetadataConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-metadataconfig): Human-readable agent identity.
- [`models.ModelConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-modelconfig): Configuration for one model role.
- [`models.RelayAtifConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayatifconfig): NeMo Relay ATIF export configuration.
- [`models.RelayAtofConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayatofconfig): NeMo Relay ATOF export configuration.
- [`models.RelayAtofFileSinkConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayatoffilesinkconfig): NeMo Relay ATOF file sink configuration.
- [`models.RelayAtofStreamSinkConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayatofstreamsinkconfig): NeMo Relay ATOF stream sink configuration.
- [`models.RelayComponentConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relaycomponentconfig): Generic NeMo Relay plugin component configuration.
- [`models.RelayConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayconfig): First-class NeMo Relay integration configuration.
- [`models.RelayConfigPolicy`](/nemo/fabric/reference/api/python-library-reference/models#class-relayconfigpolicy): NeMo Relay config validation policy.
- [`models.RelayHttpStorageConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayhttpstorageconfig): NeMo Relay ATIF HTTP storage configuration.
- [`models.RelayObservabilityConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayobservabilityconfig): NeMo Relay observability component configuration.
- [`models.RelayOtlpConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relayotlpconfig): NeMo Relay OTLP export configuration for OpenTelemetry/OpenInference.
- [`models.RelayS3StorageConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-relays3storageconfig): NeMo Relay ATIF S3 storage configuration.
- [`models.RunRequest`](/nemo/fabric/reference/api/python-library-reference/models#class-runrequest): One validated NeMo Fabric invocation request.
- [`models.RuntimeConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-runtimeconfig): Invocation runtime contract.
- [`models.SkillConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-skillconfig): Skill capability configuration.
- [`models.TelemetryConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-telemetryconfig): Telemetry configuration.
- [`models.TelemetryProviderConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-telemetryproviderconfig): Provider-specific telemetry configuration.
- [`models.ToolsConfig`](/nemo/fabric/reference/api/python-library-reference/models#class-toolsconfig): Harness-neutral tool capability configuration.
- [`types.AdapterInfo`](/nemo/fabric/reference/api/python-library-reference/types#class-adapterinfo): Resolved adapter identity attached to a run plan.
- [`types.ArtifactManifest`](/nemo/fabric/reference/api/python-library-reference/types#class-artifactmanifest): Normalized collection of artifacts produced by a run.
- [`types.ArtifactRef`](/nemo/fabric/reference/api/python-library-reference/types#class-artifactref): Reference to one artifact produced by a run.
- [`types.DoctorCheck`](/nemo/fabric/reference/api/python-library-reference/types#class-doctorcheck): One diagnostic check in a ``DoctorReport``.
- [`types.DoctorReport`](/nemo/fabric/reference/api/python-library-reference/types#class-doctorreport): Aggregate preflight diagnostics for a resolved run plan.
- [`types.ErrorInfo`](/nemo/fabric/reference/api/python-library-reference/types#class-errorinfo): Structured failure returned inside a normalized ``RunResult``.
- [`types.FabricEvent`](/nemo/fabric/reference/api/python-library-reference/types#class-fabricevent): One normalized lifecycle or invocation event.
- [`types.RunOutput`](/nemo/fabric/reference/api/python-library-reference/types#class-runoutput): Normalized adapter output.
- [`types.RunPlan`](/nemo/fabric/reference/api/python-library-reference/types#class-runplan): Immutable execution plan produced before a runtime is started.
- [`types.RunResult`](/nemo/fabric/reference/api/python-library-reference/types#class-runresult): Normalized terminal result from one NeMo Fabric invocation.
- [`types.RuntimeCapabilities`](/nemo/fabric/reference/api/python-library-reference/types#class-runtimecapabilities): Operations declared by the resolved runtime and adapter.
- [`types.RuntimeHandle`](/nemo/fabric/reference/api/python-library-reference/types#class-runtimehandle): Opaque identity and binding for one started runtime.
- [`types.TelemetryRef`](/nemo/fabric/reference/api/python-library-reference/types#class-telemetryref): Reference to external or persisted telemetry for a run.
- [`errors.FabricCapabilityError`](/nemo/fabric/reference/api/python-library-reference/errors#class-fabriccapabilityerror): Operation rejected by resolved runtime capabilities or implementation status.
- [`errors.FabricConfigError`](/nemo/fabric/reference/api/python-library-reference/errors#class-fabricconfigerror): Invalid SDK input, request shape, factory, or resolved config.
- [`errors.FabricError`](/nemo/fabric/reference/api/python-library-reference/errors#class-fabricerror): Base class for structured SDK-level NeMo Fabric errors.
- [`errors.FabricNativeUnavailableError`](/nemo/fabric/reference/api/python-library-reference/errors#class-fabricnativeunavailableerror): SDK call requires the PyO3 extension, but it is not installed or importable.
- [`errors.FabricRuntimeError`](/nemo/fabric/reference/api/python-library-reference/errors#class-fabricruntimeerror): Failure while starting, invoking, stopping, or otherwise driving a runtime.
- [`errors.FabricStateError`](/nemo/fabric/reference/api/python-library-reference/errors#class-fabricstateerror): Operation rejected because a local runtime is in the wrong state.

## Functions

- No functions


---

_This file was automatically generated via [lazydocs](https://github.com/ml-tooling/lazydocs)._