Procto Pulse

No room for tricks, just honest clicks


View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
   • Run The Project
   • Run The Project using Docker
3. Screenshots
4. Contributing
5. License
6. Contact

About The Project

Welcome to our cutting-edge Auto Exam Proctoring platform, where academic integrity meets advanced technology to ensure a fair and secure testing environment for all participants.

How it is done:

• Registration Process: Students are required to supply a current passport-sized photo while registering for a specific exam. During the exam, this picture is used as a reference for identity verification.

• Live Webcam Monitoring: Our system records the user's live webcam feed while the exam is in progress. We use the most recent facial recognition models to validate the candidate's identity by comparing the uploaded passport photo with the live webcam feed. This procedure guarantees that the exam-taker is, in fact, the registered student.

• Proctoring and Monitoring: In real time, our software keeps a close eye on the exam setting. Proctopulse has a feature that continuously checks the webcam feed to find any eviations or irregularities. It uses advanced facial detection techniques such as YOLOv5. Proctopulse flags instances  where

(back to top)

Built With

• React
• Node
• Express
• Mongo
• Fast-api
• Material UI
• Yolov5face
• deepface

(back to top)

Getting Started

Prerequisites

React, Node and Python must be installed (if want to use docker images make sure docker is installed on the machine)

Installation

1. Clone the repo

   https://github.com/DP-NOTHING/Procto-pulse.git

2. Install packages

   cd client
   npm install
   
   cd server
   npm install
   
   cd service
   pip install requirements.txt

3. Create env files

   in Client folder

    PORT = 
    REACT_APP_BACKEND = ''
    REACT_APP_SERVICE=''

   in server folder

    CONNECTIONSTRING = ""
    SERVICE_URL=""
    PORT = 
    JWT_SECRET = ''

Run the Project

1. start server using

cd server
npm start

2. start Service

cd service
uvicorn main:app --reload

3. Start Client

cd client
npm start

Run the Project Using Docker

The given project is dockerized. The images for all three major components are available on docker hub.

1. Python Server
   

   1. Run the container

      docker pull dm2903/proctopulse-python-service

   2. Run the container

      docker run -it -p 8000:8000 dm2903/proctopulse-python-service

   3. Your python server will be running at http://127.0.0.1:8000

2. Node Server
   

   1. Run the container

      docker pull dm2903/proctopulse-node-server

   2. Run the container (make sure to provide correct values for ENV variables)

      docker run -it -p 3000:3000 -e CONNECTIONSTRING="" -e JWT_SECRET="" -e SERVICE_URL="" -e PORT="" dm2903/proctopulse-node-server

   3. Your node server will be running at http://127.0.0.1:3000

3. React Server
   

   1. Run the container

      docker pull dm2903/proctopulse-react-client

   2. Run the container (make sure to provide correct values for ENV variables)

      docker run -it -p 3001:3001 -e REACT_APP_SERVICE="" -e REACT_APP_BACKEND="" -e PORT="" dm2903/proctopulse-react-client

      REACT_APP_SERVICE is the endpoint where Python server is running.
      REACT_APP_BACKEND is the endpoint where Node server is running.
   3. Your react server will be running at http://127.0.0.1:3001

(back to top)

ScreenShots

Teacher

Student

(back to top)

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

contact

Deep patel - @LinkedIN - [email protected] Dev Mehta Krunal Parekh

Project Link: https://github.com/DP-NOTHING/Procto-pulse

(back to top)

(back to top)