README.md

---
title: Neuro-Adaptive UI
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: gradio
app_file: app.py
pinned: false
---

# Neuro-Adaptive UI: Cognitive Load Monitoring System

**Neuro-Adaptive UI** is a research-oriented pipeline that bridges **Neuroscience and Human-Computer Interaction (HCI)**. The system monitors cognitive load via simulated 14-channel EEG streams and dynamically adjusts UI density to optimize user focus.

## System Architecture
The pipeline processes raw EEG data through a modular "Data-to-UI" flow:
1. **Data Acquisition:** MNE-Python simulation.
2. **Feature Extraction:** Power Spectral Density (PSD) analysis.
3. **Decision Engine:** Random Forest Classifier for cognitive state estimation.
4. **Adaptive UI:** Real-time interface feedback loop.

## Technical Highlights
* **Signal Processing:** `MNE-Python` powered PSD analysis (Alpha/Theta ratios).
* **AI Engine:** `Random Forest Classifier` for cognitive state estimation (Low/Medium/High).
* **Adaptive UX:** Reactive feedback loop for real-time interface density shifts.
* **Architecture:** Modular, low-latency design optimized for Edge AI deployment.

## Visuals & Performance
* **EEG Signal Simulation:** Real-time 14-channel data representation.
* **Classifier Performance:** Model accuracy assessment on synthetic cognitive load datasets.

## How to Run
1. **Clone the repo:** `git clone https://huggingface.co/spaces/begumbb/Neuro-Adaptive-UI`
2. **Install requirements:** `pip install -r requirements.txt`
3. **Run the app:** `python app.py`

---
*Developed as a research-oriented exploration of Neuro-AI pipelines.*