-
Notifications
You must be signed in to change notification settings - Fork 36
Nano V2 VLM Blog #111
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
ywang96
merged 14 commits into
vllm-project:main
from
chrisalexiuk-nvidia:nano-2-vlm-blog
Oct 31, 2025
+112
−0
Merged
Nano V2 VLM Blog #111
Changes from all commits
Commits
Show all changes
14 commits
Select commit
Hold shift + click to select a range
392bbeb
Nano V2 VLM Blog
chrisalexiuk-nvidia 02ad989
Merge branch 'main' into nano-2-vlm-blog
chrisalexiuk-nvidia 8d24821
Nano V2 VLM Blog
chrisalexiuk-nvidia 93ea815
Merge branch 'nano-2-vlm-blog' of github.com:chrisalexiuk-nvidia/vllm…
chrisalexiuk-nvidia e0ef491
update
ywang96 e7626f9
update
ywang96 194b929
add activation
ywang96 8230019
clean up
ywang96 a1edfd4
Update _posts/2025-10-29-run-multimodal-reasoning-agents-nvidia-nemot…
ywang96 05d18cc
Update _posts/2025-10-29-run-multimodal-reasoning-agents-nvidia-nemot…
ywang96 2f090f1
Update _posts/2025-10-29-run-multimodal-reasoning-agents-nvidia-nemot…
ywang96 1662ee5
add
ywang96 56723df
update date and add recipe link
ywang96 c9ac55f
update link
ywang96 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
112 changes: 112 additions & 0 deletions
112
_posts/2025-10-31-run-multimodal-reasoning-agents-nvidia-nemotron.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,112 @@ | ||
| --- | ||
| layout: post | ||
| title: "Run Multimodal Reasoning Agents with NVIDIA Nemotron on vLLM" | ||
| author: "NVIDIA Nemotron Team" | ||
| --- | ||
|
|
||
| We are excited to release [NVIDIA Nemotron Nano 2 VL](https://huggingface.co/nvidia/Nemotron-Nano-12B-v2-VL-BF16), supported by vLLM. This open vision language model ([VLM](https://www.nvidia.com/en-us/glossary/vision-language-models/)) is built for video understanding and document intelligence. | ||
|
|
||
| Nemotron Nano 2 VL uses a hybrid Transformer–Mamba design and delivers higher throughput while maintaining state-of-the-art multimodal reasoning accuracy. The model also features [**Efficient Video Sampling (EVS)**](https://arxiv.org/abs/2510.14624), a new technique that reduces redundant [tokens](https://blogs.nvidia.com/blog/ai-tokens-explained/) generation for video workloads, allowing processing of more videos with higher efficiency. | ||
|
|
||
| In this blog post, we’ll explore how Nemotron Nano 2 VL advances video understanding and document intelligence, showcase real-world use cases and benchmark results, and guide you through getting started with vLLM for inference to unlock high-efficiency multimodal AI at scale. | ||
|
|
||
| ## Leading multimodal model for efficient video understanding and document intelligence | ||
|
|
||
| NVIDIA Nemotron Nano 2 VL brings both video understanding and document intelligence capabilities together in a single, highly efficient model. Built on the hybrid Transformer–Mamba architecture, it combines the reasoning strength of Transformer models with the compute efficiency of Mamba, achieving high throughput and low latency, allowing it to process multi-image inputs faster. | ||
|
|
||
| Trained on NVIDIA-curated, high-quality multimodal data, [Nemotron Nano 2 VL](https://huggingface.co/blog/nvidia/nemotron-vlm-dataset-v2) leads in video understanding and document intelligence benchmarks such as MMMU, MathVista, AI2D, OCRBench, OCRBench-v2, OCR-Reasoning, ChartQA, DocVQA, and Video-MME, delivering top-tier accuracy in multimodal [reasoning](https://www.nvidia.com/en-us/glossary/ai-reasoning/), character recognition, chart reasoning, and visual question answering. This makes it ideal for building multimodal applications that automate data extraction and comprehension across videos, documents, forms, and charts with enterprise-grade precision. | ||
|
|
||
|
|
||
| <p align="center"> | ||
| <picture> | ||
| <img src="/assets/figures/2025-multimodal-nvidia-nemotron/figure1.png" width="100%"> | ||
| </picture> | ||
| <br> | ||
| Figure 1: Nemotron Nano 2 VL provides leading accuracy on various video understanding and document intelligence benchmarks | ||
| </p> | ||
|
|
||
| ### Improving Efficiency with EVS | ||
| With EVS, the model achieves higher throughput and faster response times without sacrificing accuracy. EVS technique prunes redundant frames, preserving semantic richness while enabling longer video processing efficiently. As a result, enterprises can analyze hours of footage, from meetings and training sessions to customer calls, in minutes, gaining actionable insights faster and at lower cost. | ||
|
|
||
|
|
||
| <p align="center"> | ||
| <picture> | ||
| <img src="/assets/figures/2025-multimodal-nvidia-nemotron/figure2.png" width="100%"> | ||
| </picture> | ||
| <br> | ||
| Figure 2: Accuracy trend of the Nemotron Nano 2 VL model across various token-drop thresholds using efficient video sampling on Video-MME and LongVideo benchmarks | ||
| </p> | ||
|
|
||
| ## About Nemotron Nano 2 VL | ||
|
|
||
| * Architecture: | ||
| * [CRADIOH-V2](https://huggingface.co/nvidia/C-RADIOv2-H) based Vision Encoder | ||
| * Efficient video sampling as token compression module | ||
| * Hybrid Transformer-Mamba Architecture - [Nemotron Nano 2 LLM](https://huggingface.co/nvidia/NVIDIA-Nemotron-Nano-9B-v2) backbone with reasoning. | ||
| * Accuracy: | ||
| * Leading accuracy on OCRBench v2 | ||
| * 74 on average score (compared to 64.2 with current top VL model) on the following benchmarks: MMMU, MathVista, AI2D, OCRBench, OCRBench-v2, OCR-Reasoning, ChartQA, DocVQA, and Video-MME | ||
| * Model size: 12B | ||
| * Context length: 128k | ||
| * Model input: Multi-image documents, videos, text | ||
| * Model output: Text | ||
| * Get started: | ||
| * Download model weights from Hugging Face \- [BF16](https://huggingface.co/nvidia/Nemotron-Nano-12B-v2-VL-BF16), [FP8](https://huggingface.co/nvidia/Nemotron-Nano-12B-v2-VL-FP8), [FP4-QAD](https://huggingface.co/nvidia/Nemotron-Nano-12B-v2-VL-FP4-QAD) | ||
| * Run with vLLM for inference | ||
| * [Technical report](https://research.nvidia.com/labs/adlr/files/NVIDIA-Nemotron-Nano-V2-VL-report.pdf) to build custom, optimized models with Nemotron techniques.. | ||
|
|
||
| ## Run optimized inference with vLLM | ||
|
|
||
| This guide demonstrates how to run Nemotron Nano 2 VL on vLLM, achieving accelerated [inference](https://www.nvidia.com/en-us/glossary/ai-inference/) and serving concurrent requests efficiently with BF16, FP8 and FP4 precision support. | ||
|
|
||
| ### Install vLLM | ||
|
|
||
| The support for Nemotron Nano 2 VL is available in the nightly version of vLLM. Run the command below to install vLLM: | ||
| ```bash | ||
| uv venv | ||
| source .venv/bin/activate | ||
| uv pip install vllm --extra-index-url https://wheels.vllm.ai/nightly --prerelease=allow | ||
| ``` | ||
|
|
||
|
|
||
| ### Deploy and query the inference server | ||
| Deploy an OpenAI-compatible inference server with vLLM by running the following commands for BF16, FP8 and FP4 precision: | ||
|
|
||
| ```bash | ||
| vllm serve nvidia/Nemotron-Nano-12B-v2-VL-BF16 --trust-remote-code --dtype bfloat16 --video-pruning-rate 0 | ||
|
|
||
| # FP8 | ||
| vllm serve nvidia/Nemotron-Nano-VL-12B-V2-FP8 --trust-remote-code --quantization modelopt --video-pruning-rate 0 | ||
|
|
||
| # FP4 | ||
| vllm serve nvidia/Nemotron-Nano-VL-12B-V2-FP4-QAD --trust-remote-code --quantization modelopt_fp4 --video-pruning-rate 0 | ||
| ``` | ||
|
|
||
| Once the server is up and running, you can prompt the model using the below code snippet: | ||
|
|
||
| ```python | ||
| from openai import OpenAI | ||
| client = OpenAI(base_url="http://localhost:8000/v1", api_key="null") | ||
| # Simple chat completion | ||
| resp = client.chat.completions.create( | ||
| model="nvidia/Nemotron-Nano-12B-v2-VL-BF16", | ||
| messages=[ | ||
| {"role": "system", "content": "/no_think"}, | ||
| {"role": "user", "content": [ | ||
| {"type": "text", "text": "Give me 3 interesting facts about this image."}, | ||
| {"type": "image_url", "image_url": {"url": "https://blogs.nvidia.com/wp-content/uploads/2025/08/gamescom-g-assist-nv-blog-1280x680-1.jpg"} | ||
| } | ||
| ]}, | ||
| ], | ||
| temperature=0.0, | ||
| max_tokens=1024, | ||
| ) | ||
| print(resp.choices[0].message.content) | ||
| ``` | ||
|
|
||
| For more examples, check out our [vLLM cookbook](https://github.com/NVIDIA-NeMo/Nemotron/blob/main/usage-cookbook/Nemotron-Nano2-VL/vllm_cookbook.ipynb) and [vLLM recipe for Nemotron Nano 2 VL](https://docs.vllm.ai/projects/recipes/en/latest/NVIDIA/Nemotron-Nano-12B-v2-VL.html). | ||
|
|
||
|
|
||
| [*Share your ideas*](http://nemotron.ideas.nvidia.com/?ncid=so-othe-692335) *and vote on what matters to help shape the future of Nemotron.* | ||
|
|
||
| *Stay up to date on [NVIDIA Nemotron](https://developer.nvidia.com/nemotron) by subscribing to NVIDIA news and following NVIDIA AI on [LinkedIn](https://www.linkedin.com/showcase/nvidia-ai/posts/?feedView=all), [X](https://x.com/NVIDIAAIDev), [YouTube](https://www.youtube.com/@NVIDIADeveloper)*, *and the [Nemotron channel](https://discord.com/channels/1019361803752456192/1407781691698708682) on [Discord](https://discord.com/invite/nvidiadeveloper).* | ||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
ywang96 marked this conversation as resolved.
Show resolved
Hide resolved
|
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.