{"id":13439099,"url":"https://github.com/boltgolt/howdy","last_synced_at":"2025-05-13T15:12:14.231Z","repository":{"id":37579803,"uuid":"116322814","full_name":"boltgolt/howdy","owner":"boltgolt","description":"🛡️ Windows Hello™ style facial authentication for Linux","archived":false,"fork":false,"pushed_at":"2025-02-02T15:58:38.000Z","size":1291,"stargazers_count":6192,"open_issues_count":255,"forks_count":319,"subscribers_count":61,"default_branch":"beta","last_synced_at":"2025-04-23T18:58:55.682Z","etag":null,"topics":["arch-linux","camera","debian","face-recognition","fedora","ir-camera","linux","opensuse","pam","pam-module","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boltgolt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.buymeacoffee.com/boltgolt"}},"created_at":"2018-01-05T00:54:21.000Z","updated_at":"2025-04-23T11:14:56.000Z","dependencies_parsed_at":"2023-10-20T18:31:01.243Z","dependency_job_id":"d976abe1-fafd-470e-9b4d-b8157fc1320c","html_url":"https://github.com/boltgolt/howdy","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltgolt%2Fhowdy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltgolt%2Fhowdy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltgolt%2Fhowdy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltgolt%2Fhowdy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boltgolt","download_url":"https://codeload.github.com/boltgolt/howdy/tar.gz/refs/heads/beta","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969264,"owners_count":21992263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arch-linux","camera","debian","face-recognition","fedora","ir-camera","linux","opensuse","pam","pam-module","ubuntu"],"created_at":"2024-07-31T03:01:11.139Z","updated_at":"2025-05-13T15:12:09.218Z","avatar_url":"https://github.com/boltgolt.png","language":"Python","readme":"![](https://boltgolt.nl/howdy/banner.png)\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/boltgolt/howdy/releases\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/release/boltgolt/howdy.svg?colorB=4c1\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://github.com/boltgolt/howdy/graphs/contributors\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/contributors/boltgolt/howdy.svg?style=flat\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://www.buymeacoffee.com/boltgolt\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/badge/endpoint.svg?url=https://boltgolt.nl/howdy/shield.json\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://actions-badge.atrox.dev/boltgolt/howdy/goto?ref=beta\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fboltgolt%2Fhowdy%2Fbadge%3Fref%3Dbeta\u0026style=flat\u0026label=build\u0026logo=none\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://aur.archlinux.org/packages/howdy\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/aur/votes/howdy?color=4c1\u0026label=aur%20votes\"\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\nHowdy provides Windows Hello™ style authentication for Linux. Use your built-in IR emitters and camera in combination with facial recognition to prove who you are.\n\nUsing the central authentication system (PAM), this works everywhere you would otherwise need your password: Login, lock screen, sudo, su, etc.\n\n## Installation\n\nHowdy is currently available and packaged for Debian/Ubuntu, Arch Linux, Fedora and openSUSE. If you’re interested in packaging Howdy for your distro, don’t hesitate to open an issue.\n\n**Note:** The build of dlib can hang on 100% for over a minute, give it time.\n\n### Ubuntu or Linux Mint\n\nRun the installer by pasting (`ctrl+shift+V`) the following commands into the terminal one at a time:\n\n```\nsudo add-apt-repository ppa:boltgolt/howdy\nsudo apt update\nsudo apt install howdy\n```\n\nThis will guide you through the installation.\n\n### Debian\n\nDownload the .deb file from the [Releases page](https://github.com/boltgolt/howdy/releases) and install with gdebi.\n\n### Arch Linux\n\n_Maintainer wanted._\n\nInstall the `howdy` package from the AUR. For AUR installation instructions, take a look at this [wiki page](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages).\n\nYou will need to do some additional configuration steps. Please read the [ArchWiki entry](https://wiki.archlinux.org/index.php/Howdy) for more information.\n\n### Fedora\n\n_Maintainer: [@luyatshimbalanga](https://github.com/luyatshimbalanga)_\n\nThe `howdy` package is available as a [Fedora COPR repository](https://copr.fedorainfracloud.org/coprs/principis/howdy/), install it by simply executing the following commands in a terminal:\n\n```\nsudo dnf copr enable principis/howdy\nsudo dnf --refresh install howdy\n```\n\n*Note:* Fedora 41 [removed support for Python2](https://fedoraproject.org/wiki/Changes/RetirePython2.7), but at this point in time Howdy still depends on it. If the install fails, you can fix this by installing the beta Repository and removing the release version:\n\n```\nsudo dnf copr remove principis/howdy\nsudo dnf copr enable principis/howdy-beta\nsudo dnf --refresh install howdy\n```\n\nSee the link to the COPR repository for detailed configuration steps.\n\n### openSUSE\n\n_Maintainer: [@dmafanasyev](https://github.com/dmafanasyev)_\n\nGo to the [openSUSE wiki page](https://en.opensuse.org/SDB:Facial_authentication) for detailed installation instructions.\n\n### Building from source\n\nIf you want to build Howdy from source, a few dependencies are required.\n\n#### Dependencies\n\n- Python 3.6 or higher\n  * pip\n  * setuptools\n  * wheel\n- meson version 0.64 or higher\n- ninja\n- INIReader (can be pulled from git automatically if not found)\n- libevdev\n\nTo install them on Debian/Ubuntu for example:\n\n```\nsudo apt-get update \u0026\u0026 sudo apt-get install -y \\\npython3 python3-pip python3-setuptools python3-wheel \\\ncmake make build-essential \\\nlibpam0g-dev libinih-dev libevdev-dev python3-opencv \\\npython3-dev libopencv-dev\n```\n\n#### Build\n\n```sh\nmeson setup build\nmeson compile -C build\n```\n\nYou can also install Howdy to your system with `meson install -C build`.\n\n## Setup\n\nAfter installation, Howdy needs to learn what you look like so it can recognise you later. Run `sudo howdy add` to add a face model.\n\nIf nothing went wrong we should be able to run sudo by just showing your face. Open a new terminal and run `sudo -i` to see it in action. Please check [this wiki page](https://github.com/boltgolt/howdy/wiki/Common-issues) if you're experiencing problems or [search](https://github.com/boltgolt/howdy/issues) for similar issues.\n\nIf you're curious you can run `sudo howdy config` to open the central config file and see the options Howdy has to offer. On most systems this will open the nano editor, where you have to press `ctrl`+`x` to save your changes.\n\n## CLI\n\nThe installer adds a `howdy` command to manage face models for the current user. Use `howdy --help` or `man howdy` to list the available options.\n\nUsage:\n```\nhowdy [-U user] [-y] command [argument]\n```\n\n| Command   | Description                                   |\n|-----------|-----------------------------------------------|\n| `add`     | Add a new face model for a user               |\n| `clear`   | Remove all face models for a user             |\n| `config`  | Open the config file in your default editor   |\n| `disable` | Disable or enable howdy                       |\n| `list`    | List all saved face models for a user         |\n| `remove`  | Remove a specific model for a user            |\n| `snapshot`| Take a snapshot of your camera input          |\n| `test`    | Test the camera and recognition methods       |\n| `version` | Print the current version number              |\n\n## Contributing [![](https://img.shields.io/travis/boltgolt/howdy/dev.svg?label=dev%20build)](https://github.com/boltgolt/howdy/tree/dev) [![](https://img.shields.io/github/issues-raw/boltgolt/howdy/enhancement.svg?label=feature+requests\u0026colorB=4c1)](https://github.com/boltgolt/howdy/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)\n\nThe easiest ways to contribute to Howdy is by starring the repository and opening GitHub issues for features you'd like to see. If you want to do more, you can also [buy me a coffee](https://www.buymeacoffee.com/boltgolt).\n\nCode contributions are also very welcome. If you want to port Howdy to another distro, feel free to open an issue for that too.\n\n## Troubleshooting\n\nAny Python errors get logged directly into the console and should indicate what went wrong. If authentication still fails but no errors are printed, you could take a look at the last lines in `/var/log/auth.log` to see if anything has been reported there.\n\nPlease first check the [wiki on common issues](https://github.com/boltgolt/howdy/wiki/Common-issues) and \nif you encounter an error that hasn't been reported yet, don't be afraid to open a new issue.\n\n## A note on security\n\nThis package is in no way as secure as a password and will never be. Although it's harder to fool than normal face recognition, a person who looks similar to you, or a well-printed photo of you could be enough to do it. Howdy is a more quick and convenient way of logging in, not a more secure one.\n\nTo minimize the chance of this program being compromised, it's recommended to leave Howdy in `/lib/security` and to keep it read-only.\n\nDO NOT USE HOWDY AS THE SOLE AUTHENTICATION METHOD FOR YOUR SYSTEM.\n","funding_links":["https://www.buymeacoffee.com/boltgolt"],"categories":["HarmonyOS","Python","InfoSec","Guide for Linux Users","ubuntu","Privacy/Security"],"sub_categories":["Windows Manager","Security","Faical Recognition","Other"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboltgolt%2Fhowdy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboltgolt%2Fhowdy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboltgolt%2Fhowdy/lists"}