```{eval-rst}
.. _installation:
```

## Installation

### Automatic installation (recommended)
You can install _autorino_ using the `pip` package manager.
```bash
pip install git+https://github.com/IPGP/autorino.git
```

### Developper installation 

Clone the _autorino_ repository. 
```bash
git clone https://github.com/IPGP/autorino.git
```
And then install _autorino_ using the `pip` package manager in [developement mode](https://setuptools.pypa.io/en/latest/userguide/development_mode.html). 
```bash
cd autorino
pip install -e .
```

### Setting up the environment

You need to set up the environment variables `$AUTORINO_DIR` & `$AUTORINO_ENV` 
to describe _autorino_'s environment.

In your `.bashrc` or `.bash_profile` file, add the following lines:
```bash
export AUTORINO_DIR="/home/user/path_to/autorino/"
export AUTORINO_ENV="${AUTORINO_DIR}/configfiles/main/autorino_main_cfg.yml"
```

`AUTORINO_DIR` is the path to the _autorino_ repository. (and __not__ the path to second `autorino` subfolder, 
which is the python code itself).  

The _environment_ configuration file defined with `AUTORINO_ENV` is a YAML file that contains an `environement` section.
It defines the paths to the different GNSS raw data converters, described in the next section, 
and diverses environment parameters.
Usually, it is the _main_ configuration file (which also contains the default parameters of autorino's workflow steps, see next chapter).,
but the _environment_ section can be defined in a dedicated configuration file.  

If `$AUTORINO_ENV` is not set, _autorino_ will use the default values.  
Per defaults values assume that the converter executables are known by your system (e.g. set in your `$PATH`).  

_NB_: The default values are in a configuration file located in the package's `configfiles/env/` folder.