Hybrid AI Attendance Solution

Secure, Fast, and Smart Management

FaceAttend is a high-performance system for educational institutions, combining a lightweight mobile app for real-time attendance with a comprehensive ERP portal.

Get Started GitHub Repository

System Core

Triple-Tier Architecture

Designed for scalability and precision, our system is distributed across four robust specialized layers.

📱

Mobile Client

React Native + Expo app dedicated to high-speed "field work"—taking live attendance and viewing schedules in real-time.

React Native Expo Socket.IO

🌐

Web ERP Portal

React + Vite command center for student registration, timetable configuration, and detailed attendance analytics.

React Vite Tailwind

⚙️

Core Backend

Central Express + TypeScript API managing authentication, data integrity, and multi-service synchronization.

Node.js TypeScript MongoDB

🧠

AI Microservice

Dedicated Python service for generating 512-dimensional face embeddings and high-accuracy matching.

Python FaceNet Flask

Capabilities

Intelligent Control Center

Everything you need to manage attendance at scale, from the classroom to the administrative office.

🌐

Web ERP Portal

✓

Centralized Management: Single point for student and faculty profile management.

✓

Remote Capture: Trigger mobile cameras instantly from the web dashboard for remote enrollment.

✓

Timetable Manager: Interactive drag-and-drop weekly schedules with clash detection.

✓

Real-time Audit: Monitor every login, data change, and attendance event live.

📱

Mobile Operation

✓

0.5s Live Scanning: Continuous recognition marks students automatically as they enter.

✓

Kiosk Guard: Android-native lock-down prevents device misuse during attendance sessions.

✓

Smart Schedule: Live sync with upcoming classes and one-tap attendance activation.

✓

Offline Sync: Buffer data locally and sync instantly when connection is restored.

🔒

Enterprise-Grade Security

Protecting institutional data with hardware-level trust policies and immutable audit trails.

Device Fingerprinting

Every mobile login captures unique hardware ID, model, and OS version to prevent unauthorized access.

Trust Policy

Faculty must explicitly "Trust" a mobile device from the Web Portal before it can record secure data.

Session Integrity

JWT + Refresh Tokens with automatic expiration and force-logout capabilities for suspicious links.

Setup & Installation

Follow these steps to deploy the full stack FaceAttend system.

Prerequisites

Node.js (v18+), Python (v3.9+), MongoDB, and Expo Go for testing.

Step 1: Clone the Repository

Access the official repository via GitHub and clone it to your local workspace to begin.

                    git clone https://github.com/bsurajpatra/FaceAttend.git

                    cd FaceAttend

Step 2: Start the AI Service

                    cd facenet_service

                    pip install -r requirements.txt

                    python face_recognition_service.py

Step 3: Start the Backend API

                    cd server

                    npm install

                    # Configure .env file

                    npm run dev

Step 4: Start the Web Portal

                    cd web

                    npm install

                    npm run dev

Step 5: Start the Mobile Client

                    cd client

                    npm install

                    npx expo start

💡 Pro Tip: Use the Web CRM to "Trust" your mobile device fingerprint before attempting to take live attendance.