(installation)=
# Installation and Configuration

## Setting up Python

If you are experienced with Python and installing packages, go to the [next section](#pip_install).

If you are new to Python, we recommend using [Anaconda](https://www.anaconda.com/download) - see the [Anaconda guide](https://docs.anaconda.com/free/anaconda/install/) for more information. Anaconda may be available at your institution through your IT provider - **note we do not offer support for installing Anaconda/Python**.

If you're using Anaconda, run the following command in your Anaconda enabled terminal to install the `pip` package manager.

:::{code-block} bash
    conda install pip
:::

(pip_install)=
## Installation

The `orto` Python package and its command line interface can be installed using the `pip` package manager

:::{code-block} bash
    pip install orto
:::

To test your installation was successful, run the following command

:::{code-block} bash
    orto -h
:::

You should see the help text for `orto`. You are now ready to start using `orto`, head to the [guide](#guide) pages for more information, or over to [configuration](#configuration) to customise your installation.

(updating)=
## Updating

To update `orto`, run

:::{code-block} bash
    pip install orto --upgrade
:::