NeuraDock Visual Cognitive Load Agent Tutorial: A Quality-Gated Open-Source EEG Workflow for Alpha Dynamics and Real-Time Applications
Zhiyuan Xu, Yueqing Dai, Junling Li, Junwen Luo · 2026
Read NeuraDock Visual Cognitive Load Agent Tutorial: A Quality-Gated Open-Source EEG Workflow for Alpha Dynamics and Real-Time Applications by Zhiyuan Xu, Yueqing Dai, Junling Li, Junwen Luo (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2606-26518.txt.
Introduction
A hands-on tutorial by Zhiyuan Xu, Yueqing Dai, Junling Li, and Junwen Luo walks readers through NeuraDock Agent. The agent is an open-source tool for EEG analysis. EEG records electrical activity from the scalp. The tutorial centres on alpha dynamics, changes in the brain's alpha rhythm, and on visual cognitive load, the mental effort a visual task demands.
Readers install the agent and run preprocessing and quality control step by step. They generate alpha figures and compare rest against task within the same person. They also start a live dashboard and call a real-time interface from another program. A language model layer explains quality risks in the results. Quality gates come first throughout: workload metrics are computed only after data passes checks. On a small sample data set, the agent processed eighteen recordings. Seven of ten comparisons showed the expected task-related alpha suppression.
Catalog record
| CREATOR | Zhiyuan Xu, Yueqing Dai, Junling Li, Junwen Luo |
|---|---|
| YEAR | 2026 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 36 KB |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2606.26518
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
NeuraDock Visual Cognitive Load Agent Tutorial: A Quality-Gated Open-Source EEG Workflow for Alpha Dynamics and Real-Time Applications Zhiyuan Xu, Yueqing Dai, Junling Li, Junwen Luo Abstract This tutorial paper provides a step-by-step, reproducible walkthrough of NeuraDock Agent, an open-source EEG agent focused on Alpha dynamics and visual cognitive-load analysis. The goal is practical: a reader should be able to install the agent, run EEG preprocessing and quality control, generate Alpha dynamics figures, perform within-subject Rest/Task visual cognitive-load comparison, run the public mini-dataset analyses and compare them with the reference validation summary, start an online dashboard, call the real-time API from an external application, and use the LLM interpretation layer to explain quality risks. Existing EEG toolkits provide excellent offline analysis, but assembling a real-time, quality-gated cognitive-load pipeline often requires manually bridging acquisition, custom QC, Alpha feature extraction, and a web API; this tutorial closes that offline-to-online gap. The tutorial uses a quality-gated workflow: downstream Alpha and workload metrics are computed only after preprocessing and QC gating rather than directly from raw EEG. In the included mini-dataset validation, the agent processed 18 recordings, generated 10 within-subject comparisons, observed task-related posterior Alpha suppression in 7 of 10 contrasts, estimated initial evidence of within-subject repeatability, and benchmarked local online API latency. The tutorial is intended for researchers, developers, and applied teams who want a transparent path from EEG files to real-time visual cognitive-load prototypes. Open-source agent and latest instructions: https://github.com/Neuradock/eeg-workstation-agent Keywords: EEG tutorial; visual cognitive load; Alpha dynamics; posterior Alpha suppression; open source; real-time API; quality control; NeuraDock Agent 1 Reader Goal This tutorial is written as a hands-on paper. By the end, a reader should be able to reproduce the following outputs: • EEG preprocessing and signal-quality reports. • Clean/QC-gated EEG output files. • Alpha dynamics time-domain, frequency-domain, and time-frequency figures. • Within-subject offline Rest/Task cognitive-load comparison figures. • Mini-dataset per-recording and within-subject comparison outputs. • A real-time local dashboard and API endpoint. • LLM-based explanations of computed EEG results and quality risks. More importantly, by the end of the tutorial the reader will have a local HTTP endpoint that streams a visual workload index and quality flag to an application. Wiring together that path from offline EEG scripts to a live API is often the part that turns a promising cognitive-load idea into weeks of infrastructure work. The tutorial also states what the workflow is not: it is not a clinical diagnostic system, not an attention or fatigue diagnosis, and not a cross-subject cognitive-ability ranking method. 2 Why a Tutorial Workflow Is Needed General EEG tools such as MNE-Python, EEGLAB, and BrainFlow are powerful and open source, but they are broad toolkits rather than focused cognitive-load workflows [ 1 , 2 , 4 , 5 , 3 ] . Commercial and device-specific systems such as Emotiv Cortex and Neurosity SDK workflows provide real-time data access, but they are not fully open, locally auditable cognitive-load analysis stacks [ 6 , 7 ] . Existing cognitive-load studies often remain offline and do not provide a complete path from preprocessing to a real-time API. This creates the practical “why now” gap: teams building adaptive interfaces, XR demos, HMI experiments, or internal workload dashboards can analyze EEG offline, but still struggle to deploy the same logic as a quality-gated service that another application can call once per second. NeuraDock Agent fills this gap by packaging a focused tutorial workflow: ⬇ Install -> Check profile -> Preprocess and quality - gate EEG -> Analyze Alpha dynamics -> Compare Rest / Task within subject -> Run public mini - dataset analyses -> Start online dashboard / API -> Interpret results with LLM summary layer The value is not only a feature extractor. The value is an auditable, repeatable route from EEG data to cognitive-load application prototypes. 3 Tutorial Assumptions The commands below assume Windows PowerShell and that the current directory is the root of the cloned eeg-workstation-agent repository. All paths are relative to that repository; no machine-specific installation path is required. The short examples use public files downloaded and SHA256-verified by the repository’s data helper: ⬇ data_examples \ alpha \ open_closed_eye2 . txt data_examples \ rest_task \ rest_S01_1 . txt data_examples \ rest_task \ task_S01_1 . txt The complete tutorial dataset is maintained separately at https://github.com/Neuradock/eeg-workstation-data/tree/add-visual-cognitive-load-mini-dataset-20260622/visual_cognitive_load/mini_dataset_v20260622 . The workflow uses a seven-channel NeuraDock profile and a 250 Hz sampling rate. The posterior and parieto-occipital channels are used for visual Alpha features. 4 Step 1: Install and Check the Agent Clone the open-source repository and enter its root directory: ⬇ git clone https :// github . com / Neuradock / eeg - workstation - agent . git cd eeg - workstation - agent Create a virtual environment and install the agent: ⬇ py - m venv . venv .\. venv \ Scripts \ python . exe - m pip install -- upgrade pip .\. venv \ Scripts \ python . exe - m pip install - e ".[ dev ]" Download the three public example recordings used in Steps 2–4: ⬇ .\. venv \ Scripts \ python . exe scripts \ download_example_data . py The downloader verifies each file against a release-pinned SHA256 value. Human EEG recordings are maintained in the separate data repository; the MIT software license does not automatically replace the data repository’s usage and redistribution terms. Check the version and hardware profile: ⬇ .\. venv \ Scripts \ neuradock - agent . exe -- version .\. venv \ Scripts \ neuradock - agent . exe profile Expected version: ⬇ 2026.6.24 The actual hardware profile output from this tutorial run was: ⬇ { " profile_version ": "1.1", " device ": " NeuraDock EEG Workstation ", " hardware_revision ": " public - profile - v2 ", " sampling_rate_hz ": 250, " channels ": [" CP5 ", " CP6 ", " PO3 ", " PO4 ", " O1 ", " Oz ", " O2 "], " amplitude_unit ": " microvolts ", " line_frequency_hz ": 50.0, " tcp_default_ip ": "127.0.0.1", " tcp_default_port ": 9600, " tcp_start_command ": " start ", " packet_total_channels ": 8, " packet_used_channels ": 7, " bluetooth_samples_per_packet ": 5, " quality ": { " line_noise_power ": 10.0, " emg_power ": 20.0, " outlier_count_per_second ": 2, " outlier_absolute_amplitude ": 100.0, " bad_channel_segment_ratio ": 0.4, " minimum_neighbor_correlation ": 0.15 }, " channel_count ": 7 } This confirms that the tutorial uses a 7-channel profile sampled at 250 Hz, with posterior channels PO3 , PO4 , O1 , Oz , and O2 available for visual Alpha features. The TCP defaults also explain why online mode can start from only an IP address and port. 4.1 Hardware-Tuned Design The NeuraDock montage is not arbitrary for this tutorial. The posterior ring PO3/PO4/O1/Oz/O2 targets occipital and parieto-occipital Alpha dynamics, which are the primary signal family used here for visual cognitive-load estimation. The lateral channels CP5/CP6 provide additional spatial context for quality checks and posterior asymmetry interpretation. The agent can ingest generic 7-channel data with the same shape, but the spatial QC thresholds, posterior-channel grouping, and right-minus-left asymmetry metrics are calibrated for this NeuraDock geometry. For best results, use the NeuraDock hardware profile rather than treating the agent as an arbitrary EEG file parser. 5 Step 2: Run EEG Preprocessing and Quality Control