ersilia 0.1.0

A hub of AI/ML models for open source drug discovery and global health

Welcome to the Ersilia Model Hub!

Table of Contents:

1. Project Description
2. Installation
3. Contribute
4. License and citation
5. About us

Project Description

The Ersilia Model Hub is a unified platform of pre-trained AI/ML models for infectious and neglected disease research. The end goal is to provide an open-source, no-code solution to access AI/ML models to accelerate drug discovery. The models embedded in the hub include both models published in the literature (with appropriate third party acknowledgement) and models developed by the Ersilia team or contributors.

• Read more about the project in the Ersilia Book
• Browse available models in the Ersilia Model Hub

(back to top)

Quick start guide

Please check the package requirements in the Installation Guide. The next steps are a quickstart guide to installing Ersilia.

1. Create a conda environment and activate it

conda create -n ersilia python=3.7
conda activate ersilia

2. Clone this repository and install with pip

git clone https://github.com/ersilia-os/ersilia.git
cd ersilia
pip install -e .

3. Once the Ersilia Model Hub is installed, you can use the CLI to run predictions. First, select a model from the Ersilia Model Hub and fetch it:

ersilia fetch chemprop-antibiotic

4. Generate a few (5) example molecules, to be used as input. The example command will generate the adequate input for the model in use

ersilia example chemprop-antibiotic -n 5 -f my_molecules.csv

5. Then, serve your model:

ersilia serve chemprop-antibiotic

6. And run the prediction API:

ersilia api -i my_molecules.csv -o my_predictions.csv

7. Finally, close the service when you are done.

ersilia close

Please see the Ersilia Book for more examples and detailed explanations.

(back to top)

Contribute

The Ersilia Model Hub is a Free, Open Source Software and we highly value new contributors. There are several ways in which you can contribute to the project:

• A good place to start is checking open issues.
• If you have identified a bug in the code, please open a new issue using the bug template.
• If you want to incorporate a new model in the platform, open a new issue using the model request template or contact us using the following form
• Share any feedback with the community using GitHub Discussions for the project
• Check our Contributing Guide for more details

The Ersilia Open Source Initiative adheres to the Contributor Covenant code of conduct.

(back to top)

License and citation

This repository is open-sourced under the GPL-3 License. Please cite us if you use it.

(back to top)

About us

The Ersilia Open Source Initiative is a Non Profit Organization (1192266) with the mission is to equip labs, universities and clinics in LMIC with AI/ML tools for infectious disease research.

Help us achieve our mission or volunteer with us!

(back to top)