(install-native)=
# 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
```shell
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,
```shell
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.
```shell
nauscopia install
```

## Synopsis
```shell
nauscopia --version
```


[uv package manager]: https://docs.astral.sh/uv/