👁️ Eye Lab: Gaze Tracker API

Eye Lab is an open-source tool to create eye-tracking usability tests. It started as a final undergraduate work for the Computer Engineering student Karine Pistili who made the prototype. The idea is to evolve it into a more complete and useful tool with the community's help.

The current version of the software allows users to create their usability sessions of a website, recording the webcam, screen, and mouse movements and use this information to find out where the user has been looking into the screen by using heatmaps.

👩‍💻 Setting up project locally

The project consists of two parts, this repository contains the backend of the application, and the frontend can be found here. Install it as well to have the full application running.

Prerequisites

• Python 3x

Setting Up a Virtual Environment

Linux & macOS

Step 1: Create a virtual environment

python3 -m venv venv

Step 2: Activate the virtual environment

source venv/bin/activate

Step 3: Install dependencies

pip install -r requirements.txt

Step 4: Run Flask

flask run

---

Windows

Step 1: Create a virtual environment

python -m venv venv

Step 2: Activate the virtual environment

venv\Scripts\activate

Step 3: Install dependencies

pip install -r requirements.txt

Step 4: Run Flask

flask run

---

2. Using Conda (Works on Linux, macOS, and Windows)

Step 1: Create a Conda virtual environment

conda create --name flask_env python=3.10

Step 2: Activate the environment

conda activate flask_env

Step 3: Install dependencies

pip install -r requirements.txt

Step 4: Run Flask

flask run

Additional Notes

• If you face issues running flask run, try:

  python -m flask run

• If Flask is not installed, install it manually:

  pip install flask

• On Windows, if venv\Scripts\activate doesn't work, run PowerShell as Administrator and enable scripts:

  Set-ExecutionPolicy Unrestricted -Scope Process

🧑‍🤝‍🧑 Contributing

Anyone is free to contribute to this project. Just do a pull request with your code and if it is all good we will accept it. You can also help us look for bugs if you find anything that creates an issue. To see the full list of contributions, check out the ahead commits of the "develop" branch concerning the "main" branch. Full logs of the project development can be found in the Daily Work Progress file. Hoping to see your name in the list of contributors soon! 🚀

📃 License

This software is under the MIT License.

Copyright 2021 Uramaki Lab