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

# NVIDIA NeMo Fabric Quickstart

> Get started with NVIDIA NeMo Fabric.

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:

```bash
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](/nemo/fabric/getting-started/install) 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`](https://build.nvidia.com/).

## Run a Simple Agent

```python
import asyncio

from nemo_fabric import (
    Fabric,
    FabricConfig,
    HarnessConfig,
    MetadataConfig,
    ModelConfig,
    RuntimeConfig,
)

config = FabricConfig(
    metadata=MetadataConfig(name="quickstart-agent"),
    harness=HarnessConfig(
        adapter_id="nvidia.fabric.hermes",
        resolution="preinstalled",
    ),
    runtime=RuntimeConfig(max_turns=1),
    models={
        "default": ModelConfig(
            provider="nvidia",
            model="nvidia/nemotron-3-nano-omni-30b-a3b-reasoning",
            api_key_env="NVIDIA_API_KEY",
            base_url="https://integrate.api.nvidia.com/v1",
        )
    },
)

result = asyncio.run(Fabric().run(config, input="Who are you?"))
print(result.output.response)
```

A more detailed version of this example is available as a [Jupyter Notebook](https://jupyter.org/)
at [`examples/notebooks/01_quickstart.ipynb`](https://github.com/NVIDIA/NeMo-Fabric/blob/0.1.0/examples/notebooks/01_quickstart.ipynb).

## Next Steps

* [Python SDK](/nemo/fabric/sdk/python-sdk)