Chenjie LuoandClaude Opus 5 14b20c0a12 [skill] evaluation: add GDPVal (NeMo Gym Stirrup agent) support (#2039)
### What does this PR do?

Type of change: new feature (agent skill)

Adds GDPVal support to the `evaluation` agent skill. GDPVal is an
agentic AA
benchmark: the NeMo Gym "Stirrup" agent produces office/PDF deliverables
inside a
per-task Apptainer code-exec sandbox, and a judge panel scores them. It
runs on the
0.2.6 launcher as a `nemo_gym` task, but it is **standalone** (one gym
eval per
config) and mechanically unlike the `aa/` nemo-skills tasks, so it gets
its own
branch in the skill rather than being merged into the `aa/` task list.

- `recipes/tasks/aa_gym/gdpval.md` — task recipe: standalone rule,
rubric-vs-comparison
  scoring, canary, score extraction.
- `references/gym-gdpval.md` — the machinery: Apptainer SIF sandbox, the
`_gym_prepare` venv-repair / process-group-reap workaround, deployment
sizing,
scoring modes, the MLflow deliverables trap, canary failure modes, and
the
  SIF ↔ Gym-version rebuild coupling.
- `recipes/examples/gym_gdpval/` — self-contained SLURM + vLLM template
plus the
co-located `_gym_prepare.yaml` Hydra include (it must travel with the
config).
- `scripts/gdpval-sif.sh` — build-if-absent / reuse-if-present Apptainer
SIF helper.
Builds on the target cluster only (never copies across clusters),
flock-guarded and
  atomic, driven by `$GDPVAL_SIF_DIR`.
- `SKILL.md` / `references/quantization-benchmarks.md` — GDPVal is part
of the AA
suite but a different harness, so it is generated as a companion
standalone config.
- `recipes/env.example` — `TAVILY_API_KEY` (agent web search) and
`GDPVAL_SIF_DIR`.

### Usage

```bash
# 1. Set GDPVAL_SIF_DIR in .env, then build the sandbox once on the target cluster
#    (build-if-absent, reuse-if-present):
srun -p cpu -t 01:00:00 --pty .agents/scripts/gdpval-sif.sh

# 2. Copy the whole example dir (the _gym_prepare.yaml include must travel with it),
#    fill in the ??? values, then dry-run -> canary -> full:
nel run --config gym_gdpval/example_gym_gdpval.yaml --dry-run
```

### Testing

Validated end-to-end on an aarch64 GB300 SLURM cluster with an NVFP4 MoE
checkpoint:
deploy → SIF build + sandboxed exec → gym head server → 220 rollouts +
deliverables →
judge scoring, producing a real rubric score with zero judge failures.
Several traps
found during that run are now documented in the reference (silent
unsandboxed
fallback, gym-commit/head-server hang, judge api-key value-vs-name, SIF
↔ Gym version
coupling, `limit_samples` not limiting gym rollouts).

### Before your PR is "*Ready for review*"

- Is this change backward compatible?: ✅
- If you copied code from any other sources or added a new PIP
dependency, did you follow guidance in `CONTRIBUTING.md`: N/A
- Did you write any new necessary tests?: N/A (agent skill documentation
+ helper script; no library code)
- Did you update
[Changelog](https://github.com/NVIDIA/Model-Optimizer/blob/main/CHANGELOG.rst)?:
N/A (agent skill only, no API change)
- Did you get Claude approval on this PR?: ❌ (not yet run)

### Additional Information

Docs/skill-only change under `.agents/`; no `modelopt/` source is
touched.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Added standalone GDPVal evaluation support through NeMo Gym, with
Slurm, vLLM, sandbox, judge, reasoning, sampling, and logging
configuration.
- Added automated Apptainer/Singularity image setup with reuse,
validation, locking, and reliable publishing.
- Added configurable settings for judge services, web search, and shared
image caching.
- Added GDPVal preparation and execution examples, including dry-run,
canary, and full-run guidance.

- **Documentation**
- Added GDPVal setup, troubleshooting, scoring, deployment, and
quantization guidance.
- Clarified separate GDPVal configuration, mandatory thinking mode, and
repeat-count requirements.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Signed-off-by: Chenjie Luo <chenjiel@nvidia.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 15:10:16 -07:00
2026-07-09 12:54:24 +05:30

Banner image

NVIDIA Model Optimizer

Documentation version license

Documentation | Roadmap


NVIDIA Model Optimizer (referred to as Model Optimizer, or ModelOpt) is a library comprising state-of-the-art model optimization techniques including quantization, pruning, Neural Architecture Search (NAS), distillation, speculative decoding and sparsity to accelerate models.

[Input] Model Optimizer currently supports inputs of a Hugging Face, PyTorch or ONNX model.

[Optimize] Model Optimizer provides Python APIs for users to easily compose the above model optimization techniques and export an optimized quantized checkpoint. Model Optimizer is also integrated with NVIDIA Megatron-Bridge, Megatron-LM and Hugging Face Accelerate for training required inference optimization techniques.

[Export for deployment] Seamlessly integrated within the NVIDIA AI software ecosystem, the quantized checkpoint generated from Model Optimizer is ready for deployment in downstream inference frameworks like SGLang, TensorRT-LLM, TensorRT, or vLLM. The unified Hugging Face export API now supports both transformers and diffusers models.

Latest News

Previous News

Install

To install stable release packages for Model Optimizer with pip from PyPI:

pip install -U nvidia-modelopt[all]

Model Optimizer will download and install additional third-party open source software projects. Review the license terms of these open source projects before use.

To install from source in editable mode with all development dependencies or to use the latest features, run:

# Clone the Model Optimizer repository
git clone git@github.com:NVIDIA/Model-Optimizer.git
cd Model-Optimizer

pip install -e .[dev]

You can also directly use NVIDIA container images, which have Model Optimizer pre-installed:

  • nvcr.io/nvidia/pytorch:<version>-py3
  • nvcr.io/nvidia/nemo:<version>
  • nvcr.io/nvidia/tensorrt-llm/release:<version>

Before pulling and using the container images, please review their respective license terms. Make sure to upgrade Model Optimizer to the latest version as described above. Visit our installation guide for more fine-grained control on installed dependencies or for alternative docker images and environment variables to setup.

Techniques

Technique Description Examples Docs
Post Training Quantization Compress model size by 2x-4x, speeding up inference while preserving model quality! [HF LLMs / VLMs] [Megatron-Bridge LLMs / VLMs] [Diffusers] [ONNX] [Windows] [docs]
Quantization Aware Training / Distillation Refine accuracy of quantized models even further with a few training steps! [Hugging Face] [Megatron-Bridge] [docs]
Pruning Reduce your model parameters or memory footprint and accelerate inference by removing unnecessary weights! [General] [Megatron-Bridge]
Distillation Reduce deployment model size by teaching small models to behave like larger models! [Hugging Face] [Megatron-Bridge] [Megatron-LM] [docs]
Speculative Decoding Train draft modules to predict extra tokens during inference! [Hugging Face] [Megatron-LM] [docs]
Sparsity Efficiently compress your model by storing only its non-zero parameter values and their locations [Hugging Face] [docs]

Pre-Quantized Checkpoints

Resources

Model Support Matrix

Model Type Support Matrix
LLM / VLM Quantization View Support Matrix
Diffusers Quantization View Support Matrix
ONNX Quantization View Support Matrix
Windows Quantization View Support Matrix
Quantization Aware Training View Support Matrix
Pruning View Support Matrix
Distillation View Support Matrix
Speculative Decoding View Support Matrix

Deprecation Policy

Model Optimizer follows a structured approach to managing deprecated features:

  • Communication: Deprecation notices are documented in the Changelog. Deprecated items include source code statements indicating deprecation timing, with runtime warnings issued upon use.
  • Migration Period: Since Model Optimizer is still pre-1.0, we provide a 1-release (~1-month) migration period after deprecation. During this window, deprecated features continue functioning while issuing warnings.
  • Scope: The policy addresses both complete deprecations (entire APIs removed) and partial ones (specific parameters removed while methods remain).
  • Removal: Following the migration period, deprecated elements are removed in alignment with semantic versioning standards, potentially including breaking changes in minor version updates while Model Optimizer remains in 0.x.

Citation

If you use NVIDIA Model Optimizer in your research, please cite it as follows:

@misc{nvidia-modelopt,
  author       = {{NVIDIA Corporation}},
  title        = {{NVIDIA Model Optimizer}},
  howpublished = {\url{https://github.com/NVIDIA/Model-Optimizer}},
  year         = {2024--2026},
  note         = {GitHub repository}
}

Contributing

Model Optimizer is now open source! We welcome any feedback, feature requests and PRs. Please read our Contributing guidelines for details on how to contribute to this project.

AI Agents

For AI-assisted development setup, see the agent tooling notes.

Top Contributors

Contributors

Happy optimizing!

S
Description
GitHub Trending: NVIDIA/Model-Optimizer
Readme Multiple Licenses
1.2 GiB
Languages
Python 97.3%
Shell 1.3%
Cuda 0.8%
Jinja 0.3%
C++ 0.2%