Skip to content

uthvah/linux-hello

Repository files navigation

🔐 Linux Hello (Face Auth)

2025-10-11 21-31-45

Face Auth Demo Python License OpenCV


Overview

Linux Hello brings secure, efficient facial recognition to the Linux ecosystem. Designed as an open-source alternative to proprietary biometric systems, it leverages deep learning to authenticate users via standard webcams.

Core Features

  • Precision Recognition: Utilizes a ResNet-34 based model via dlib for high-accuracy face matching and identification.
  • Active Liveness Detection: To verify physical presence, the system utilizes randomized challenge-response protocols. During authentication, the user is prompted to perform a specific, randomly selected sequence of actions (such as blinking, nodding, or turning their head) which must be completed in real-time to pass verification.
  • Encrypted Storage: Facial templates are hashed and secured using AES-256 encryption, ensuring biometric profiles remain inaccessible to unauthorized users.
  • Privacy-Centric: Operates entirely offline. Video feeds are processed locally, and no biometric data is transmitted to external servers.

Operational Logic

The application functions in two distinct modes:

  1. Enrollment: Upon the first execution, the system guides the user through a brief capture process to generate a secure facial profile.
  2. Authentication: On subsequent runs, the system compares the live camera feed against the encrypted profile. Simultaneously, it issues a randomized motion challenge. A successful match combined with a verified challenge response returns a success exit code, allowing for integration with authentication wrappers.

License

This project is open source and available under the MIT License.

About

Fast, secure, and modern face authentication for the Linux desktop.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors