The CUPTI Python Release Notes include new features, important bug fixes, known issues, supported platforms, and supported GPUs.
Refer CUPTI C 13.2.0 release notes.
New Features
The cupti.cupti.CallbackDomain.NVTX callback domain is now supported.
The cupti.cupti.CallbackData.function_params field of cupti.cupti.CallbackData is now supported.
New Activity kinds and classes:
cupti.cupti.ActivityKind.GRAPH_HOST_NODE with cupti.cupti.ActivityGraphHostNode
cupti.cupti.ActivityKind.COMPUTE_ENGINE_CTX_SWITCH with cupti.cupti.ActivityComputeEngineCtxSwitch
cupti.cupti.ActivityKind.GREEN_CONTEXT with cupti.cupti.ActivityGreenContext
cupti.cupti.ActivityKind.HOST_LAUNCH with cupti.cupti.ActivityHostLaunch
New activity classes: cupti.cupti.ActivityKernel11, cupti.cupti.ActivityContext4, cupti.cupti.ActivityMarkerData2, cupti.cupti.ActivityDevice6
Support for Python 3.14 has been added.
Deprecated and dropped features
Dropped activity classes: cupti.cupti.ActivityKernel10, cupti.cupti.ActivityContext3, cupti.cupti.ActivityMarkerData, cupti.cupti.ActivityDevice5
Support for Python 3.9 has been dropped.
Refer CUPTI C 13.0.1 release notes.
New Features
Relaxed nvidia-cuda-cupti dependency: cupti-python now supports nvidia-cuda-cupti versions >=13.0.0 and <14.
Relaxed cuda-bindings dependency: cupti-python now supports cuda-bindings versions >=13.0.0 and <14.
Refer CUPTI C 13.0.0 release notes.
New Features
New Activity Kind cupti.cupti.ActivityKind.ROTATION and its corresponding activity class cupti.cupti.ActivityConfidentialComputeRotation has been added.
Support for Activity Kind cupti.cupti.ActivityKind.RUNTIME and Callback Domain cupti.cupti.CallbackDomain.RUNTIME_API have been added.
New activity classes cupti.cupti.ActivityKernel10 and cupti.cupti.ActivityMemoryPool3 have been introduced.
Support for APIs cupti.cupti.subscribe_v2(), cupti.cupti.activity_enable_cuda_event_device_timestamps() and cupti.cupti.activity_enable_all_sync_records() has been added.
Added cupti.pyi stub file to improve IDE support, including type hints and auto-completion.
Support for Python 3.13 has been added.
Support for Linux (aarch64 sbsa) architecture has been added.
Deprecated and dropped features
Support for activity classes cupti.cupti.ActivityKernel9 and cupti.cupti.ActivityMemoryPool2 has been removed.
Refer CUPTI C 12.8.0 release notes.
New Features
New Activity Kind cupti.cupti.ActivityKind.MEM_DECOMPRESS and its corresponding activity class cupti.cupti.ActivityMemDecompress has been added.
New Activity Kind cupti.cupti.ActivityKind.DEVICE_GRAPH_TRACE and its corresponding activity class cupti.cupti.ActivityDeviceGraphTrace has been added.
New activity classes cupti.cupti.ActivityMemcpy6, cupti.cupti.ActivityUnifiedMemoryCounter3, cupti.cupti.ActivityCudaEvent2 and cupti.cupti.ActivitySynchronization2 have been introduced.
Support for API cupti.cupti.activity_enable_hw_trace() has been added.
Deprecated and dropped features
Support for activity classes cupti.cupti.ActivityMemcpy5, cupti.cupti.ActivityUnifiedMemoryCounter2, cupti.cupti.ActivityCudaEvent and cupti.cupti.ActivitySynchronization has been removed.
This was the first CUPTI Python release. Refer CUPTI C 12.6.0 release notes.
Libraries like NCCL that emit NVTX annotations with extended payloads can now be decoded using CUPTI; however, this capability is not yet supported in CUPTI Python.
CUPTI Python cannot collect tracing data when the Python interpreter is tearing down or is not in a proper state. The callbacks registered by functions cupti.cupti.activity_register_callbacks(), cupti.cupti.activity_register_timestamp_callback(), cupti.cupti.subscribe(), and cupti.cupti.subscribe_v2() will not be dispatched in such cases. For example, CUDA API calls that occur in a class’s __del__ method will not be traced.
Information on supported python versions, platforms, and GPUs.
Python 3.10 - 3.14
Linux (x86_64)
Linux (aarch64 sbsa)
Turing and later GPU architectures, i.e. devices with compute capability 7.5 and higher.