Install with uv

uv is a fast Python package and environment manager. It can download the right Python version for you, so you do not need Python 3.12 pre-installed.

Install uv

Install uv system-wide. This is a one-time step.

LinuxWindows

curl -LsSf https://astral.sh/uv/install.sh | sh

Then restart your terminal, or run:

source ~/.local/bin/env

Verify the install:

uv --version

Create a Virtual Environment

uv can download Python 3.12 automatically if it is not already present:

LinuxWindows

uv venv .venv --python 3.12 --seed
source .venv/bin/activate

The --seed flag installs pip and setuptools into the environment so you can use pip inside it.

Install HOOPS AI

With the environment activated, use uv pip to install. uv pip always targets the active virtual environment, regardless of any system or Conda paths.

Note

The --index-strategy unsafe-best-match flag is required. By default, uv stops at the first index where a package name is found and never checks the others. Without this flag, packages like hoops-ai or PyTorch GPU wheels that only exist on the extra indexes would be missed or resolved from the wrong source. This flag makes uv check all indexes and pick the best available version, matching the behaviour of pip.

CPU

LinuxWindows

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

GPU (CUDA 13.0)

LinuxWindows

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

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.