README.md

metadata

title: PneumoDetect
emoji: 🩻
colorFrom: indigo
colorTo: blue
sdk: docker
pinned: false
app_port: 7860

PneumoDetect | Smart Radiography ✨

A premium, high-performance web application designed for rapid Pneumonia detection from Chest X-Rays. Powered by state-of-the-art Vision Transformers (ViT) and a modern, clinical-grade interface.

Core Features 🚀

• ViT-Powered Inference: Utilizes the nickmuchi/vit-finetuned-chest-xray-pneumonia model, a Vision Transformer fine-tuned specifically for radiographic analysis.
• Clinical Grade UI: A "Clean Clinical Light" theme designed for medical environments, featuring glassmorphism, fluid animations, and high-tech scanning effects.
• Instant Diagnostics: Real-time analysis with confidence metrics and probability distribution visualizations.
• Streamlined Performance: Optimized backend logic that removes redundant preprocessing and ensembles for faster, more efficient execution.
• Drag-and-Drop Workflow: Supports effortless file uploads and instant scan previews.

Tech Stack 🛠️

• Backend: Flask (Python)
• AI Core: Hugging Face Transformers, PyTorch
• Frontend: Vanilla HTML5, CSS3 (Modern Glassmorphism), Javascript (ES6+)
• Models: Vision Transformer (ViT)

Setup Instructions 💻

1. Environment Setup

Clone the repository and install the optimized dependency list:

pip install -r requirements.txt

2. Launch the Suite

Initialize the Flask server:

python app.py

Access the dashboard at http://localhost:5000

Architecture Highlights 🏗️

• Simplified Pipeline: Replaced heavy ensemble logic with a single, high-accuracy ViT backbone to reduce latency and memory footprint.
• Transformer-First Design: Leveraging the global attention mechanisms of ViTs to handle raw radiographic data without needing traditional contrast enhancement (CLAHE).
• Responsive Aesthetics: A fully responsive, "sharp" design that adapts to all devices while maintaining a premium medical feel.
• Micro-Interactions: Custom scanning animations and interactive progress bars for enhanced user feedback.

---

Built by Azhar Ahmed

Disclaimer: This tool is intended for educational and demonstrative purposes only. Always consult a qualified medical professional for clinical diagnosis.