Install with pip

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 if needed.

• pip available and pointing to the right Python. Check with:

  LinuxWindows

  which pip
  

  If it points to a Conda or system path, see Removing Conda before continuing.

Create a Virtual Environment

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

LinuxWindows

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

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

Install HOOPS AI

CPU

LinuxWindows

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)

LinuxWindows

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 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 main install page.

Verify the Installation

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

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

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 main install page.