Instructions to use zaheerjk/AI-Powered-Heart-Murmur-Detection-System with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Keras
How to use zaheerjk/AI-Powered-Heart-Murmur-Detection-System with Keras:
# Available backend options are: "jax", "torch", "tensorflow". import os os.environ["KERAS_BACKEND"] = "jax" import keras model = keras.saving.load_model("hf://zaheerjk/AI-Powered-Heart-Murmur-Detection-System") - Notebooks
- Google Colab
- Kaggle
- ๐ซ AI-Powered Heart Murmur Detection System
๐ซ AI-Powered Heart Murmur Detection System
An end-to-end AI-powered heart sound classification system that uses audio signal processing, MFCC feature extraction, and an LSTM deep learning model to analyze heart sound recordings and classify them into target categories.
โ ๏ธ Medical Disclaimer: This project is for educational and research purposes only. It is not a medical device and should not be used for clinical diagnosis or treatment decisions.
๐ Key Features
- ๐ง Heart sound audio classification
- ๐ MFCC feature extraction
- ๐ง LSTM deep learning model
- ๐ Audio preprocessing and normalization
- โฑ๏ธ Up to 10-second audio clips
- ๐ Streamlit deployment
- ๐ค Hugging Face model hosting
๐ผ๏ธ Project Preview
๐๏ธ System Architecture
๐ง Model Architecture
Heart Sound Audio
โ
Audio Preprocessing
โ
Resampling & Normalization
โ
MFCC Feature Extraction
โ
LSTM Deep Learning Model
โ
Classification
โ
Prediction + Confidence
๐ Model Details
| Parameter | Details |
|---|---|
| Task | Audio Classification |
| Architecture | LSTM |
| Features | MFCC |
| Sample Rate | 22,050 Hz |
| Maximum Duration | 10 seconds |
| Framework | TensorFlow / Keras |
| Audio Processing | Librosa |
๐ง Preprocessing
- Load heart sound audio.
- Resample to 22,050 Hz.
- Normalize the audio.
- Standardize the clip duration.
- Extract MFCC features.
- Pass the feature sequence to the LSTM model.
Important: Inference must use the same preprocessing and feature-extraction pipeline used during training.
๐ค Output
The model produces a predicted class and confidence score:
Prediction: <CLASS_NAME>
Confidence: <VALUE>
Confidence should not be interpreted as medical certainty.
๐ป Run Locally
git clone https://github.com/mdzaheerjk/AI-Powered-Heart-Murmur-Detection-System.git
cd AI-Powered-Heart-Murmur-Detection-System
pip install -r requirements.txt
streamlit run app.py
๐ Live Demo
๐ Streamlit App: https://ai-powered-heart-murmur-detection--system.streamlit.app/
๐ ๏ธ Tech Stack
Python โข TensorFlow โข Keras โข Librosa โข NumPy โข Pandas โข Matplotlib โข Streamlit
โ ๏ธ Limitations
Model performance can be affected by:
- Audio quality and background noise
- Recording devices
- Dataset size and diversity
- Class imbalance
- Differences between training and real-world data
This model has not been clinically validated and should not be used as a standalone diagnostic system.
๐ฎ Future Improvements
- CNN + LSTM hybrid architecture
- Transformer-based audio models
- Larger and more diverse datasets
- Audio augmentation
- Explainable AI
- Cross-dataset evaluation
- Model optimization
- Clinical validation
๐จโ๐ป Author
Md Zaheer JK
AI/ML โข Deep Learning โข Generative AI โข NLP โข Computer Vision โข MLOps
๐ GitHub: https://github.com/mdzaheerjk ๐ค Hugging Face: https://huggingface.co/zaheerjk
๐ License
MIT License.
๐ซ Turning Heart Sounds into Machine Learning Insights
- Downloads last month
- -