This project is a real-time face recognition system built with human.js, Vite, and React. The system provides various metrics related to face detection and recognition, running at high frame rates to ensure efficient and accurate face recognition.
- Real-time face detection and recognition
- High frame rate processing
- Liveness detection
- Anti-spoofing checks
- Face attribute estimation
- FPS: Frames per second indicating the performance of the system.
- faceCount: Number of faces detected in the frame.
- faceConfidence: Confidence score of the detected face.
- facingCenter: Indicates if the detected face is facing the center.
- lookingCenter: Indicates if the detected face is looking at the center.
- blinkDetected: Detects if the subject has blinked, used for liveness check.
- faceSize: Size of the detected face in pixels.
- antispoofCheck: Score indicating the result of an anti-spoofing check.
- livenessCheck: Score indicating if the detected face is live.
- distance: Distance of the face from the camera.
- age: Estimated age of the detected face.
- gender: Gender estimation result.
- timeout: Status indicating if the system has experienced a timeout.
- descriptor: Unique identifier or feature vector for the detected face.
- elapsedMs: Time elapsed since the system started, in milliseconds.
- detectFPS: Frames per second for face detection.
- drawFPS: Frames per second for rendering the detected face on the screen.
- human.js: A flexible and powerful library for face detection and recognition.
- Vite: A fast build tool and development server.
- React: A JavaScript library for building user interfaces.
To run the face recognition system, follow these steps:
-
Clone the repository:
git clone https://github.com/Victor1890/human-faceid-react
-
Navigate to the project directory:
cd human-faceid-react -
Install the required dependencies:
npm install
-
Run the development server:
npm run dev
-
Open your browser and go to
http://localhost:5173to see the face recognition system in action.
To use the face recognition system, follow these steps:
- Ensure your webcam is connected and accessible by your browser.
- Open the application in your browser.
- Allow the browser to access your webcam.
- The system will start detecting faces and displaying metrics in real-time.
Here is a screenshot of the face recognition system in action:
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
This project is licensed under the MIT License.