Skip to content

A Full Stack Variant Effect Predictor leveraging the Evo2 LLM for Single Nucleotide Variant(SNV) pathogenicity analysis, powered by a Modal‑deployed FastAPI GPU backend and a Next.js + Shadcn UI frontend

Notifications You must be signed in to change notification settings

Optimized-Brain/MutAIon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MutAIon Logo

Watch Demo

MutAIon - LLM based Variant Analysis WebApp

NextJS TailwindCSS Typescript PyTorch Python Modal

This project implements a web application for variant effect prediction, leveraging the Evo2 large language model to determine the pathogenicity of single nucleotide variants (SNVs). It includes:

  • Python Backend: A FastAPI service running on an H100 GPU via Modal serverless infrastructure.

  • AI Model: Evo2 for classifying SNVs as pathogenic or benign.

  • Database Integration: Fetches ClinVar classifications for comparison.

  • Frontend: Built with Next.js, React, TypeScript, Tailwind CSS, and Shadcn UI (T3 Stack).

  • Features:

    • Genome assembly selection
    • Chromosome browsing and gene search (e.g., BRCA1)
    • Reference genome display
    • Mutation input and prediction
    • Comparison with ClinVar data

Architecture

Backend

  • Framework: FastAPI
  • Deployment: Modal serverless GPU (H100)
  • Endpoint: /predict accepts gene, position, reference and alternative alleles, returns pathogenicity score and label.
  • Dependencies: evo2, modal, fastapi, uvicorn, sqlalchemy, requests

Frontend

  • Framework: Next.js with TypeScript

  • Styling: Tailwind CSS

  • Components: Shadcn UI (Buttons, Inputs, Cards)

  • Pages:

    • / Assembly selection
    • /browse/[assembly] Chromosome listing
    • /gene/[geneId] Gene details and sequence
  • API Integration: Uses React Query to call FastAPI endpoints.

Setup

Prerequisites

  • Node.js >= 18
  • Python 3.10+
  • Modal CLI and account

Backend Installation

cd backend
pip install -r requirements.txt
modal deploy

Frontend Installation

cd frontend
npm install
npm run dev

Usage

  1. Launch backend via Modal.
  2. Start frontend in development mode.
  3. Navigate to http://localhost:3000, select your genome assembly.
  4. Browse or search for genes, input mutations or select existing variations.
  5. View Evo2 predictions alongside ClinVar classifications.

Contributing

Contributions are welcome! Please open issues or submit pull requests.

License

MIT License

About

A Full Stack Variant Effect Predictor leveraging the Evo2 LLM for Single Nucleotide Variant(SNV) pathogenicity analysis, powered by a Modal‑deployed FastAPI GPU backend and a Next.js + Shadcn UI frontend

Topics

Resources

Stars

Watchers

Forks