.. SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
.. SPDX-License-Identifier: Apache-2.0

*******************************************************
cuda-pathfinder: Utilities for locating CUDA components
*******************************************************

.. image:: https://img.shields.io/badge/NVIDIA-black?logo=nvidia
   :target: https://www.nvidia.com/
   :alt: NVIDIA

`cuda.pathfinder <https://nvidia.github.io/cuda-python/cuda-pathfinder/>`_
aims to be a one-stop solution for locating CUDA components. Currently
it supports locating and loading dynamic libraries (``.so``, ``.dll``), and
locating CTK header directories. Support for other artifacts is in progress.

* `Documentation <https://nvidia.github.io/cuda-python/cuda-pathfinder/>`_
* `Releases <https://nvidia.github.io/cuda-python/cuda-pathfinder/latest/release.html>`_
* `Repository <https://github.com/NVIDIA/cuda-python/tree/main/cuda_pathfinder/>`_
* `Issue tracker <https://github.com/NVIDIA/cuda-python/issues/>`_ (select component ``cuda.pathfinder``)

``cuda.pathfinder`` is under active development. Feedback and suggestions are welcome.


Installation
============

.. code-block:: bash

   pip install cuda-pathfinder

``cuda-pathfinder`` is `CUDA Toolkit (CTK) <https://developer.nvidia.com/cuda-toolkit>`_
version-agnostic. It follows the general CUDA Toolkit support policy: the
two most recent major versions are supported simultaneously.
