NVIDIA NeMo Fabric Quickstart

This guide demonstrates how to install and run a simple agent using NeMo Fabric.

Install NeMo Fabric

Using Python 3.11 through 3.13, create a virtual environment and install the NeMo Fabric runtime, Hermes Agent adapter, and supported Hermes Agent dependencies:

$
python -m venv .venv
$
source .venv/bin/activate
$
pip install "nemo-fabric[hermes-agent]"

If the environment already manages Hermes Agent, install the runtime and bare adapter with pip install nemo-fabric nemo-fabric-adapters-hermes. Refer to the installation guide for separate adapter environments and the other supported package combinations.

Obtaining API Keys

The following code example uses an NVIDIA-hosted model and requires an NVIDIA API key defined with the NVIDIA_API_KEY environment variable. An API key can be obtained by creating an account on build.nvidia.com.

Run a Simple Agent

1
import asyncio
2
3
from nemo_fabric import (
4
    Fabric,
5
    FabricConfig,
6
    HarnessConfig,
7
    MetadataConfig,
8
    ModelConfig,
9
    RuntimeConfig,
10
)
11
12
config = FabricConfig(
13
    metadata=MetadataConfig(name="quickstart-agent"),
14
    harness=HarnessConfig(
15
        adapter_id="nvidia.fabric.hermes",
16
        resolution="preinstalled",
17
    ),
18
    runtime=RuntimeConfig(max_turns=1),
19
    models={
20
        "default": ModelConfig(
21
            provider="nvidia",
22
            model="nvidia/nemotron-3-nano-omni-30b-a3b-reasoning",
23
            api_key_env="NVIDIA_API_KEY",
24
            base_url="https://integrate.api.nvidia.com/v1",
25
        )
26
    },
27
)
28
29
result = asyncio.run(Fabric().run(config, input="Who are you?"))
30
print(result.output.response)

A more detailed version of this example is available as a Jupyter Notebook at examples/notebooks/01_quickstart.ipynb.

Next Steps

• Python SDK