Text Generation
Transformers
Safetensors
PyTorch
English
nemotron_h
nvidia
nemotron-3
latent-moe
mtp
conversational
custom_code
Instructions to use nvidia/Nemotron-3-Labs-Ultra-Math-RL with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use nvidia/Nemotron-3-Labs-Ultra-Math-RL with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="nvidia/Nemotron-3-Labs-Ultra-Math-RL", trust_remote_code=True) messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("nvidia/Nemotron-3-Labs-Ultra-Math-RL", trust_remote_code=True) model = AutoModelForCausalLM.from_pretrained("nvidia/Nemotron-3-Labs-Ultra-Math-RL", trust_remote_code=True, device_map="auto") messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=256) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use nvidia/Nemotron-3-Labs-Ultra-Math-RL with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "nvidia/Nemotron-3-Labs-Ultra-Math-RL" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nvidia/Nemotron-3-Labs-Ultra-Math-RL", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/nvidia/Nemotron-3-Labs-Ultra-Math-RL
- SGLang
How to use nvidia/Nemotron-3-Labs-Ultra-Math-RL with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "nvidia/Nemotron-3-Labs-Ultra-Math-RL" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nvidia/Nemotron-3-Labs-Ultra-Math-RL", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "nvidia/Nemotron-3-Labs-Ultra-Math-RL" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nvidia/Nemotron-3-Labs-Ultra-Math-RL", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use nvidia/Nemotron-3-Labs-Ultra-Math-RL with Docker Model Runner:
docker model run hf.co/nvidia/Nemotron-3-Labs-Ultra-Math-RL
File size: 9,235 Bytes
0aa1573 8571329 6849d3e 8571329 0aa1573 6849d3e 0aa1573 6849d3e 0aa1573 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 | ---
library_name: transformers
license: other
license_name: openmdw-1.1
license_link: >-
https://openmdw.ai/license/1-1/
pipeline_tag: text-generation
language:
- en
base_model:
- nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16
base_model_relation: finetune
datasets:
- nvidia/Nemotron-Math-Proofs-v3-RL
tags:
- nvidia
- pytorch
- nemotron-3
- latent-moe
- mtp
track_downloads: true
---
# Nemotron-3-Labs-Ultra-Math-RL
*Referred to as Nemotron-3-Ultra-RL in the technical report.*
## Description
Nemotron-3-Labs-Ultra-Math-RL is a decoder-only transformer language model specialized for mathematical reasoning, trained to solve difficult mathematical problems and identify mistakes in proofs, and deployed as part of an ensemble system that achieved a gold-medal level score at the International Mathematical Olympiad 2026.
Full details can be found at our technical report [An Open Recipe for IMO Gold: Training Nemotron for Olympiad Mathematics](https://arxiv.org/abs/2609.10712).
Nemotron-3-Labs-Ultra-Math-RL was developed by NVIDIA as a part of Nemotron.
This model is ready for commercial and non-commercial use.
### License/Terms of Use
Governing Download Terms: Use of this model is governed by the [OpenMDW License Agreement, version 1.1](https://raw.githubusercontent.com/OpenMDW/OpenMDW/refs/heads/main/1.1/LICENSE.OpenMDW-1.1) (OpenMDW-1.1).
### Deployment Geography
Global
### Use Case
Researchers and developers focused on AI-driven mathematical reasoning and proof verification, aiming to advance open models for solving complex math problems and improving reasoning capabilities.
### Release Date
**HuggingFace:** September 3, 2026 via https://huggingface.co/collections/nvidia/nemotron-labs-imo-2026
## Reference(s)
* [An Open Recipe for IMO Gold: Training Nemotron for Olympiad Mathematics](https://arxiv.org/abs/2609.10712) (technical report)
* [nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16)
* [nvidia/Nemotron-Math-Proofs-v3-RL](https://huggingface.co/datasets/nvidia/Nemotron-Math-Proofs-v3-RL)
* [nvidia/Nemotron-IMO-Bench](https://huggingface.co/datasets/nvidia/Nemotron-IMO-Bench)
* Inference pipeline and submitted proofs: https://github.com/NVIDIA-NeMo/Skills/tree/main/recipes/nemotron-imo-tts
* RL training recipe: https://github.com/NVIDIA-NeMo/RL/blob/imo-26-ultra-v3/docs/guides/nemotron-3-ultra-imo.md
## Model Architecture
**Architecture Type:** Mamba2-Transformer Hybrid Latent Mixture of Experts (LatentMoE) with Multi-Token Prediction (MTP)
**Network Architecture:** Nemotron Hybrid LatentMoE
**This model was developed based on [nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16).**
**Number of model parameters:** 550B Total / 55B Active
## Input
**Input Type(s):** Text
**Input Format(s):** String
**Input Parameters:** One-Dimensional (1D)
**Other Properties Related to Input:** Maximum context length up to 1M tokens
## Output
**Output Type(s):** Text
**Output Format:** String
**Output Parameters:** One-Dimensional (1D)
**Other Properties Related to Output:** Maximum context length up to 1M tokens
Our AI models are designed and/or optimized to run on NVIDIA GPU-accelerated systems. By leveraging NVIDIA's hardware (e.g. GPU cores) and software frameworks (e.g., CUDA libraries), the model achieves faster training and inference times compared to CPU-only solutions.
## Software Integration
**Runtime Engine(s):** vLLM
**Supported Hardware Microarchitecture Compatibility:**
* NVIDIA Blackwell
* NVIDIA Hopper
**Supported Operating System(s):** Linux
The integration of foundation and fine-tuned models into AI systems requires additional testing using use-case-specific data to ensure safe and effective deployment. Following the V-model methodology, iterative testing and validation at both unit and system levels are essential to mitigate risks, meet technical and functional requirements, and ensure compliance with safety and ethical standards before deployment.
## Model Version(s)
Nemotron-3-Labs-Ultra-Math-RL v1
## Deployment
The Ultra BF16 checkpoint is a frontier-scale model. The minimum recommended hardware is:
* **Single-node:** 8× B200 (≈1.5 TB aggregate HBM — fits BF16 weights plus KV cache with headroom)
* **Multi-node:** ≥8 GPUs across H100 / H200 / GB200 / GB300, orchestrated with Ray v2
For more detailed information, please see the [nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16) model card and [this cookbook](https://github.com/NVIDIA-NeMo/Nemotron/blob/main/usage-cookbook/Nemotron-3-Ultra/vllm_cookbook.ipynb).
Recommended container: `vllm/vllm-openai:v0.22.0`.
```shell
export MODEL_CKPT=PATH/TO/MODEL/CHECKPOINT
```
**8× B200 single-node deployment:**
```shell
docker run -d --name nemotron-ultra-vllm \
--gpus all \
--ipc=host \
--network=host \
--shm-size=16g \
--ulimit memlock=-1 \
--ulimit stack=67108864 \
-v $MODEL_CKPT:/model:ro \
-e VLLM_WORKER_MULTIPROC_METHOD=spawn \
-e SAFETENSORS_FAST_GPU=1 \
-e NVIDIA_TF32_OVERRIDE=1 \
-e VLLM_LOGGING_LEVEL=INFO \
vllm/vllm-openai:v0.22.0 \
/model \
--host 0.0.0.0 \
--port 8000 \
--served-model-name nvidia/Nemotron-3-Labs-Ultra-Math-RL \
--trust-remote-code \
--tensor-parallel-size 8 \
--enable-expert-parallel \
--dtype bfloat16 \
--max-model-len 262144 \
--gpu-memory-utilization 0.90 \
--max-num-seqs 16 \
--max-num-batched-tokens 32768 \
--enable-chunked-prefill \
--enable-prefix-caching \
--reasoning-parser nemotron_v3 \
--enable-auto-tool-choice \
--tool-call-parser qwen3_coder \
--mamba-ssm-cache-dtype float16 \
--mamba-backend flashinfer \
--enable-mamba-cache-stochastic-rounding \
--mamba-cache-philox-rounds 5 \
--speculative-config '{"method": "nemotron_h_mtp", "num_speculative_tokens": 5}' \
--model-loader-extra-config '{"enable_multithread_load": true, "num_threads": 96}'
```
Context length defaults to 256k above. To use up to 1M, set `VLLM_ALLOW_LONG_MAX_MODEL_LEN=1` and `--max-model-len 1048576`.
## Training, Testing, and Evaluation Datasets
### Training Dataset
**Data Modality:** Text
**Text Training Data Size:** 9,597 proof-generation prompts (50,430,007 bytes)
**Data Collection Method by dataset:** Hybrid: Automated, manually-collected, Synthetic
**Labeling Method by dataset:** Hybrid: Automated, manually-labeled, Synthetic
**Properties (Quantity, Dataset Descriptions, Sensor(s)):** Nemotron-Math-Proofs-v3-RL is a long-form mathematical reasoning dataset for reinforcement learning. The release contains 9,597 proof-generation prompts. The dataset uses [NeMo Gym](https://github.com/NVIDIA-NeMo/gym)-compatible, single-turn user prompts derived from hard proof problems in the [AoPS](https://artofproblemsolving.com/) subset of [nvidia/Nemotron-Math-Proofs-v1](https://huggingface.co/datasets/nvidia/Nemotron-Math-Proofs-v1). The `train` split asks the policy to produce a rigorous solution and self-evaluation. Policy responses and realized rewards are generated during training and are not stored in the file. See [nvidia/Nemotron-Math-Proofs-v3-RL](https://huggingface.co/datasets/nvidia/Nemotron-Math-Proofs-v3-RL).
### Testing Dataset
**Data Collection Method by dataset:** Hybrid: Automated, manually-collected, Synthetic<br>
**Labeling Method by dataset:** Hybrid: Automated, manually-labeled, Synthetic<br>
**Properties (Quantity, Dataset Descriptions, Sensor(s)):** This corpus comprises only benchmarks for assessing the quality of mathematical proof generation and verification.
### Evaluation Dataset
**Benchmark Score:** As part of an ensemble system, this model achieved a gold-medal-level score at the International Mathematical Olympiad 2026. Additional evaluation results are available in the [Accompanying Tech Report](https://arxiv.org/abs/2609.10712).
**Data Collection Method by dataset:** Hybrid: Automated, manually-collected, Synthetic<br>
**Labeling Method by dataset:** Hybrid: Automated, manually-labeled, Synthetic<br>
**Properties (Quantity, Dataset Descriptions, Sensor(s)):** This corpus comprises only benchmarks for assessing the quality of mathematical proof generation and verification.
## Inference
**Acceleration Engine:** vLLM, PyTorch
**Hardware Requirements (GPU Architecture, Model):**
* NVIDIA Ampere - A100 80 GB
* NVIDIA Hopper - H100
## Ethical Considerations
NVIDIA believes Trustworthy AI is a shared responsibility and we have established policies and practices to enable development for a wide array of AI applications. Developers should work with their internal model team to ensure this model meets requirements for the relevant industry and use case and addresses unforeseen product misuse.
For more detailed information on ethical considerations for this model, please see the Model Card++ [Explainability](./explainability.md), [Bias](./bias.md), [Safety & Security](./safety.md), and [Privacy](./privacy.md) Subcards.
Please report model quality, risk, security vulnerabilities or NVIDIA AI Concerns [here](https://www.nvidia.com/en-us/support/submit-security-vulnerability/).
|