Lumina / README.md
vscode's picture
Update README.md
0a16076 verified
metadata
title: LuminaCXR
emoji: 🩺
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false

🩺 LuminaCXR β€” AI-Powered Chest X-Ray Analysis

LuminaCXR is an advanced AI-driven healthcare solution designed to analyze Chest X-Ray images for early detection of respiratory diseases such as Pneumonia, Tuberculosis, and COVID-19.
It leverages Deep Learning (CNN) models for high-accuracy predictions and offers an intuitive web-based interface for medical professionals.


πŸš€ Features

βœ… Real-time chest X-ray image analysis
βœ… Disease detection using Convolutional Neural Networks (CNN)
βœ… Intuitive and responsive user interface
βœ… Secure image handling
βœ… Deployable via Hugging Face using Docker SDK


🧠 Model Overview

The model is trained on publicly available Chest X-Ray datasets and optimized using TensorFlow/Keras for fast and accurate inference.
It classifies X-rays into multiple categories such as:

  • Normal
  • Pneumonia
  • Tuberculosis
  • COVID-19

πŸ’» Tech Stack

  • Frontend: HTML, CSS, JavaScript
  • Backend: Python (Flask/FastAPI)
  • ML Framework: TensorFlow / Keras
  • Deployment: Hugging Face (Docker SDK)

🧩 How to Use

  1. Upload a Chest X-Ray image from your device.
  2. The AI model analyzes it and displays the predicted disease.
  3. View confidence scores and visual heatmaps (if enabled).

πŸ› οΈ Installation (Local Development)

# Clone the repository
git clone https://huggingface.co/spaces/your-username/LuminaCXR

# Navigate into the project folder
cd LuminaCXR-main

# Install dependencies
pip install -r requirements.txt

# Run locally
python app.py