- 
                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
          
     Open
      
      
            chrisalexiuk-nvidia
  wants to merge
  14
  commits into
  vllm-project:main
  
    
      
        
          
  
    
      Choose a base branch
      
     
    
      
        
      
      
        
          
          
        
        
          
            
              
              
              
  
           
        
        
          
            
              
              
           
        
       
     
  
        
          
            
          
            
          
        
       
    
      
from
chrisalexiuk-nvidia:nano-2-vlm-blog
  
      
      
   
  
    
  
  
  
 
  
      
    base: main
Could not load branches
            
              
  
    Branch not found: {{ refName }}
  
            
                
      Loading
              
            Could not load tags
            
            
              Nothing to show
            
              
  
            
                
      Loading
              
            Are you sure you want to change the base?
            Some commits from the old base branch may be removed from the timeline,
            and old review comments may become outdated.
          
          
      
        
          +112
        
        
          −0
        
        
          
        
      
    
  
  
     Open
                    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.