Native Installation

This installation method will download the Python package from PyPI, installing it natively on your system. This will provide optimal hardware acceleration support.

Tip

We recommend to use the uv package manager for maximum installation speed, both in production and development environments. We also recommend to use Python 3.12, which is easy to select when using uv. Using a Python virtualenv to isolate yourself from the system Python is obligatory.

Setup

uv venv --python 3.12
source .venv/bin/activate
uv pip install --compile-bytecode nauscopia

Alternatively, you can also use pipx to install the package user-wide,

pipx install nauscopia

If you need to install pipx or uv, either check how to install it on your operating system (e.g. apt install pipx), or try pip install pipx resp. pipx install uv.

Runtime

Afterward, please install Nauscopia’s runtime dependencies, e.g. machine learning models and other assets.

nauscopia install

Synopsis

nauscopia --version