Skip to content

🧠 AI-powered neurological health platform with multi-modal testing labs, EHR integration, and real-time analysis for Parkinson's, Alzheimer's, and Epilepsy detection

Notifications You must be signed in to change notification settings

GeekLuffy/neuroscan

Repository files navigation

🧠 NeuroScan - AI-Powered Neurological Health Platform

NeuroScan Logo

Revolutionizing neurological healthcare through advanced AI and comprehensive sensor technology

GitHub stars GitHub forks GitHub issues GitHub license

React TypeScript Vite Tailwind CSS

🌟 Overview

NeuroScan is a cutting-edge web-based platform that combines advanced AI algorithms with comprehensive neurological testing to enable early detection and monitoring of neurological conditions. Our platform integrates seamlessly with India's national health infrastructure (ABDM) and provides professional-grade medical screening capabilities.

🎯 Key Features

  • πŸ”¬ Multi-Modal Testing Labs: Voice, Motor, Eye movement, Memory, and Cognitive assessments
  • πŸ€– AI-Powered Analysis: Advanced algorithms for Parkinson's, Alzheimer's, and Epilepsy detection
  • πŸ₯ EHR Integration: Seamless connection with ABDM (Ayushman Bharat Digital Mission)
  • πŸ“Š Real-Time Monitoring: Live data visualization and trend analysis
  • πŸ”’ Secure & Compliant: FHIR-compliant data formats and secure health record management
  • πŸ“± Responsive Design: Modern glass-morphism UI with accessibility features

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn
  • Modern web browser with camera/microphone access

Installation

# Clone the repository
git clone https://github.com/GeekLuffy/neuroscan.git
cd neuroscan

# Install dependencies
npm install

# Start development server
npm run dev

Visit http://localhost:5173 to access the application.

πŸ§ͺ Testing Labs

1. Voice & Speech Lab

  • Purpose: Analyze vocal patterns for neurological conditions
  • Features:
    • Real-time pitch analysis
    • Jitter detection
    • Voice quality assessment
    • Speech pattern recognition
  • Conditions Detected: Parkinson's disease, voice disorders

2. Motor & Tremor Lab

  • Purpose: Assess movement patterns and motor control
  • Features:
    • Finger tapping analysis
    • Tremor frequency measurement
    • Movement speed assessment
    • Coordination evaluation
  • Conditions Detected: Parkinson's disease, essential tremor

3. Eye Movement Lab

  • Purpose: Evaluate cognitive function and attention
  • Features:
    • Saccade reaction time
    • Stroop test for attention
    • Digit span memory test
    • Word list recall assessment
  • Conditions Detected: Alzheimer's disease, cognitive impairment

πŸ₯ EHR Integration

NeuroScan integrates with India's national health infrastructure through ABDM (Ayushman Bharat Digital Mission):

Features

  • ABHA ID Authentication: Connect using your 14-digit ABHA ID
  • Medical History Access: View existing health records
  • Test Results Upload: Automatically save results to your EHR
  • FHIR Compliance: Standardized medical data formats
  • Doctor Sharing: Seamlessly share results with healthcare providers

Sandbox Mode (Default)

  • βœ… No credentials required for testing
  • βœ… Demo patient data included
  • βœ… Simulated authentication flow
  • βœ… Test uploads logged to console

πŸ› οΈ Technology Stack

Frontend

  • React 18.3.1 - Modern UI framework
  • TypeScript 5.8.3 - Type-safe development
  • Vite 5.4.19 - Fast build tool
  • Tailwind CSS 3.4.17 - Utility-first styling
  • Radix UI - Accessible component primitives

AI & Machine Learning

  • MediaPipe - Real-time hand tracking and pose estimation
  • Web Audio API - Voice analysis and processing
  • Custom Algorithms - Neurological condition detection

Data & Storage

  • FHIR - Healthcare data standards
  • Local Storage - Client-side data persistence
  • ABDM APIs - National health infrastructure integration

πŸ“ Project Structure

neuroscan/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/          # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ labs/           # Testing lab components
β”‚   β”‚   β”œβ”€β”€ ui/             # Shadcn UI components
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ contexts/           # React context providers
β”‚   β”œβ”€β”€ pages/              # Route components
β”‚   β”œβ”€β”€ services/           # API and external services
β”‚   β”œβ”€β”€ types/              # TypeScript type definitions
β”‚   └── utils/              # Utility functions
β”œβ”€β”€ public/                 # Static assets
β”œβ”€β”€ docs/                  # Documentation
└── ...

πŸ”§ Configuration

Environment Variables

Create a .env file in the project root:

# Gemini AI API Key (for ChatBot)
VITE_GEMINI_API_KEY=your_gemini_api_key_here

# ABDM Configuration (Optional - Sandbox mode works without these)
VITE_ABDM_BASE_URL=https://dev.abdm.gov.in/gateway
VITE_ABDM_CLIENT_ID=your_abdm_client_id_here
VITE_ABDM_CLIENT_SECRET=your_abdm_client_secret_here
VITE_ABDM_SANDBOX=true

Available Scripts

npm run dev          # Start development server
npm run build        # Build for production
npm run preview      # Preview production build
npm run lint         # Run ESLint

🎨 UI/UX Features

Design System

  • Glass Morphism: Modern translucent design
  • Dark Theme: Optimized for medical environments
  • Responsive: Mobile-first design approach
  • Accessibility: WCAG compliant with high contrast options

Theme Customization

  • Dynamic color schemes
  • High contrast mode
  • Large text options
  • Reduced motion preferences

πŸ”’ Security & Privacy

  • Data Encryption: All health data encrypted in transit and at rest
  • FHIR Compliance: Standardized medical data formats
  • ABDM Integration: Government-approved health infrastructure
  • Local Processing: Sensitive data processed locally when possible
  • Consent Management: Granular privacy controls

πŸ“Š Clinical Validation

NeuroScan implements clinically validated assessment protocols:

  • Digit Span Test: Standardized memory assessment
  • Word List Recall: Gold standard for Alzheimer's screening
  • Stroop Test: Attention and executive function evaluation
  • Finger Tapping: Motor control assessment
  • Voice Analysis: Speech pattern evaluation

🀝 Contributing

We welcome contributions! Please see our contributing guidelines:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ‘₯ Team

Owais Naeem - Hardware Integration & AI Developer

  • Machine learning algorithms for neurological analysis
  • Backend API development
  • Medical sensor data processing
  • Hardware-AI integration

Himanshu Rathore - Frontend, UX & IoT Developer

  • Intuitive user interfaces
  • Medical data visualization
  • IoT device communication protocols
  • Real-time monitoring systems

πŸ“ž Support

🌐 Deployment

Vercel (Recommended)

npm run build
# Deploy to Vercel

Other Platforms

The app is a standard React SPA and can be deployed to any static hosting service.


Made with ❀️ for advancing neurological healthcare by Team ORBIT

About

🧠 AI-powered neurological health platform with multi-modal testing labs, EHR integration, and real-time analysis for Parkinson's, Alzheimer's, and Epilepsy detection

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages