alexandrebarachant/muse-lsl

Python script to stream EEG data from the muse 2016 headset

What it solves

Muse LSL provides a way to stream, visualize, and record EEG (electroencephalogram) data from InteraXon Muse devices. It bridges the gap between consumer-grade EEG hardware and research-standard data collection by integrating with the Lab Streaming Layer (LSL) system, which allows for time-synchronized data streams across a network.

How it works

The project operates as both a command-line tool and a Python library. It connects to Muse devices (Muse 2, Muse S, and the original Muse) via Bluetooth using various backends like bleak. Once connected, it captures raw sensor data and broadcasts it as LSL streams. Users can then use the tool to view the data in real-time, record it to CSV files, or integrate the stream into their own Python applications for further analysis.

Who it’s for

It is designed for researchers, developers, and hobbyists working with brain-computer interfaces (BCI) and EEG-based experiments who need a standardized way to acquire and synchronize EEG data from Muse headbands.

Highlights

  • Multi-device support: Compatible with Muse 2, Muse S, and the classic Muse.
  • LSL Integration: Uses Lab Streaming Layer to enable network-wide time synchronization and near real-time access.
  • Comprehensive sensor data: Supports streaming not just EEG, but also PPG (photoplethysmography), accelerometer, and gyroscope data.
  • Flexible usage: Available as a standalone CLI tool for quick setup or a Python library for custom integration.
  • Built-in visualization: Includes a data viewer to monitor signals in real-time.

Related

  • Project
    huangjunsen0406/py-xiaozhi

    py‑xiaozhi is a Python‑based, async‑first framework for building multimodal AI assistants that can listen, speak, see, and control hardware. It offers real‑time Opus voice streaming, offline wake‑word detection, vision‑language integration, a JSON‑RPC tool server, and secure WebSocket/MQTT communication. Runs on Windows/macOS/Linux desktops and on edge boards (Raspberry Pi, Jetson Nano). Provides GUI (PySide6/QML), CLI, and GPIO modes, and a plugin system for easy extension.

  • Project
    mne-tools/mne-python

    An open-source Python package for exploring, visualizing, and analyzing human neurophysiological data like MEG and EEG.

  • Project
    evidentlyai/evidently

    An open-source Python framework to evaluate, test, and monitor ML and LLM-powered systems, helping developers detect data drift and ensure output quality.

  • Project
    sipeed/MaixPy

    A Python SDK and ecosystem for creating AI projects on edge devices, providing simple APIs for AI vision, audio, and LLMs on MaixCAM hardware.

  • Project
    elevenlabs/elevenlabs-python

    The official Python SDK for ElevenLabs, enabling developers to integrate lifelike AI text-to-speech, voice cloning, and real-time conversational AI agents into their applications.