Installation¶
In this section, we provide instructions on how to install OTVision on the most common Operating Systems.
Before installing OTVision, make sure your system meets all requirements. Essentially, you need uv to be installed.
Install OTVision¶
We provide install scripts for the most common operating systems.
Download and unzip the latest version of OTVision from GitHub or clone the OTVision repository.
Inside the unzipped folder open the install.cmd and wait until the
installation of the dependencies is complete.
In a terminal, navigate to the OTVision folder and run the installer.
./install.sh
The installation of the dependencies could take a moment.
What is installed here?
The install script will create a virtual environment (.venv)
and install the Python packages specified in the pyproject.toml via uv
from the Python Package Index.
Nvidia CUDA (optional)¶
If you have a
Windows or Linux PC with a Nvidia graphics card
and already installed CUDA,
you chose the release with the suffix -cuda. It contains the requirements to use CUDA.
If you want to contribute to OTVision and use CUDA, you have to perform additional
steps in your Terminal/Command Prompt:
Check CUDA version¶
Check if CUDA is recognized and available.
nvcc --version
Navigate to the OTVision root directory.
cd "path/to/OTVision"
Where is the OTVision root directory?
It's the folder you downloaded und unzipped.
Maybe your OTVision root directory is called OTVision-main after unzipping,
if you downloaded it from Github. This is the correct directory.
Inside the OTVision root directory, there is another directory called OTVision
(this child directory is the wrong directory).
Install torch and torchvision for CUDA¶
If you downloaded a -cuda release, you are good to go, if the CUDA version
in the pyproject.toml matches your system.
To install another version you can do so following the PyTorch documentation:
Depending on your operating system (Windows or Linux) and your CUDA version you can select, copy and run the install command from the PyTorch site under "INSTALL PYTORCH" (choose Build="Stable", Package="pip" and Language="Python"), then adapt the command to use uv.
E.g., for CUDA 12.8 and the latest stable PyTorch Build, the command is:
uv pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/cu128
If you encounter problems¶
Maybe you also have to install Microsoft Visual C++ 14.0 or greater from the Visual Studio Build Tools.
In case of further problems please open an issue in the OTVision repository on GitHub or contact us. We are happy to know about your experience.
Contribute¶
We welcome code contributions (e.g., fixing bugs or adding features) from others by forking the repository and creating a pull request. Please check the contribute section of this documentation first.
If you want to contribute code, additional requirements should be installed
in the virtual environment.
Clone the OTVision repository
from GitHub. Run the install_dev.sh in your OTVision folder
and wait until the installation of the dependencies is complete.