GazeFacial authentication for Linux

Facial authentication for Linux with on-device face recognition, PAM integration, and tools for login, lock screen, sudo, and desktop management.

Get started

Install

GitHub

Quick install

bash

curl -fsSL https://gaze.gundulabs.com/install.sh | sh

Supports Debian, Ubuntu, Fedora, Arch, and Manjaro

Security warning

Gaze includes local liveness anti-spoofing, but it is still not a substitute for strong system authentication. Do not use it as your only authentication factor for security-critical systems.

Quick setup

Install packages, start gazed, enroll a face, and test authentication from the CLI.

Start setup

Desktop login

Use Gaze with GNOME login, lock screen, GDM, or Hyprland's hyprlock.

Configure desktop auth

PAM integration

Add facial authentication to sudo, login managers, and other PAM-backed flows.

Read the PAM guide

CLI and GUI tools

Enroll, test, remove profiles, and manage authentication from the terminal or GTK app.

See the CLI

Local-first

Face templates stay on your machine. The root daemon owns the ML pipeline and DBus API.

How it works

Troubleshooting

Fix camera selection, daemon startup, DBus permissions, PAM lockouts, and model issues.

Debug issues