diff --git a/INSTALL.md b/INSTALL.md
deleted file mode 100644
index 6c5fca38013669b37b4e801ce4f583e3bb8ab759..0000000000000000000000000000000000000000
--- a/INSTALL.md
+++ /dev/null
@@ -1,53 +0,0 @@
-# Installation 
-
-Tested on: Mac OSX Mojave
-
-## Requirements
-We strongly recommend installing within a python environment as there are many dependencies that you may not want polluting your regular python environment. 
-Make sure you are using python 3.
-
-An environment can be created with using the conda package manager:
-
-    $ conda create --name <env>
-    $ conda activate <env>
-
-Which you can deactivate with: 
-
-    $ conda deactivate
-
-Or using virtualenv: 
-
-    $ python -m virtualenv /path/to/venv/
-    $ source /path/to/venv/bin/activate
-    
-This will download all of your packages under `/path/to/venv` and then activate it. 
-Deactivate using 
-
-    $ deactivate
-
-You will also need to make sure you have a recent version of pip.
-In your local environment, run: 
-
-    $ pip install --upgrade pip
-
-## Pipeline installation
-
-Once you have created your local environment, run:
-
-    $ cd pipeline-core
-    $ pip install -e ./
-
-You will be asked to put in your GitLab credentials for a couple of the packages installed as dependencies.
-The `-e` option will install in 'editable' mode: all of the changes that are made to the code in the repository will immediately be reflected in the installation. 
-This is very useful to keep up with any changes and branching that we make. 
-That way, if you want to keep up with the most recent updates, just run: 
-
-    $ git pull
-
-If you would rather be more in charge of which updates you install and which you don't, remove `-e` from your installation command. 
-In this case (or if you run into a dependency error) in order to update your installed version you will have to run: 
-
-    $ cd pipeline-core
-    $ git pull
-    $ pip install ./
-
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
new file mode 100644
index 0000000000000000000000000000000000000000..47dfb80d26f59fe3fec30d4ae8ed48f6586cf9a8
--- /dev/null
+++ b/docs/INSTALL.md
@@ -0,0 +1,64 @@
+# Installation 
+
+Tested on: Mac OSX Mojave and Ubuntu 20.04
+
+## Requirements
+We strongly recommend installing within a python environment as there are many dependencies that you may not want polluting your regular python environment. 
+Make sure you are using python 3.
+
+An environment can be created with using the conda package manager:
+
+    $ conda create --name <env>
+    $ conda activate <env>
+
+Which you can deactivate with: 
+
+    $ conda deactivate
+
+Or using virtualenv: 
+
+    $ python -m virtualenv /path/to/venv/
+    $ source /path/to/venv/bin/activate
+
+This will download all of your packages under `/path/to/venv` and then activate it. 
+Deactivate using 
+
+    $ deactivate
+
+You will also need to make sure you have a recent version of pip.
+In your local environment, run: 
+
+    $ pip install --upgrade pip
+    
+Or using [pyenv](https://github.com/pyenv/pyenv) with pyenv-virtualenv:
+
+    $ pyenv install 3.7.9
+    $ pyenv virtualenv 3.7.9 aliby
+    $ pyenv local aliby
+
+
+## Pipeline installation
+
+### Pip version
+Once you have created your local environment, run:
+
+    $ cd aliby
+    $ pip install -e ./
+
+
+### Git version
+
+We use [ poetry ](https://python-poetry.org/docs/#installation) for dependency management. 
+
+
+In case you want to have local versions (usually for development) the main three aliby dependencies you must install them in a specific order:
+
+    $ git clone git@git.ecdf.ed.ac.uk:swain-lab/aliby/aliby.git
+    $ git clone git@git.ecdf.ed.ac.uk:swain-lab/aliby/postprocessor.git
+    $ git clone git@git.ecdf.ed.ac.uk:swain-lab/aliby/agora.git
+
+    $ cd aliby && poetry install
+    $ cd ../postprocessor && poetry install
+    $ cd ../agora && poetry install
+
+And that should install all three main dependencies in an editable mode. The same process can be used for [BABY](https://git.ecdf.ed.ac.uk/swain-lab/aliby/baby)
diff --git a/README.md b/docs/README.md
similarity index 100%
rename from README.md
rename to docs/README.md
diff --git a/poetry.lock b/poetry.lock
index 852598bc29d8c32b5638602c57496bf53afd3ac8..b4407e3fc8fb414bbae91508615f87c2c5fab9b3 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -78,7 +78,7 @@ python-versions = "*"
 
 [[package]]
 name = "aliby-agora"
-version = "0.2.25"
+version = "0.2.27"
 description = "A gathering of shared utilities for the Swain Lab image processing pipeline."
 category = "main"
 optional = false
@@ -91,6 +91,7 @@ opencv-python = "*"
 pandas = ">=1.1.4,<2.0.0"
 py-find-1st = ">=1.1.5,<2.0.0"
 PyYAML = ">=6.0,<7.0"
+scipy = ">=1.7.3"
 
 [[package]]
 name = "aliby-baby"
@@ -118,14 +119,14 @@ xgboost = "1.4.2"
 
 [[package]]
 name = "aliby-post"
-version = "0.1.25"
+version = "0.1.26"
 description = "Post-processing tools for aliby pipeline."
 category = "main"
 optional = false
 python-versions = ">=3.7.1,<3.11"
 
 [package.dependencies]
-aliby-agora = ">=0.2.25,<0.3.0"
+aliby-agora = ">=0.2.27,<0.3.0"
 catch22 = ">=0.2.0,<0.3.0"
 gaussianprocessderivatives = ">=0.1.2,<0.2.0"
 leidenalg = ">=0.8.8,<0.9.0"
@@ -2008,7 +2009,7 @@ testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-
 [metadata]
 lock-version = "1.1"
 python-versions = ">=3.7.1,<3.11"
-content-hash = "f9ee341dcb5c812f3112752cb5234c62a73c320a20a048b2e000d45efd5c6a7d"
+content-hash = "ebcffe1a9437b624306cf70a29e431bbdce98596f844a9453757564a7a3035c4"
 
 [metadata.files]
 absl-py = [
@@ -2106,16 +2107,16 @@ alabaster = [
     {file = "alabaster-0.7.12.tar.gz", hash = "sha256:a661d72d58e6ea8a57f7a86e37d86716863ee5e92788398526d58b26a4e4dc02"},
 ]
 aliby-agora = [
-    {file = "aliby-agora-0.2.25.tar.gz", hash = "sha256:bb1a32e3f7c0dc1c7c745174a4d13e09a07375d9f5a655783b532a7473b3f962"},
-    {file = "aliby_agora-0.2.25-py3-none-any.whl", hash = "sha256:43ef2103685b544669032792f651d75c7cc33cfd3fdc0774dfc919a44b93cd22"},
+    {file = "aliby-agora-0.2.27.tar.gz", hash = "sha256:04509d86348ccfa758672eb236714a663c07f5321058f3247e53ca41463db08f"},
+    {file = "aliby_agora-0.2.27-py3-none-any.whl", hash = "sha256:17499f4d76ca97950859747dc96e3d35560c0386bc4af7b019ce1453c7175f8a"},
 ]
 aliby-baby = [
     {file = "aliby-baby-0.1.8.tar.gz", hash = "sha256:edd9773040bc80640dd1aab0ec87e1f2eb043232beb1b819274f2f915958520a"},
     {file = "aliby_baby-0.1.8-py3-none-any.whl", hash = "sha256:21c7c46f5da719f03f3657b31e6112953e97236a9e5e69537cdde75a4be338f4"},
 ]
 aliby-post = [
-    {file = "aliby-post-0.1.25.tar.gz", hash = "sha256:dffd3c77d400df4adb610a5ec2fd7bb6833cb277018e0f0d696c18a79bd2150e"},
-    {file = "aliby_post-0.1.25-py3-none-any.whl", hash = "sha256:2cf93978e35f39d80a1e8be9687414b041a4f88a1ca004b5f04f6a2f7fdda2ef"},
+    {file = "aliby-post-0.1.26.tar.gz", hash = "sha256:13ad2df77b28a5ecfb5a8f15e318593b505cfce70a4b41b805a071f08f22c60f"},
+    {file = "aliby_post-0.1.26-py3-none-any.whl", hash = "sha256:7d710794c446c63fdb79b9f5515b894eb3c458bd129b4610d789dd6bcfe447a9"},
 ]
 appdirs = [
     {file = "appdirs-1.4.4-py2.py3-none-any.whl", hash = "sha256:a841dacd6b99318a741b166adb07e19ee71a274450e68237b4650ca1055ab128"},
diff --git a/pyproject.toml b/pyproject.toml
index 5b9b5cc482b3a8cc824888bd0846a87e16abcc98..6f978dcd6bcc82e68fc307ea68c3f01dc3ed46e5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "aliby"
-version = "0.1.26"
+version = "0.1.27"
 description = "Process and analyse live-cell imaging data"
 authors = ["Alan Munoz <alan.munoz@ed.ac.uk>"]
 packages = [
@@ -26,7 +26,7 @@ omero-py = ">=5.6.2"
 zeroc-ice = "3.6.5"
 aliby-agora = "^0.2.23"
 aliby-baby = "^0.1.7"
-aliby-post = "^0.1.25"
+aliby-post = "^0.1.26"
 p-tqdm = "^1.3.3"
 xmltodict = "^0.13.0"