FlagEEG_v1

Repo of the winter EEG project by the Club d'Intelligence Artificielle of Laval University. The goal of this project is to interpret EEG signals in order to transform them into realtime game inputs.

How to get started with the project

1. Go read the project-chart.md here
2. Go read the project-organization-manual.md here

How to get started with python

1. Install python (please chose the python 3.12 version)
2. Install the Git CLI (useful stuff for any programmer)
3. Clone the FLapEEG_v1 repo with this command : git clone [email protected]:cia-ulaval/FlagEEG_v1.git (If it doesn't work, you need to setup an SSH key on your GitHub account)
4. Open the cloned repo with a Text Editor of your choice
5. Create a virtual environnement for your python dependencies with the command : python -m venv venv
6. Activate the virtual env :

• For linux, mac : source venv/bin/activate
• For Windows : venv/Scripts/activate

7. Download the dependencies : pip install -r requirements.txt

How to get started with the EEG

1. Install the OpenBCI GUI : download

This is the official OpenBCI support user interface to allow streaming and seeing data from the EEG. Please download it and follow the installation instructions.

• Download
• Installation instructions

Important for Linux users : For Linux users only, there is a necessary hardware step, to make in order to allow the necessary permissions for your USB ports. Go look at the tutorial of the fix. The fix is in the section : Linux Users: Serial Port Permissions

2. Connect your computer to the helmet

1. Connect the Daisy dongle to your USB port
2. Run the OpenBCI GUI on your computer and start a streaming session : CYTON -> Serial (from Dongle)

3. Read the OpenBCI docs

To help connect your python scripts and the EEG helmet, OpenBCI provides us with a SDK : Brainflow. Go read the docs to learn how python and the EEG interacts.