MNE-Python · EEGLAB · FieldTrip

Auto EEG Analysis

Reusable EEG analysis skills for coding agents.

Choose a workflow, approve the plan, and retain the executed code, results and report.

22 Skills10 RecipesZenodo ↗

N400 in practice

N400 / ERP CORE ↗

A fixed N400 tutorial, from a semantic-priming recipe to saved results from 20 ERP CORE participants.

N400 ERP waveforms, descriptive scalp map and participant mean amplitudes from 20 ERP CORE participants
CPz/Cz/Pz waveforms, a descriptive scalp map, and participant amplitudes at 300–500 ms. Shading shows ±1 participant SEM. This fixed tutorial omits ICA and is separate from the recorded agent analysis.

Library

22 + 10

Find a study recipe or an individual analysis skill. Open the source to inspect the inputs, methods and numerical conventions.

ern-flankers

N2, response-related negativity, frontal theta

Validated

p300-oddball

P300 to rare targets

Experimental. Group validation recorded.

n170-faces

Faces versus non-face controls

Validated

complexity-anesthesia

Continuous complexity and entropy

Validated. Awake-state check only. Anesthesia untested.

eeg-ica

ICA and component labeling

Skills

eeg-epoch

Segmentation and artifact rejection

Skills

eeg-erp

ERPs and component measures

Skills

eeg-tfr

Time-frequency analysis

Skills

eeg-behavior

Behavioral and trial-level associations

Skills

eeg-qc

Data-quality checks

Skills

eeg-figure

Figures and data-fidelity checks

Skills

eeg-report

Reports and reproducibility receipts

Skills

eeg-recipe

Recipe execution and version tracking

Skills

Recipe status and validation apply to the configurations recorded in each source. Validation coverage ↗

Use your own coding client and analysis environment.

Python / MNE

The PyPI package creates a new project with the AEA resources. Python 3.10+ and an existing MNE environment are required. The default package does not install the scientific dependencies.

Full setup and dependencies ↗

In your terminal
python -m pip install auto-eeg-analysis==0.3.3
aea-eeg init ./my-eeg-study --agent codex
cd my-eeg-study
codex
Inside the coding client
$eeg-recipe n400-semantic --data .

Place compatible data in my-eeg-study/raw/, then start your signed-in coding client in that project. Choose the recipe for your paradigm and approve the plan before computation. Configure the reviewer for the audit stage.

Install from a Git checkout
In your terminal
git clone https://github.com/dengzhe-hou/Auto-EEG-Analysis.git
cd Auto-EEG-Analysis
conda env create -f environment.yml
conda activate aeais
python tools/install_skills.py --agent codex
codex

Using MATLAB / EEGLAB?

Install AEA 0.1.3 through the EEGLAB extension manager, or use the MATLAB toolbox preview. The native MATLAB route covers explicit ERP means from existing epochs. The broader library primarily uses MNE-Python.

From a plan to saved analysis

  1. Define the study

    Choose a recipe or skills and confirm the scientific choices.

  2. Execute the plan

    The coding agent adapts and runs scripts in your environment.

  3. Inspect and replay

    Keep the executed code, numerical results, figures and review records.

Replay instructions ↗

What has been checked

Validation coverage ↗

Numerical comparisons are tied to documented settings and saved outputs.

ERP amplitudes
Selected comparisons with MNE-BIDS-Pipeline, EEGLAB and FieldTrip.
Cluster statistics
Selected observed t maps and cluster partitions compared with FieldTrip.
Spectral power
Band power checked with an independent Welch implementation.

Coverage is specific to the tested output and configuration. It does not certify every generated workflow.

Build on the library

Add a recipe, improve a skill, share a tutorial, or report a first run. The contribution guide explains the expected evidence and recognition policy.

Cite the version you use

Cite AEA with the software version or commit, and cite the original methods and datasets. The Zenodo record is the frozen 6 November 2026 resource and validation archive.