Skip to main content

Installation

Proprietary Software

The HV Explorer and HV SDK are proprietary tools developed internally by qtec, and are therefore only free to use in conjuction with qtec's cameras and/or HSI data acquired using qtec's cameras.

Help us improve the HV Explorer

Starting in version 0.3.0, anonymous error reporting via Sentry has been included. This helps the team identify and fix crashes before they affect your workflow.

In this release this feature is always enabled, but the next release will include a toggle for allowing users to enable or disable telemetry as desired.

  • What we collect: Only crash reports and system-level errors (e.g., OS version, stack traces).

  • What we DON'T collect: Your files, personal data, or IP addresses.

The installation files (of all released versions) are available at the HV Explorer release server.

Follow the guides below for detailed information about installing on specific systems.

Windows​

Simply download windows-installer.exe and follow the instructions.

Linux​

installation script​

The installation script automatically performs all the steps described below in the uv section.

You can use curl to download the script and execute it with bash:

curl -LsSf https://gitlab.com/qtec/public/hv-explorer/-/releases/permalink/latest/downloads/install.sh | bash

If your system doesn't have curl, you can use wget:

wget -qO- https://gitlab.com/qtec/public/hv-explorer/-/releases/permalink/latest/downloads/install.sh | bash

uv​

uv can install/update the package directly from the repository.

Manual installation

We strongly recommend using the full install script described above instead of following the manual steps described below.

You need to have the tool installed, then run:

uv tool install qtec-hv-explorer@latest --index https://gitlab.com/api/v4/projects/67863505/packages/pypi/simple --index https://gitlab.com/api/v4/projects/75709056/packages/pypi/simple --index-strategy unsafe-best-match --no-cache

To create an application shortcut, copy HV-Explorer.desktop and hv-explorer.svg to the appropriate locations or use the example commands below:

cp "$INSTALLATION_PATH/HV-Explorer.desktop" "$HOME/.local/share/applications/"
sudo cp "$INSTALLATION_PATH/hv-explorer.svg" /usr/share/icons/hv-explorer.svg
tip

The INSTALLATION_PATH is normally at $HOME/.local/share/uv/tools/qtec-hv-explorer/lib/python$PYTHON_VERSION/site-packages/hsi_viewer/resources.