Skip to navigation

Development Setup and Building from Source

View as MarkdownOpen in Claude

Use a source checkout when developing NVIDIA NeMo Fabric. For ordinary application usage, prefer the package installation routes.

git clone https://github.com/NVIDIA/NeMo-Fabric.git
cd NeMo-Fabric

Build From Source

Prerequisites:

  • Rust and Cargo
  • Python 3.11 through 3.14
  • Node.js 22.19.0 or later with npm
  • uv
  • just 1.50.0+
  1. Create a Python virtual environment and activate it (replace 3.13 with your preferred Python version):
uv venv -p 3.13 --seed .venv
source .venv/bin/activate
  1. Build the Rust core, Python libraries, and TypeScript packages.
just build-all

The above command will install only those dependencies that are strictly necessary for the build. Alternately If you want to install all optional dependencies, you can run:

uv sync --all-groups --all-extras

Then run the build command with the no_uv=true flag to avoid re-installing the dependencies:

This path installs every local Python package, including NOOA, which requires Python 3.12 or 3.13. Use one of those versions for the all-packages build.

just no_uv=true build-all

Optional Hermes Agent Development

If you are developing or testing the Hermes adapter, install Hermes Agent separately:

just install-hermes-agent

This step is not required for the general build. Refer to Install the Hermes Agent adapter for its additional requirements.

Follow the full contribution guide for current repository setup and toolchain requirements.