Skip to navigation

Installation Overview

View as MarkdownOpen in Claude

Install the NVIDIA NeMo Fabric runtime and an adapter for your chosen harness. Some harnesses require a separate installation. For a guided first run, follow the Quickstart.

Requirements and Supported Platforms

Python 3.11–3.14. Linux (x86_64, arm64), macOS (arm64), and Windows (x86_64). Hermes Agent v0.22.7 requires Python 3.14; OpenHands and Harbor require 3.12+. Check your harness guide for additional requirements.

Some harness adapters also require Node.js or Bun and separately installed SDKs or CLIs. Follow your harness-specific installation instructions for the required versions.

Compare capabilities on Supported Harnesses; use adapter installation for setup instructions.

Deployment Scenarios

ScenarioWhat runs whereInstallation route
Shared environmentRuntime, adapter, and harness togetherComplete setup or existing harness
Separate environmentsRuntime launches the adapter environment’s PythonAdapter and harness
Isolated taskRuntime, adapter, and harness in the task environmentHarbor or Environments

Choose an Installation

What each package installs. ✅ means the package installs the component; — means the package does not install it. Install the component separately if required. These are representative combinations; adapter installation covers the available routes.

InstallationRuntimeCollectorAdapterHarnessRelay PythonRelay CLI
nemo-fabric✅—————
nemo-fabric[streaming]✅✅————
nemo-fabric[relay]✅———✅—
nemo-fabric[hermes-agent]✅—✅———
nemo-fabric[hermes-agent] plus nemo-fabric-adapters-hermes[relay]✅—✅—✅—
nemo-fabric-adapters-claude[harness]——✅✅—✅
nemo-fabric-adapters-claude[full]——✅✅—✅
nemo-fabric-adapters-deepagents[full]——✅✅✅—
nemo-fabric-adapters-mini-swe-agent[full]——✅✅✅—
nemo-fabric-adapters-nooa[full]——✅✅✅—
nemo-fabric-adapters-openclaw——✅———
nemo-fabric-adapters-openhands——✅———
nemo-fabric-adapters-hermes[full]——✅—✅—
nemo-fabric-adapters-hermes[relay]——✅—✅—
nemo-fabric-adapters-claude——✅———

An adapter’s full extra does not install the NeMo Fabric runtime; its contents vary by adapter. Hermes Agent must be installed separately. Refer to Install a Harness Adapter for setup options and dedicated adapter guides.

Use matching runtime and adapter releases unless another combination has been validated. For Hermes telemetry, use the adapter’s relay extra. Hermes v0.22.7 uses Relay 0.11; v0.22.5 remains supported with Relay 0.10.

Inspect Adapter Metadata Without Harness SDKs

For the optional catalog package and descriptor lookup example, refer to Inspect Adapter Metadata.

Next Steps

Install the runtime.

Install a harness adapter.

NeMo Relay and streaming dependencies.

Development setup and building from source.

For package names, refer to Packages and Distribution.