Installation Overview
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
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.
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
NeMo Relay and streaming dependencies.
Development setup and building from source.
For package names, refer to Packages and Distribution.