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.
- π¬ 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
- Node.js 18+
- npm or yarn
- Modern web browser with camera/microphone access
# Clone the repository
git clone https://github.com/GeekLuffy/neuroscan.git
cd neuroscan
# Install dependencies
npm install
# Start development server
npm run devVisit http://localhost:5173 to access the application.
- 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
- 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
- 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
NeuroScan integrates with India's national health infrastructure through ABDM (Ayushman Bharat Digital Mission):
- 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
- β No credentials required for testing
- β Demo patient data included
- β Simulated authentication flow
- β Test uploads logged to console
- 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
- MediaPipe - Real-time hand tracking and pose estimation
- Web Audio API - Voice analysis and processing
- Custom Algorithms - Neurological condition detection
- FHIR - Healthcare data standards
- Local Storage - Client-side data persistence
- ABDM APIs - National health infrastructure integration
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
βββ ...
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=truenpm run dev # Start development server
npm run build # Build for production
npm run preview # Preview production build
npm run lint # Run ESLint- Glass Morphism: Modern translucent design
- Dark Theme: Optimized for medical environments
- Responsive: Mobile-first design approach
- Accessibility: WCAG compliant with high contrast options
- Dynamic color schemes
- High contrast mode
- Large text options
- Reduced motion preferences
- 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
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
We welcome contributions! Please see our contributing guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Machine learning algorithms for neurological analysis
- Backend API development
- Medical sensor data processing
- Hardware-AI integration
- Intuitive user interfaces
- Medical data visualization
- IoT device communication protocols
- Real-time monitoring systems
- Documentation: docs/SETUP.md
- Issues: GitHub Issues
- Discussions: GitHub Discussions
npm run build
# Deploy to VercelThe app is a standard React SPA and can be deployed to any static hosting service.
Made with β€οΈ for advancing neurological healthcare by Team ORBIT