AI_MARRVEL

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 22 Open GitHub ↗

AI-MARRVEL (AIM) is an AI system for rare genetic disorder diagnosis

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img width="50%" align="center" src="https://raw.githubusercontent.com/LiuzLab/AI_MARRVEL/main/docs/images/logo.v1.png" alt="logo">
</p>
  <h1 align="center">
  AI-MARRVEL
</h1>

**AI-MARRVEL (AIM)** is an AI system for rare genetic disease diagnosis.

It takes as input patient VCF and phenotype (formatted with HPO) to predict the causal variant(s).
In making prediction, it takes variant annotation from [MARRVEL](https://marrvel.org/) database and more,
and generates **prediction score** + **confidence score** as output.

You can use AI-MARRVEL from our [website](https://ai.marrvel.org/) or follow the [documentation](https://aimarrvel.readthedocs.io/en/main/) to run locally.

:new: Our paper is now published in [NEJM AI](https://ai.nejm.org/doi/full/10.1056/AIoa2300009)!

## Quick Start

### Install Required Data Dependencies

AIM utilizes various databases for variant annotation, all of which have been compiled and are available for download. We use AWS S3 for data access, and the data can be downloaded by following these steps:

1. **Install the AWS CLI**: Follow the instructions provided in the [AWS CLI Installation Guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
2. **Navigate to Your Desired Directory**: Change to the directory where you want your data dependencies downloaded. For example, in Ubuntu, use:
   ```bash
   $ cd <desired/folder/path>
   ```
3. Use the following command to sync the S3 bucket to your local directory:
   ```bash
   $ aws s3 sync s3://aim-data-dependencies-2.4-public . --no-sign-request
   ```

### Get the software

[![Nextflow](https://img.shields.io/badge/nextflow%20DSL2-%E2%89%A523.10.1-23aa62.svg)](https://www.nextflow.io/)

AIM is released as a Nextflow pipeline for easy distribution. To get it:

```bash
$ git clone https://github.com/LiuzLab/AI_MARRVEL
$ cd AI_MARRVEL
$ nextflow run main.nf --version
```

### Run with your sample

```bash
nextflow run /path/to/AI_MARRVEL/main.nf \\
          -profile <debug/docker/singularity/> \\
          --ref_dir /path/to/dependencies/ \\
          --input_vcf /path/to/input.vcf \\
          --input_hpo /path/to/input.hpos.txt \\
          --outdir /path/to/output \\
          --storedir /path/to/store \\
          --run_id <Sample_ID> \\
          --ref_ver <hg19/hg38>
```

For more information on usage and parameters which are open for modification, please use `--help` option as shown below.

```
$ nextflow run main.nf --help
```

## License

AI-MARRVEL is licensed under GPL-3.0. You are welcomed to use it for research purpose.  
For business purpose, please contact us for licensing.

## Disclaimer

- Some of the data and software included in the distribution may be subject to third-party constraints. Users of the data and software are solely responsible for establishing the nature of and complying with any such restrictions.
- AI-MARRVEL provides this data and software in good faith, but make no warranty, express or implied, nor assume any legal liability or responsibility for any purpose for which they are used.

## Citing AI-MARRVEL

```bibtex
@article{doi:10.1056/AIoa2300009,
author = {Dongxue Mao  and Chaozhong Liu  and Linhua Wang  and Rami AI-Ouran  and Cole Deisseroth  and Sasidhar Pasupuleti  and Seon Young Kim  and Lucian Li  and Jill A. Rosenfeld  and Linyan Meng  and Lindsay C. Burrage  and Michael F. Wangler  and Shinya Yamamoto  and Michael Santana  and Victor Perez  and Priyank Shukla  and Christine M. Eng  and Brendan Lee  and Bo Yuan  and Fan Xia  and Hugo J. Bellen  and Pengfei Liu  and Zhandong Liu },
title = {AI-MARRVEL — A Knowledge-Driven AI System for Diagnosing Mendelian Disorders},
journal = {NEJM AI},
volume = {1},
number = {5},
pages = {AIoa2300009},
year = {2024},
doi = {10.1056/AIoa2300009},

URL = {https://ai.nejm.org/doi/abs/10.1056/AIoa2300009},
eprint = {https://ai.nejm.org/doi/pdf/10.1056/AIoa2300009}
,
    abstract = { AI-MARRVEL is an AI system for genetic diagnosis that improves diagnostic accuracy, surpassing state-of-the-art benchmarked methods. }
}
```

AI_MARRVEL

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README