Installation

View as Markdown

Requirements

  • Python 3.12 or 3.13
  • An OpenAI-compatible model endpoint (NVIDIA API Catalog, vLLM, NIM, etc.)

Install from Source

$git clone https://github.com/NVIDIA-NeMo/Evaluator.git
$cd Evaluator
$pip install -e ".[all]"

Install Extras

ExtraCommandWhat it adds
scoringpip install -e ".[scoring]"sympy for symbolic math comparison
statspip install -e ".[stats]"scipy for confidence intervals, McNemar significance testing, and regression analysis
skillspip install -e ".[skills]"NeMo Skills benchmark integration
harborpip install -e ".[harbor]"Harbor agent integration (OpenHands, Terminus-2, etc.)
lm-evalpip install -e ".[lm-eval]"LM-Evaluation-Harness integration
inspectpip install -e ".[inspect]"Inspect AI log export (inspect_ai-compatible EvalLog files)
raypip install -e ".[ray]"Ray distributed launcher
harnessespip install -e ".[harnesses]"lm-evaluation-harness tasks
exportpip install -e ".[export]"WandB and MLflow experiment tracker export
docspip install -e ".[docs]"Sphinx, NVIDIA theme, mermaid for building docs
allpip install -e ".[all]"Common runtime integrations: scoring, stats, ray, lm-eval, and Harbor
devpip install -e ".[dev]"pytest, ruff, and common development extras

Verify Installation

$nel --version
$nel list

Expected output:

nemo-evaluator 0.12.0
Built-in benchmarks:
drop nel eval run --bench drop
gpqa nel eval run --bench gpqa
gsm8k nel eval run --bench gsm8k
...

Docker

$docker build -t nemo-evaluator .
$docker run nemo-evaluator nel list

Next Steps

Proceed to the Quickstart to run your first evaluation.