---
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)

```bash
# 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