sglang_v0.5.2/pytorch_2.8.0/third_party/NVTX/python/README.md

nvtx Python package

Installation

Install using conda:

conda install -c conda-forge nvtx

...or using pip:

python -m pip install nvtx

Quick start

1. Annotate the parts of your Python code you wish to profile/analyze:

   # demo.py
   
   import time
   import nvtx
   
   @nvtx.annotate(color="blue")
   def my_function():
       for i in range(5):
           with nvtx.annotate("my_loop", color="red"):
               time.sleep(i)
   
   my_function()
   

2. Use NVIDIA Nsight Systems to collect profile data:

   nsys profile -t nvtx python demo.py
   

3. Visualize the results using the Nsight systems GUI:

   

Documentation

See here for detailed docs.

Release Notes

0.2.12

• Expose API via domain object for better performance.
• No-OP when domain is disabled.
• Improved documentation.