Skip to content

Latest commit

Β 

History

184 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧬 AI Biomarker Discovery Platform

Python Streamlit License Status

An end-to-end AI-powered biomarker discovery platform that integrates bioinformatics, machine learning, and explainable AI to identify potential disease-associated biomarkers from gene expression data.

The platform allows researchers to upload or automatically retrieve public gene expression datasets, perform preprocessing, train machine learning models, interpret predictions using SHAP explainability, and generate biological insights.


πŸš€ Project Overview

Finding reliable biomarkers from high-dimensional genomic data is challenging because gene expression datasets contain thousands of features (genes) but limited samples.

This project aims to build an automated workflow:

Pipeline Diagram


✨ Features

πŸ“‚ Dataset Management

Dataset Upload Screenshot

Supports:

  • User-uploaded gene expression matrices
  • Sample metadata upload
  • Example datasets
  • GEO accession-based dataset retrieval

Currently supports:

  • GEO datasets (GSE accession)
  • CSV expression matrices
  • CSV metadata files

🧬 Gene Expression Processing

Pipeline includes:

  • Expression matrix loading
  • Sample validation
  • Metadata matching
  • Data preprocessing
  • Gene feature handling
  • Dataset quality checks

Preprocessing


πŸ” Exploratory Analysis

Includes:

  • Gene expression visualization
  • PCA analysis
  • Sample clustering
  • Distribution analysis

PCA and Clustering Plot


πŸ€– Machine Learning

Implemented models:

  • Random Forest Classifier
  • Logistic Regression

The models learn patterns between:

Gene Expression β†’ Disease State

Machine Learning


πŸ”¬ Explainable AI

Uses SHAP (SHapley Additive exPlanations) to understand model decisions.

Provides:

  • Global feature importance
  • Top biomarker candidates
  • SHAP summary plots
  • SHAP ranking of important genes

SHAP Summary Plot


πŸ§ͺ Biomarker Discovery

The platform ranks candidate biomarkers using machine learning feature importance and SHAP explainability.

Outputs include:

  • Ranked biomarkers
  • Feature importance
  • Expression comparison
  • Biomarker confidence scores

Biomarkers


🌿 Biological Interpretation

Interpret discovered biomarkers using biological knowledge.

Future support includes:

  • Gene Ontology (GO)
  • KEGG Pathways
  • Functional Annotation
  • Disease Association

Biological Interpretation


πŸ“„ Automated Research Report

Generate a downloadable report containing:

  • Dataset summary
  • Quality control statistics
  • PCA visualization
  • Differentially expressed genes
  • Machine learning performance
  • SHAP explainability
  • Ranked biomarker candidates
  • Biological interpretation

Report

---

πŸ§ͺ GEO Dataset Integration

The platform can automatically:

  • Download GEO datasets
  • Extract expression matrices
  • Extract sample metadata
  • Detect experimental groups
  • Prepare data for downstream analysis

Supported GEO Datasets

The current version of this platform supports GEO studies that provide a processed gene expression matrix (Series Matrix).

Supported:

  • Microarray expression datasets
  • Processed expression matrices available through GEO

Currently not supported:

  • Raw RNA-seq FASTQ files
  • Supplementary count files only
  • Single-cell RNA-seq datasets
  • GEO studies requiring external preprocessing

Future versions will include automated processing of RNA-seq count matrices and expanded support for additional transcriptomic data formats.

The platform can automatically:

  • Download GEO datasets
  • Extract expression matrices
  • Extract sample metadata
  • Detect experimental groups
  • Prepare data for downstream analysis

Example:

GEO Accession
       β”‚
       β–Ό
Automatic Download
       β”‚
       β–Ό
Expression Matrix
       β”‚
       β–Ό
Automatic Metadata Extraction
       β”‚
       β–Ό
Preprocessing
       β”‚
       β–Ό
Machine Learning
       β”‚
       β–Ό
Biomarker Discovery

πŸ—οΈ Project Architecture

AI_Biomarker_Discovery/

β”‚
β”œβ”€β”€ app.py
β”‚
β”œβ”€β”€ pages/
β”‚   β”œβ”€β”€ 1_Home.py
β”‚   β”œβ”€β”€ 2_Dataset.py
β”‚   β”œβ”€β”€ 3_Preprocessing.py
β”‚   β”œβ”€β”€ 4_Exploration.py
β”‚   β”œβ”€β”€ 5_Feature_Selection.py
β”‚   β”œβ”€β”€ 6_Machine_Learning.py
β”‚   β”œβ”€β”€ 7_SHAP_Explainability.py
β”‚   β”œβ”€β”€ 8_Biomarker_Results.py
β”‚   β”œβ”€β”€ 9_Biological_Interpretation.py
β”‚   └── 10_Report.py
β”‚
β”œβ”€β”€ utils/
β”‚   β”œβ”€β”€ data_loader.py
β”‚   β”œβ”€β”€ preprocessing.py
β”‚   β”œβ”€β”€ feature_selection.py
β”‚   β”œβ”€β”€ models.py
β”‚   β”œβ”€β”€ shap_analysis.py
β”‚   β”œβ”€β”€ geo_downloader.py
β”‚   β”œβ”€β”€ visualization.py
β”‚   β”œβ”€β”€ biology.py
β”‚   β”œβ”€β”€ biomarker_ranking.py
β”‚   └── report.py
β”‚
β”œβ”€β”€ data/
β”œβ”€β”€ report.py/
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ assets/
|
└── README.md

πŸ› οΈ Tech Stack

Programming

  • Python 3.12+

Bioinformatics

  • GEOparse
  • Gene expression analysis
  • Genomic datasets

Machine Learning

  • Scikit-learn
  • Random Forest
  • Logistic Regression

Explainable AI

  • SHAP

Data Processing

  • Pandas
  • NumPy

Visualization

  • Matplotlib
  • Streamlit

Report Generation

  • ReportLab

πŸ“Š Input Data Format

Expression Matrix

Example:

Gene Sample_1 Sample_2 Sample_3
TP53 10.2 12.5 8.4
EGFR 5.6 7.2 2.3

Format:

Gene β†’ First column
Samples β†’ Remaining columns

Metadata File

Example:

Sample Group
Sample_1 Control
Sample_2 Control
Sample_3 Disease

Sample names must match expression matrix columns.


βš™οΈ Installation

Clone repository:

git clone https://github.com/Bano733-code/AI-Biomarker-Discovery.git

Navigate:

cd AI-Biomarker-Discovery

Create environment:

python -m venv venv

Activate environment:

Windows:

venv\Scripts\activate

Linux/Mac:

source venv/bin/activate

Install dependencies:

pip install -r requirements.txt

▢️ Run Application

Start Streamlit:

streamlit run app.py

The application will open in your browser.


πŸ“ˆ Future Improvements

Planned improvements:

  • Differential expression analysis
  • GO and KEGG pathway enrichment
  • Gene ontology annotation
  • Biological network visualization
  • RNA-seq normalization workflows
  • Deep learning models
  • Automated research report generation
  • Integration with additional biological databases

🎯 Motivation

This project explores the application of:

  • Machine Learning
  • Explainable AI
  • Computational Biology
  • Genomics

for discovering interpretable biomarkers from high-dimensional biological datasets.


πŸ‘©β€πŸ’» Author

Bano Rani

BS Bioinformatics Student
Research Interests:

  • Machine Learning in Bioinformatics
  • Computational Biology
  • Genomics
  • Precision Medicine
  • AI-driven Drug Discovery

⭐ Acknowledgements

Data sources:

  • NCBI Gene Expression Omnibus (GEO)
  • Public genomic datasets

Libraries:

  • Scikit-learn
  • SHAP
  • Streamlit
  • GEOparse

About

This is AI powered Biomarker discovery platform using ML pipeline

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages