Project Overview

This is an independant application that requires only a Bitalino sensor set to capture, display and analyze the EEG signal acquired from a subject. This application is also developed as the project for Innovation and Complexity Management and Media Management courses. Analysis code and hardware connection code can be found in the analysis notebook as well. Note that the analysis code is not as same as the one used in the application (for example pandas library is not included in the application).

Prerequisites

• Python 3.11
• 'devenv' for environment management

Below is the set up and running for users. Make sure that you include the .env file. The environment variables are added in repository settings at codespace so no need fro manually importing .env. The app can be run with docker compose. Database dump is also included in the compose file so static data is served on the graph.

Note on verification: Running locally you can also have the OTP verification functionality which is tested and working, but for the purpose of containerization I excluded this feature (commented) so a simple login will direct to graph display page. This happens because the API_KEY is not read with docker nor on codespace with variables.

Project Setup (Devs)

1. Clone the repository:

git clone git@github.com:yashar2028/Biosignal_Processing.git
cd Biosignal_Processing

2. This project uses Nix for managing your project environment. Follow this command to install: (skip if Nix is already installed)

sh <(curl -L https://nixos.org/nix/install)

Install devenv from Nix packages (if not installed):

nix-env -iA nixpkgs.devenv

3. Run the setup script to enter developement environment:

./scripts/setup.sh

4. Run the database and then start the server:

./scripts/start_db.sh
poetry run uvicorn main:app --reload

Run the app (Users)

docker-compose up --build

Contributers

Backend Developement: Yashar Najafi

Signal Processing and Hardware Connection: Sina Najafi

Sensor Hardware and Hardware Connection: Sepehr Hajimokhtar

Frontend Developement: Parnian Taji