CoolFace
Apppublic

AbdulManafSahito/Pediatric-Chest-Xray-Pneumonia-Classification-System

sourceHugging Faceupdated 1y agoView on Hugging Face
0likes
App README

๐Ÿซ Pediatric Chest Pneumonia Classification System

A Gradio-based web application for detecting pneumonia in pediatric chest X-ray images using deep learning.

๐Ÿš€ Features

  • โ€”AI-Powered Detection: Uses a trained CNN model to classify chest X-rays
  • โ€”User-Friendly Interface: Simple drag-and-drop image upload
  • โ€”Real-time Predictions: Instant classification results with confidence scores
  • โ€”Educational Purpose: Designed for learning and research applications

๐Ÿฅ How It Works

  1. 1.Upload: Upload a chest X-ray image (PNG, JPG, JPEG)
  2. 2.Analyze: The AI model processes the image using computer vision
  3. 3.Predict: Get classification results (NORMAL or PNEUMONIA) with confidence score

๐Ÿ”ฌ Model Architecture

  • โ€”Input Size: 148x148 grayscale images
  • โ€”Architecture: Convolutional Neural Network (CNN)
  • โ€”Layers:
  • โ€”Conv2D (32 filters) + MaxPooling + BatchNormalization
  • โ€”Conv2D (64 filters) + MaxPooling
  • โ€”Dense layer with sigmoid activation
  • โ€”Output: Binary classification (Normal vs Pneumonia)

๐Ÿ› ๏ธ Technical Details

  • โ€”Framework: TensorFlow/Keras
  • โ€”Interface: Gradio
  • โ€”Image Processing: OpenCV
  • โ€”Deployment: Hugging Face Spaces

๐Ÿ“‹ Usage Instructions

Local Development

  1. 1.Install dependencies:
bash
pip install -r requirements.txt
  1. 1.Run the application:
bash
python app.py
  1. 1.Open the provided URL in your browser

Hugging Face Spaces Deployment

  1. 1.Create a new Space on Hugging Face
  2. 2.Upload all files from this directory
  3. 3.The space will automatically deploy using the requirements.txt

โš ๏ธ Important Disclaimer

This application is for educational and research purposes only.

  • โ€”Not intended for actual medical diagnosis
  • โ€”Should not replace professional medical consultation
  • โ€”Results should be verified by qualified healthcare professionals
  • โ€”Always consult with a doctor for medical concerns

๐Ÿ“Š Model Performance

The model has been trained on pediatric chest X-ray datasets and provides classification confidence scores. However, medical AI should always be used as a supportive tool alongside professional medical expertise.

๐Ÿค Contributing

Feel free to contribute to improve the model accuracy, user interface, or add new features!

๐Ÿ“„ License

This project is for educational purposes. Please ensure compliance with medical data regulations in your jurisdiction.