📌 This repository focuses on building a Face Detection Attendance System using Python, OpenCV, and Flask — integrating machine learning with real-time web functionality.
Our aim is to help beginners understand how AI and web frameworks work together, while fostering community collaboration through Hacktoberfest 2025.

Make your first open-source contribution right here 🚀
Contribute, learn, grow — and help make a greener planet! 🌍

Complete 4 pull requests between October 1–31 and get a tree planted in your name 🌳

You’ll learn how to:

• Set up and run a Flask app
• Integrate OpenCV for face detection
• Structure a Python project
• Contribute meaningfully to open source

Follow these simple steps to make your first pull request 👇

Click the Fork button (top-right corner).

git clone https://github.com/<your-username>/yesiamrajeev.git
cd yesiamrajeev

git checkout -b your-branch-name

There are multiple ways to contribute:

• Add new features or bug fixes to app.py
• Enhance the UI inside the templates/ folder
• Improve or replace images inside static/
• Add your own version of face detection code in the Attendance/ folder
• Add your profile info under content/participant/

💡 Tip: You can also improve the documentation or fix typos in this README!

To ensure your contribution is verified and fully approved:

✅ Add at least one screenshot showing:

• Your code changes running successfully
• The Flask app’s UI or output (e.g., detected faces, attendance mark screen)

✅ Attach a short screen recording (10–30 seconds) demonstrating your changes working live.
You can upload the video as:

• A .mp4 file inside the /static/demo/ folder, OR
• A public link (Google Drive, Loom, etc.) in your PR description

Example PR description:

Added enhanced face detection in app.py
Screenshot
Video demo

Without screenshots and video proof, PRs will not be merged.

pip install -r requirements.txt

python app.py

Then open your browser and visit:

http://127.0.0.1:5000/

yesiamrajeev/
├── app.py                         # Main Flask app
├── Attendance/                    # Attendance-related logic
├── static/                        # Images, CSS, JS, or demo videos
├── templates/                     # HTML templates for UI
├── haarcascade_frontalface_default.xml # Face detection model
├── requirements.txt               # Required dependencies
└── README.md                      # You are here

Make more than 4 valid PRs to different repositories to ensure all count towards Hacktoberfest.

Some repos may be excluded — so always aim for 5+ PRs!

Thanks to these wonderful people 👨🏻‍💻 who made this project better with their contributions!

✨ Want to see your name here?
Start contributing now — your PR will add you to the list automatically after merge!

👤 Maintainer: @yesiamrajeev
📧 Email: [email protected]
🌍 Location: Bhubaneswar, India

Follow and ⭐ the repo to stay updated with new contribution ideas!

“Every pull request plants a seed — let’s grow together.” 🌱