Somnus, a tunable, open-source platform for automated EEG sleep scoring in physiological and disease mouse models

Many studies using mouse models of human brain disorders rely on extended recordings of brain electrical activity through electroencephalogram, or EEG. The features that researchers measure in these recordings, such as seizures and epileptiform activity, are deeply influenced by whether the animal is awake, in non-rapid eye movement (NREM) sleep, or in rapid eye movement (REM) sleep. Because total sleep duration varies naturally across animals, rigorous experimental comparisons require classifying the sleep state of every few seconds of a recording. Manual annotation is highly labor-intensive, often requiring hours per subject. While automated scoring tools accelerate this process, they are typically trained exclusively on healthy cohorts and frequently fail when applied to disease models that exhibit atypical or fragmented sleep architecture. Somnus is an open-source Python package designed to automate rodent sleep staging using EEG, muscle activity (EMG), and optional video-tracking data. It includes a robust base model trained on diverse recordings from six independent laboratories, enabling out-of-the-box classification across various equipment setups without requiring prior manual labeling. A central feature of Somnus is its capacity for rapid adaptation to pathological sleep structure. The software provides a graphical interface that directs researchers to the specific epochs where the base model is least certain. Users can manually correct these targeted epochs in a built-in viewer by comparing the model's classification to the raw EEG signal and video, and then use their corrections to fine-tune the model. This workflow empowers researchers to generate accurate custom scorers for complex disease models or novel treatments with just a few minutes of manual correction, bypassing the need to hand-score entire experimental cohorts or develop their own models from scratch.