##############################
Install with pip
##############################

.. sidebar::

    .. contents::
        :local:
        :depth: 2

This page covers installing HOOPS AI into a standard Python virtual environment using ``pip``.

Prerequisites
=============

* **Python 3.12** installed on your system. Check with ``python --version``. Download from `python.org <https://www.python.org/downloads/>`__ if needed.
* ``pip`` available and pointing to the right Python. Check with:

  .. tabs::

     .. group-tab:: Linux

        .. code-block:: bash

           which pip

     .. group-tab:: Windows

        .. code-block:: powershell

           where pip

  If it points to a Conda or system path, see :doc:`Removing Conda <remove_conda>` before continuing.

Create a Virtual Environment
============================

Create a ``.venv`` folder in your project directory and activate it:

.. tabs::

   .. group-tab:: Linux

      .. code-block:: bash

         python3.12 -m venv .venv
         source .venv/bin/activate

   .. group-tab:: Windows

      .. code-block:: powershell

         py -3.12 -m venv .venv
         .venv\Scripts\Activate.ps1

After activation, ``which python`` (Linux) or ``where python`` (Windows) should point inside ``.venv``.

Install HOOPS AI
================

CPU
---

.. tabs::

   .. group-tab:: Linux

      .. code-block:: bash

         pip install "hoops-ai[all]" \
             --extra-index-url https://packages.techsoft3d.com/pip \
             --extra-index-url https://download.pytorch.org/whl/cpu

   .. group-tab:: Windows

      .. code-block:: powershell

         pip install "hoops-ai[all]" `
             --extra-index-url https://packages.techsoft3d.com/pip `
             --extra-index-url https://download.pytorch.org/whl/cpu

GPU (CUDA 13.0)
---------------

.. tabs::

   .. group-tab:: Linux

      .. code-block:: bash

         pip install "hoops-ai[all]" \
             --extra-index-url https://packages.techsoft3d.com/pip \
             --extra-index-url https://download.pytorch.org/whl/cu130

   .. group-tab:: Windows

      .. code-block:: powershell

         pip install "hoops-ai[all]" `
             --extra-index-url https://packages.techsoft3d.com/pip `
             --extra-index-url https://download.pytorch.org/whl/cu130

``cu130`` corresponds to CUDA 13.0, which is the configuration HOOPS AI is tested against. If you need a different CUDA version, replace ``cu130`` with the appropriate tag. The `PyTorch installation page <https://pytorch.org/get-started/locally/>`__ lists all available index tags for each PyTorch release.

.. note::

    ``hoops-ai[all]`` installs the full stack including CAD access, ML, visualization, notebooks, and the converter. If you only need a subset, see the Extras table on the :doc:`main install page <evaluate>`.

Verify the Installation
========================

.. code-block:: bash

    python -c "import hoops_ai; print(hoops_ai.__version__)"

For a GPU environment, also confirm PyTorch sees your GPU:

.. code-block:: bash

    python -c "import torch; print(torch.__version__, torch.cuda.is_available())"

Next Step
=========

If you plan to use notebooks, register your virtual environment as a Jupyter kernel. See **Registering the Jupyter Kernel** on the :doc:`main install page <evaluate>`.