Install a Harness Adapter
NVIDIA NeMo Fabric provides ready-made adapters for supported agent harnesses. An adapter translates NeMo Fabric configuration, requests, and results for a particular harness, the agent software that performs your task. Install the adapter and its required harness dependencies; you do not need to write an adapter to use a supported harness.
Choose an Installation Option
For example, the following command installs the NeMo Fabric runtime, the Deep Agents adapter, and its supported harness dependencies together:
The complete installation guide lists other Python harness extras. Use matching NeMo Fabric runtime and adapter releases unless another combination has been validated.
Runtime and Adapter Together
Prepare one Python environment to run agent tasks through NVIDIA NeMo Fabric. A harness integration connects NeMo Fabric to the agent that executes your tasks; this guide installs the runtime and a selected adapter with its supported dependencies. Some harnesses also require a separate installation, as described below.
Choose the command for your harness. Use a nemo-fabric harness extra when the runtime, adapter, and harness run in the same Python environment:
The root extras install the dependencies selected for each adapter. Some include
the harness; OpenClaw, OpenHands, and Hermes require separate harness installation
as described in the individual harness guides. You can combine independent nemo-fabric extras. For
example, on Python 3.12 or later, the following command also installs Harbor; the Claude harness extra
supplies the Relay CLI, while relay supplies the Relay Python package:
The NOOA extra supports Python 3.12 and 3.13 only. On another supported Python version, the command can succeed while its environment marker omits the NOOA adapter.
The OpenClaw extra installs its adapter and HTTP client, but not OpenClaw.
Install the openclaw npm package separately before using that adapter.
OpenHands requires Python 3.12 or later. The root extra installs the adapter
but not OpenHands. Install the supported openhands-sdk and openhands-tools
packages separately as described in the
OpenHands adapter guide.
The Claude and Codex harness extras install the nemo-relay CLI required for
Relay-enabled runs. The root relay extra installs only the Relay Python
package for SDK-native integrations.
Use the dedicated guides for Hermes Agent, Cline, Factory Droid, and Kiro.
Continue with your selected harness integration guide to configure and run a task. The Quickstart provides a complete Deep Agents walkthrough.
Separate Python Environments
Prepare an adapter and harness in a Python environment separate from the NVIDIA NeMo Fabric runtime. The harness adapter translates NeMo Fabric configuration and requests for the agent that executes your tasks. Use this route to isolate the harness’s dependencies while your application runs NeMo Fabric in another locally accessible environment.
Choose the command for your harness. Use an adapter package’s harness extra when a different environment runs NeMo Fabric:
This installation mode keeps the runtime dependencies out of the adapter
environment. Set ADAPTER_PYTHON in the runtime environment to the adapter
environment’s Python interpreter. A Python adapter and its Python harness must
use the same interpreter. Use matching NeMo Fabric
release versions for the runtime and adapter package unless a different pairing
has been explicitly validated.
The OpenClaw adapter does not provide harness or full extras. Install
nemo-fabric-adapters-openclaw directly and install the openclaw npm package
separately.
The OpenHands adapter also omits harness and full extras. Install the bare
adapter and the supported OpenHands packages separately.
Select the Adapter Environment
The NeMo Fabric runtime and agent harness can run in separate, locally accessible Python environments. This scenario isolates their Python dependencies while the runtime launches the adapter through the adapter environment’s interpreter.
Install nemo-fabric in the runtime environment. Install the adapter and harness in the second environment, then set ADAPTER_PYTHON in the runtime environment:
On Windows, use the adapter environment’s Python executable:
Use matching NeMo Fabric release versions for the runtime and adapter unless a different pairing has been validated.
Return to the Installation Overview to compare deployment scenarios.
Existing Harness Environment
Connect a harness you already manage to NVIDIA NeMo Fabric by installing its harness adapter, the integration that translates NeMo Fabric requests into calls to that agent. Use this route to keep your existing compatible harness installation while adding NeMo Fabric support.
Choose the command for your harness. Install an adapter package without an extra when the environment already supplies and manages a compatible harness:
Bare adapter distributions install only adapter-owned dependencies. They do not install the NeMo Fabric runtime or the harness.
If the existing harness and runtime share an environment, install the runtime and bare adapter together. The following example preserves the existing Codex SDK instead of installing the adapter’s supported SDK version:
For a separate runtime interpreter, follow Install an Adapter and Harness Without the Runtime. Use your selected harness’s integration guide to configure and run a task from the runtime environment.
Installation Instructions for Every Supported Harness
The dedicated Hermes, Cline, Factory Droid, and Kiro pages cover additional setup. They are part of the complete supported adapter catalog above. Compare capabilities on Supported Harnesses.
An adapter package’s full extra applies to the adapter environment; it does not install the NeMo Fabric runtime. For Claude and Codex, full and harness install the supported harness and NeMo Relay CLI. For Deep Agents and mini-SWE-agent, full installs the harness and Relay Python package. For Hermes, it installs Relay dependencies but not Hermes Agent itself.
Isolated Task Environment
The host application constructs and serializes the final typed FabricConfig. It then runs NeMo Fabric, the selected adapter, and the harness inside an isolated task environment such as a Docker container or sandbox. Adapter discovery and task-path resolution occur inside that environment.
Harbor uses this model. Use Python 3.12 or later in the host environment; on Python 3.11, the environment marker omits Harbor even when the extra is requested. Install its integration in the host environment:
Install NeMo Fabric, the selected adapter, and the harness in the task environment. For a Hermes Agent task, install Hermes Agent according to its installation guide, then add nemo-fabric and nemo-fabric-adapters-hermes. For Relay support, install nemo-fabric-adapters-hermes[relay] so the adapter’s Relay dependencies are included.
Relay-enabled Claude, Codex, or Pi tasks also require the adapter-compatible NeMo Relay CLI in the task environment. Pi additionally requires its matching Relay extension. Refer to the Harbor integration guide for details.
Configure Your Harness
After installation, use Harness Integrations for configuration and usage, and Harness Compatibility to compare supported features. The Quickstart guides you through a first run.
For an unsupported or custom agent, use the Adapter Contract to build an adapter instead.