DermAI — AI-Powered Dermatology Analysis

DermAI is a high-fidelity, full-stack medical analysis platform designed to provide instant, AI-driven dermatological insights. Using advanced computer vision and a multi-agent orchestrated pipeline, it analyzes skin images for conditions such as acne, lesions, and pigmentation variations.

✨ Features

• Interactive Upload Flow: A premium glassmorphic interface with reactive, animated "dotted flow" borders and a Three.js-powered background wave.
• AI-Agent Orchestration: A modular backend pipeline that handles image enhancement, facial alignment, feature extraction, and multi-condition detection.
• Deep condition detection:
  • Acne Grading: Quantitative severity analysis across facial zones.
  • Lesion Mapping: Accurate localization of pigmented lesions.
  • Pigmentation Analysis: Heatmap-based melanin distribution analysis.
• Clinical Reports: High-precision medical reports featuring AI-annotated images, condition breakdowns, and targeted recommendations.
• Secure & Private: Local processing with clear medical disclaimers.

🛠️ Technology Stack

Frontend:

• Next.js 16 (App Router)
• Framer Motion (Smooth transitions and flowing borders)
• Three.js (Dynamic background simulations)
• Tailwind CSS (Premium styling and layout)

Backend:

• FastAPI (High-performance Python API)
• MediaPipe (FaceMESH and 468-point landmark detection)
• OpenCV (Image processing and visualization)
• NumPy (Numerical data processing)

---

🚀 Getting Started

Follow these steps to set up and run the platform locally.

1. Prerequisites

• Node.js (v18 or later)
• Python 3.9 or later
• Git

2. Frontend Setup

1. From the project root, install the dependencies:

   npm install

2. Start the development server:

   npm run dev

The frontend will be available at http://localhost:3000.

3. Backend Setup

1. Navigate to the backend directory:

   cd backend/app

2. Create and activate a virtual environment:

   # Windows
   python -m venv ../venv
   ../venv/Scripts/activate
   
   # macOS/Linux
   python3 -m venv ../venv
   source ../venv/bin/activate

3. Install the required Python packages:

   pip install -r requirements.txt

4. Start the FastAPI server:

   uvicorn main:app --port 8000 --reload

The backend API handles all analysis and will be accessible at http://127.0.0.1:8000.

---

🧪 Usage Flow

1. Launch: Start both the frontend and backend servers.
2. Dashboard: Navigate to http://localhost:3000 and click "Start Analysis".
3. Upload: Drag and drop a clear facial image into the animated zones. Look for the "flowing dots" to confirm it's ready!
4. Analyze: Click "Analyze Image". The system will process landmarks and detect conditions.
5. Report: Direct redirection to a comprehensive medical report listing all detected issues and recommendations.

📄 Disclaimer

This platform is for informational and educational purposes only. It does not constitute medical advice or a formal diagnosis. Always consult with a licensed dermatologist for professional medical consultation.

---

Created by Dhruvdpd.