Supported OS

Currently, we only support MacOS and Linux operating systems. Windows users have the possibility to install and use ivadomed via Windows Subsystem for Linux (WSL).


ivadomed requires Python >= 3.6 and <3.9. We recommend working under a virtual environment, which could be set as follows:

virtualenv venv-ivadomed
source venv-ivadomed/bin/activate


If the default Python version installed in your system does not fit the version requirements, you might need to specify a version of Python associated with your virtual environment:

virtualenv venv-ivadomed --python=python3.6

Install from source

Bleeding-edge developments are available on the project’s master branch on Github. Installation procedure is the following:

git clone
cd ivadomed
pip install -e .

Install pre-commit hooks for development

We use pre-commit to enforce a limit on file size. After you’ve installed ivadomed, install the hooks:

pre-commit install