Ersilia Model Hub installation instructions
Open a Power Shell with Admin permissions and type:
There are a few third-party pre-requisites and you need to have them installed on your computer before proceeding with the installation of the Ersilia tool. Don't worry, these dependencies are very popular, well documented and continuously maintained. Most probably you know them already.
If you already meet some of the pre-requisites you may skip the corresponding steps.
Probably you have the gcc compiler installed already. This is the command to install it in Ubuntu (the command may be different if you do not use Ubuntu):
sudo apt install build-essential
Although not strictly necessary, we encourage the use of Conda environments. If Conda is available in the local device, the Ersilia tool will try to use it in order to handle dependencies safely and efficiently. Conda can be installed following these instructions. Many people choose to use Anaconda or Miniconda installers.
If you don't have the Conda package manager yet, we suggest you install Miniconda. This is the command to install it in Ubuntu (the command may be different if you do not use Ubuntu):
mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.sh
~/miniconda3/bin/conda init bash
~/miniconda3/bin/conda init zsh
Once Conda is installed (see above), you can use it to install GitHub CLI
conda install gh -c conda-forge
Use the GitHub CLI to login. This may be helpful if you have contributor permissions at Ersilia. Type:
gh auth login
And then follow the instructions.
Git LFS can be installed from Conda:
conda install git-lfs -c conda-forge
Activate Git LFS:
We highly recommend installation of the Isaura data lake. With Isaura, you will be able to cache your model predictions (i.e. store them in your local computer). Isaura is a relatively light Python package:
#activate ersilia's conda environment (see instructions below to create it)
conda activate ersilia
python -m pip install isaura==0.1
Isaura has different functionalities, please make sure to install v0.1
Docker containers are an excellent way to share applications and simplify the management of system requirements and configurations. Please install Docker to ensure that all our AI/ML assets will work smoothly in your local device.
After all the pre-requisites are met, we are ready to install the Ersilia tool.
# create a conda environment
conda create -n ersilia python=3.7
# activate the environment
conda activate ersilia
Then, simply install the Ersilia Python package.
# clone from github
git clone https://github.com/ersilia-os/ersilia.git
# install with pip (use -e for developer mode)
pip install -e .
You should be done! Check that the CLI works on your terminal, and explore the available commands
# see ersilia CLI options
#see ersilia's model catalog