/Driver-Snoozing-System

A driver snoozing system is a safety feature that detects and alerts a driver who is exhibiting signs of fatigue, with the goal of reducing the risk of accidents and injuries caused by drowsy driving.

Primary LanguagePython

Driver-Snoozing-System

The Driver-Snoozing-System is a machine learning system designed to detect when a driver is falling asleep at the wheel and alert them before an accident occurs. The system uses the shape_predictor_68_face_landmarks.dat file, which contains data about the location of 68 facial landmarks on a person's face, to analyze the driver's face and determine if they are exhibiting signs of drowsiness.

How to Contribute?

  • Take a look at the existing Issues
  • Fork the Repo create a branch for any issue that you are working on and commit your work.
  • Create a ** Pull Request, which will be promptly reviewed and given suggestions for improvements by the community.
  • Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes that are included in your commits.

How to make a Pull Request?

1. Start by forking the Driver-Snoozing-System repository. Click on the symbol at the top right corner.

2. Clone your forked repository:

git clone https://github.com/<your-github-username>/Driver-Snoozing-System.git

3. Navigate to the new project directory:

cd Driver-Snoozing-System

4. Set upstream command:

git remote add upstream https://github.com/Deep-ghosty/Driver-Snoozing-System.git

5. Create a new branch:

git checkout -b YourBranchName

or

git branch YourBranchName
git switch YourBranchName

6. Sync your fork or local repository with the origin repository:

  • In your forked repository click on "Fetch upstream"
  • Click "Fetch and merge".

Alternatively, Git CLI way to Sync forked repository with origin repository:

git fetch upstream
git merge upstream/main

Github Docs for Syncing

7. Make your changes to the source code.

8. Stage your changes and commit:

⚠️ Make sure not to commit package.json or package-lock.json file

⚠️ Make sure not to run the commands git add . or git add *. Instead, stage your changes for each file/folder

git add file/folder
git commit -m "<your_commit_message>"

9. Push your local commits to the remote repository:

git push origin YourBranchName

10. Create a Pull Request!

11. Congratulations! You've made your first contribution! 🙌🏼

Usage

  • Clone the repository:
git clone https://github.com/Deep-ghosty/driver-snoozing-system.git
  • Install the necessary libraries:
pip install -r requirements.txt
  • Run the snoozing detection script:
python driver_drowsiness.py

Acknowledgments

  • The shape_predictor_68_face_landmarks.dat file was trained using the dlib library.
  • The face detection functionality is based on the OpenCV library.

Repo holders Ekansh rajput 🔗🔗 https://github.com/Regression1607 Divyansh mittal 🔗🔗 ttps://github.com/Divyansh-Mitta01