# Installation

## Stable release

To install icomo, run this command in your
terminal:

```bash
$ pip install icomo
```

You might want to create a virtual environment first, e.g. using
[mamba](https://mamba.readthedocs.io/en/latest/mamba-installation.html):

```bash
$ mamba create -n icomo_env icomo
$ mamba activate icomo_env
```

or directly using venv:

```bash
$ python -m venv /path/to/new/icomo_env
$ source /path/to/new/icomo_env/bin/activate
$ pip install icomo
```

This is the preferred method to install icomo,
as it will always install the most recent stable release.
You might also want to install [jupyterlab](https://jupyter.org) to run the examples:

```bash
$ pip install jupyterlab
```

## From sources

The sources for icomo can be downloaded from
the [Github repo](https://github.com/Priesemann-Group/icomo).

You can either clone the public repository:

```bash
$ git clone https://github.com/Priesemann-Group/icomo
```

Or download the
[tarball](https://github.com/Priesemann-Group/icomo/tarball/main):

```bash
$ curl -OJL https://github.com/Priesemann-Group/icomo/tarball/main
```

Enter the directory and install with pip:

```bash
$ cd icomo
$ pip install -e .
```
This enables you to edit the code and have the changes directly available in your python
environment.