Upload 8 files

.env

@@ -0,0 +1,39 @@
+# ==================================================
+# 🔧 FLASK CONFIGURATION
+# ==================================================
+FLASK_SECRET_KEY=super_secure_authentic_key_2026
+FLASK_DEBUG=True
+
+# ==================================================
+# 💾 DATABASE CONFIGURATION (Local MariaDB)
+# ==================================================
+DB_HOST=localhost
+DB_PORT=3306
+DB_USER=root
+DB_PASS=
+DB_NAME=face_attendance_db
+
+# ==================================================
+# 🔑 ADMIN CREDENTIALS
+# ==================================================
+ADMIN_USER=admin
+ADMIN_PASS=admin1122
+
+# ==================================================
+# 📧 EMAIL CONFIGURATION (Gmail SMTP)
+# ==================================================
+# To use Gmail:
+# 1. Enable 2-Factor Authentication on your Google Account
+# 2. Go to https://myaccount.google.com/apppasswords
+# 3. Generate an "App Password" for "Mail"
+# 4. Paste it below (no spaces)
+MAIL_SERVER=smtp.gmail.com
+MAIL_PORT=587
+MAIL_USE_TLS=True
+MAIL_USERNAME=kabeer50002@gmail.com
+MAIL_PASSWORD=umky ybhg bzyq welz
+MAIL_DEFAULT_SENDER=kabeer50002@gmail
+# ==================================================
+# 🌍 TIMEZONE (PKT = UTC+5)
+# ==================================================
+TIMEZONE_OFFSET=5

.env.example

@@ -0,0 +1,36 @@
+# ==================================================
+# 🔧 FLASK CONFIGURATION
+# ==================================================
+FLASK_SECRET_KEY=super_secure_authentic_key_2026
+FLASK_DEBUG=True
+
+# ==================================================
+# 💾 DATABASE CONFIGURATION (TiDB Cloud)
+# ==================================================
+DB_HOST=gateway01.ap-southeast-1.prod.aws.tidbcloud.com
+DB_PORT=4000
+DB_USER=3WzY1RDss8u68mi.root
+DB_PASS=lto0KuAikAJZ0AWy
+DB_NAME=face_attendance_db
+DB_SSL_CA=<CA_PATH>
+
+# ==================================================
+# 🔑 ADMIN CREDENTIALS
+# ==================================================
+ADMIN_USER=admin
+ADMIN_PASS=admin123
+
+# ==================================================
+# 📧 EMAIL CONFIGURATION (Gmail SMTP)
+# ==================================================
+# To use Gmail:
+# 1. Enable 2-Factor Authentication on your Google Account
+# 2. Go to https://myaccount.google.com/apppasswords
+# 3. Generate an "App Password" for "Mail"
+# 4. Paste it below (no spaces)
+MAIL_SERVER=smtp.gmail.com
+MAIL_PORT=587
+MAIL_USE_TLS=True
+MAIL_USERNAME=your_email@gmail.com
+MAIL_PASSWORD=your_app_password_here
+MAIL_DEFAULT_SENDER=your_email@gmail.com

.gitignore

@@ -0,0 +1,66 @@
+# ==================================================
+# 🔒 SECRETS — NEVER PUSH THESE
+# ==================================================
+.env
+
+# ==================================================
+# 🐍 PYTHON
+# ==================================================
+venv/
+.venv/
+env/
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+*.egg
+
+# ==================================================
+# 💻 IDE / EDITOR
+# ==================================================
+.vscode/
+.idea/
+*.swp
+*.swo
+*.sublime-project
+*.sublime-workspace
+.project
+.pydevproject
+.code-workspace
+
+# ==================================================
+# 🖥️ OS FILES
+# ==================================================
+.DS_Store
+Thumbs.db
+desktop.ini
+ehthumbs.db
+
+# ==================================================
+# 📦 JUNK / TEMP FILES
+# ==================================================
+# Archives that don't belong in the repo
+*.rar
+*.zip
+
+# Large text dumps
+face_attendance_web/project.txt
+face_attendance_web/highlight_project.txt
+
+# Junk files accidentally placed in templates/
+face_attendance_web/templates/merge_sort.py
+face_attendance_web/templates/new.zip.rar
+face_attendance_web/templates/new.zip.txt
+
+# ==================================================
+# 📝 LOGS
+# ==================================================
+*.log
+face_attendance_web/logs/
+
+# ==================================================
+# 🤖 CODE REVIEW GRAPH
+# ==================================================
+.code-review-graph/

Dockerfile

@@ -0,0 +1,44 @@
+FROM python:3.11-slim
+
+# Install system dependencies for dlib/face_recognition
+# Install system dependencies for dlib/face_recognition
+# Install system dependencies for dlib/face_recognition
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    cmake \
+    build-essential \
+    libopenblas-dev \
+    liblapack-dev \
+    libx11-dev \
+    libglib2.0-0 \
+    libgl1 \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+WORKDIR /app
+
+# Speed up dlib C++ compilation with parallel build
+ENV CMAKE_BUILD_PARALLEL_LEVEL=4
+
+# Install dlib FIRST as separate layer (longest step, gets cached)
+RUN pip install --no-cache-dir dlib==20.0.1
+
+# Install face_recognition_models from GitHub (avoids pkg_resources issue)
+RUN pip install --no-cache-dir git+https://github.com/ageitgey/face_recognition_models
+
+# Install remaining Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Set working directory to the Flask app
+WORKDIR /app/face_attendance_web
+
+# Create faces and logs directories
+RUN mkdir -p faces logs
+
+# Hugging Face Spaces uses port 7860
+EXPOSE 7860
+
+# Run with gunicorn on port 7860
+CMD ["gunicorn", "--bind", "0.0.0.0:7860", "--workers", "2", "--timeout", "120", "app:app"]

README.md

@@ -1,11 +1,31 @@
----
-title: Alam
-emoji: 📚
-colorFrom: indigo
-colorTo: indigo
-sdk: static
-pinned: false
-short_description: khan
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Face Attendance System
+emoji: 🎓
+colorFrom: green
+colorTo: blue
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
+# 🎓 Face Attendance System — Khushal Degree College
+
+A Flask-based web application for automated face-recognition attendance.
+
+## Features
+- 🤖 Real-time Face Recognition Attendance
+- 📸 3-Angle Student Registration (Front, Left, Right)
+- 👨‍🏫 Multi-Role System (Admin, Professor, Student)
+- 📊 Analytics Dashboard with attendance stats
+- 📧 Email Notifications via Gmail SMTP
+- 📝 Leave Management System
+- ⏰ Auto-Absent Scheduler
+
+## Tech Stack
+- **Backend:** Flask + Python
+- **Face Recognition:** dlib + face_recognition + OpenCV
+- **Database:** MySQL (TiDB Serverless)
+- **Email:** Gmail SMTP
+
+## Default Login
+- **Admin:** `admin` / `admin123`

render.yaml

@@ -0,0 +1,31 @@
+# Render.com deployment configuration
+# https://render.com/docs/yaml-spec
+
+services:
+  - type: web
+    name: face-attendance-system
+    runtime: docker
+    plan: free
+    envVars:
+      - key: FLASK_SECRET_KEY
+        generateValue: true
+      - key: FLASK_DEBUG
+        value: "False"
+      - key: DB_HOST
+        sync: false  # Set manually in Render dashboard
+      - key: DB_USER
+        sync: false
+      - key: DB_PASS
+        sync: false
+      - key: DB_NAME
+        value: face_attendance_db
+      - key: MAIL_SERVER
+        value: smtp.gmail.com
+      - key: MAIL_PORT
+        value: "587"
+      - key: MAIL_USE_TLS
+        value: "True"
+      - key: MAIL_USERNAME
+        sync: false
+      - key: MAIL_PASSWORD
+        sync: false

requirements.txt

@@ -0,0 +1,17 @@
+Flask==3.1.3
+mysql-connector-python==9.7.0
+numpy==2.4.4
+opencv-python-headless==4.13.0.92
+Werkzeug==3.1.8
+Flask-Mail==0.10.0
+APScheduler==3.11.2
+python-dotenv==1.2.2
+Pillow==12.2.0
+setuptools<81
+scipy
+ultralytics
+torch
+onnxruntime
+onnx
+insightface
+gunicorn

run.py

@@ -0,0 +1,34 @@
+"""
+Face Attendance System - Startup Script
+========================================
+Run this from the project root to start the Flask app.
+
+Usage:
+    python run.py
+"""
+import os
+import sys
+
+# Fix Windows console encoding for emoji characters
+if sys.stdout and hasattr(sys.stdout, 'reconfigure'):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+        sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+    except Exception:
+        pass
+
+# Set the working directory to face_attendance_web BEFORE importing app
+app_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'face_attendance_web')
+os.chdir(app_dir)
+sys.path.insert(0, app_dir)
+
+from app import app  # type: ignore[import-not-found]  # noqa: E402 — path set dynamically above
+
+if __name__ == '__main__':
+    # Use use_reloader=False to avoid the cwd/reloader conflict on Windows
+    app.run(
+        host='0.0.0.0',
+        port=int(os.environ.get('PORT', 5000)),
+        debug=os.environ.get('FLASK_DEBUG', 'True').lower() == 'true',
+        use_reloader=False
+    )