> For the complete documentation index, see [llms.txt](https://docs.deepomatic.com/platform-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deepomatic.com/platform-documentation/deepomatic-cli/installation.md).

# Installation

## Python setup

The Deepomatic Command-Line Interface requires Python 3.4+. We strongly recommend using a Python version management system.

If you don't have any, you might want to look into [Pyenv](https://github.com/pyenv/pyenv) and [Pipenv](https://github.com/pypa/pipenv). You will find a detailed tutorial to get started in:

* [Why you should use pyenv + Pipenv for your Python projects](https://hackernoon.com/reaching-python-development-nirvana-bb5692adf30c)
* [The Hitchhiker's Guide to Python: Pipenv & Virtual Environments](https://docs.python-guide.org/dev/virtualenvs/)

## DeepoCLI module

Once you have set up your Python version management system, all you have to do is specify the corresponding version and install the packages. Below you will find two ways to do it using `pip` or `pipenv` and `pyenv`.

{% tabs %}
{% tab title="Installing with pipenv and pyenv (recommended)" %}

```bash
# Install python 3.8+ as an example
pyenv install 3.8.12

# Generate a pipenv environment with the installed python version
pipenv --python 3.8

# Install the stable deepomatic-cli release...
pipenv install deepomatic-cli
# ... or the latest release
pipenv install git+https://github.com/deepomatic/deepocli#egg=deepomatic-cli

# Verify the install with pipenv
pipenv run deepo -h

# Spawn a pre-configured shell and verify the install
pipenv shell
deepo -h
```

{% endtab %}

{% tab title="Installing directly with pip" %}

```bash
# Install the stable deepomatic-cli release...
pip install deepomatic-cli
# ... or the latest release
pip install git+https://github.com/deepomatic/deepocli#egg=deepomatic-cli

# Verify the install
deepo -h
```

{% endtab %}
{% endtabs %}

## Upgrading

If you want to upgrade your package, simply reinstall with `pip` or `pipenv`:

{% tabs %}
{% tab title="Stable release" %}

```bash
# Upgrade DeepoCLI with pipenv to latest version
pipenv update deepomatic-cli

# Upgrade DeepoCLI with pip to latest version
pip install --upgrade deepomatic-cli

# Check the current version
deepo -v
```

{% endtab %}
{% endtabs %}