> This page is for NeMo Fabric, version Latest (v0.7.0) (default).
> For other versions, use one of these documentation indexes:
> - Latest (v0.7.0) (default): https://docs.nvidia.com/nemo/fabric/latest/llms.txt
> - dev: https://docs.nvidia.com/nemo/fabric/dev/llms.txt
> - v0.7.0: https://docs.nvidia.com/nemo/fabric/v0.7.0/llms.txt
> - v0.6.1: https://docs.nvidia.com/nemo/fabric/v0.6.1/llms.txt
> - v0.6.0: https://docs.nvidia.com/nemo/fabric/v0.6.0/llms.txt
> - v0.5.0: https://docs.nvidia.com/nemo/fabric/v0.5.0/llms.txt
> - v0.4.0: https://docs.nvidia.com/nemo/fabric/v0.4.0/llms.txt
> - v0.3.0: https://docs.nvidia.com/nemo/fabric/v0.3.0/llms.txt
> - v0.2.0: https://docs.nvidia.com/nemo/fabric/v0.2.0/llms.txt
> - v0.1.1: https://docs.nvidia.com/nemo/fabric/v0.1.1/llms.txt
> - v0.1.0: https://docs.nvidia.com/nemo/fabric/v0.1.0/llms.txt

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

# Install a Harness Adapter

> Install a ready-made NeMo Fabric adapter and the dependencies required by its harness.

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

| Your setup                                                            | Installation guide                                                                                                                    |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| New local environment with the runtime, adapter, and harness together | [Install a Complete Runtime and Harness](/nemo/fabric/getting-started/installation/adapters#runtime-and-adapter-together)             |
| Application runtime and harness in separate Python environments       | [Install an Adapter and Harness Without the Runtime](/nemo/fabric/getting-started/installation/adapters#separate-python-environments) |
| Harness already installed in an environment you manage                | [Add an Adapter to an Existing Harness Environment](/nemo/fabric/getting-started/installation/adapters#existing-harness-environment)  |

For example, the following command installs the NeMo Fabric runtime, the Deep Agents adapter, and its supported harness dependencies together:

```bash
python -m pip install 'nemo-fabric[deepagents]'
```

The [complete installation guide](/nemo/fabric/getting-started/installation/adapters#runtime-and-adapter-together) 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](/nemo/fabric/integrations/harness-integrations/overview) 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:

```bash
pip install "nemo-fabric[claude]"
pip install "nemo-fabric[codex]"
pip install "nemo-fabric[deepagents]"
pip install "nemo-fabric[mini-swe-agent]"
pip install "nemo-fabric[nooa]"
pip install "nemo-fabric[openclaw]"
pip install "nemo-fabric[openhands]"
```

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:

```bash
pip install "nemo-fabric[claude,harbor,relay]"
```

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](/nemo/fabric/integrations/harness-integrations/open-hands).

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](/nemo/fabric/getting-started/installation/hermes), [Cline](/nemo/fabric/getting-started/installation/cline), [Factory Droid](/nemo/fabric/getting-started/installation/droid), and [Kiro](/nemo/fabric/getting-started/installation/kiro).

Continue with your selected [harness integration guide](/nemo/fabric/integrations/harness-integrations/overview) to configure and run a task. The [Quickstart](/nemo/fabric/getting-started/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](/nemo/fabric/integrations/harness-integrations/overview) 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:

```bash
pip install "nemo-fabric-adapters-claude[harness]"
pip install "nemo-fabric-adapters-codex[harness]"
pip install "nemo-fabric-adapters-deepagents[harness]"
pip install "nemo-fabric-adapters-nooa[harness]"
```

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:

```bash
export ADAPTER_PYTHON="/path/to/adapter-environment/bin/python"
```

On Windows, use the adapter environment's Python executable:

```powershell
$env:ADAPTER_PYTHON = "C:\path\to\adapter-environment\Scripts\python.exe"
```

Use matching NeMo Fabric release versions for the runtime and adapter unless a different pairing has been validated.

Return to the [Installation Overview](/nemo/fabric/getting-started/install) to compare deployment scenarios.

## Existing Harness Environment

Connect a harness you already manage to NVIDIA NeMo Fabric by installing its [harness adapter](/nemo/fabric/integrations/harness-integrations/overview), 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:

```bash
pip install nemo-fabric-adapters-claude
pip install nemo-fabric-adapters-codex
pip install nemo-fabric-adapters-deepagents
pip install nemo-fabric-adapters-hermes
pip install nemo-fabric-adapters-nooa
pip install nemo-fabric-adapters-openclaw
pip install nemo-fabric-adapters-openhands
```

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:

```bash
pip install nemo-fabric nemo-fabric-adapters-codex
```

For a separate runtime interpreter, follow [Install an Adapter and Harness Without the Runtime](/nemo/fabric/getting-started/installation/adapters#separate-python-environments). Use your selected harness's integration guide to configure and run a task from the runtime environment.

## Installation Instructions for Every Supported Harness

| Harness               | Installation instructions                                                                                                               |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Code           | [Install the Claude Code adapter](/nemo/fabric/integrations/harness-integrations/claude-code#install-the-adapter)                       |
| Cline                 | [Install the Cline adapter](/nemo/fabric/integrations/harness-integrations/cline#install-cline-and-the-adapter)                         |
| Codex                 | [Install the Codex adapter](/nemo/fabric/integrations/harness-integrations/codex#install-the-adapter)                                   |
| Factory Droid         | [Install the Factory Droid adapter](/nemo/fabric/integrations/harness-integrations/factory-droid#install-droid-the-sdk-and-the-adapter) |
| Hermes Agent          | [Install the Hermes Agent adapter](/nemo/fabric/integrations/harness-integrations/hermes-agent#install-the-adapter)                     |
| Kilo Code             | [Install the Kilo Code adapter](/nemo/fabric/integrations/harness-integrations/kilo-code#install-the-adapter)                           |
| AWS Kiro              | [Install the AWS Kiro adapter](/nemo/fabric/integrations/harness-integrations/kiro#install-kiro-and-the-adapter)                        |
| AWS Strands           | [Install the AWS Strands adapter](/nemo/fabric/integrations/harness-integrations/aws-strands)                                           |
| LangChain Deep Agents | [Install the LangChain Deep Agents adapter](/nemo/fabric/integrations/harness-integrations/lang-chain-deep-agents#install-the-adapter)  |
| mini-SWE-agent        | [Install the mini-SWE-agent adapter](/nemo/fabric/integrations/harness-integrations/mini-swe-agent#install-the-adapter)                 |
| NOOA                  | [Install the NOOA adapter](https://github.com/NVIDIA/NeMo-Fabric/tree/v0.7.0/adapters/python/nooa#install)                              |
| OpenClaw              | [Install the OpenClaw adapter](/nemo/fabric/integrations/harness-integrations/open-claw#install-openclaw-and-the-adapter)               |
| OpenHands             | [Install the OpenHands adapter](/nemo/fabric/integrations/harness-integrations/open-hands#install-the-adapter)                          |
| OpenCode              | [Install the OpenCode adapter](/nemo/fabric/integrations/harness-integrations/open-code#install-the-adapter)                            |
| Pi                    | [Install the Pi adapter](/nemo/fabric/integrations/harness-integrations/pi#install-the-adapter)                                         |
| Qwen Code             | [Install the Qwen Code adapter](/nemo/fabric/integrations/harness-integrations/qwen-code#install-the-adapter)                           |
| Remote Agent          | [Install the Remote Agent adapter](/nemo/fabric/integrations/harness-integrations/remote-agent#install-the-adapter)                     |

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](/nemo/fabric/about-nemo-fabric/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:

```bash
pip install "nemo-fabric[harbor]"
```

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](/nemo/fabric/integrations/consumer-integrations/harbor) for details.

## Configure Your Harness

After installation, use [Harness Integrations](/nemo/fabric/integrations/harness-integrations/overview) for configuration and usage, and [Harness Compatibility](/nemo/fabric/sdk/configure-agents#normalized-configuration-compatibility) to compare supported features. The [Quickstart](/nemo/fabric/getting-started/quickstart/overview) guides you through a first run.

For an unsupported or custom agent, use the [Adapter Contract](/nemo/fabric/adapter-contract/overview) to build an adapter instead.