# natanielruiz/deep-head-pose

:fire::fire: Deep Learning Head Pose Estimation using PyTorch.

Repository: https://github.com/natanielruiz/deep-head-pose
Canonical: https://ross.abutalabs.com/products/deep-head-pose
Language: Python
License: NOASSERTION
License Family: other
Topics: head-pose-estimation, head-pose, face-pose, gaze-estimation, gaze, head, deep-learning, deep-neural-networks
Last push: 2023-05-23T08:43:50+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3199, "days_push": 1198, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1666, forks 367 (observed 2026-08-28T04:05:19.108816+00:00)

## What it is
Hopenet is a PyTorch deep learning model for fine-grained head pose estimation from images and video, without requiring facial keypoints. It ships pre-trained models on the 300W-LP dataset and scripts for testing on videos using dlib or custom face detections.

## Use cases
- estimate head pose from images or video
- estimate yaw pitch roll of a face with deep learning
- run head pose estimation on video frames with face detection
- use a pretrained head pose network in a research project
- track head orientation for gaze or driver monitoring applications

## When to choose
- you need accurate head pose angles (yaw, pitch, roll) from a PyTorch model
- you want pretrained weights and video inference scripts out of the box
- you are doing research on head pose or gaze estimation and want a CVPR-published baseline

## When to avoid
- you need a maintained production library with active support or a permissive license
- you have no GPU available, since inference currently requires one
- you need keypoint-based or lightweight CPU-only head pose estimation

## Facets
- artifact type: library
- maturity: maintenance
- function: deep-learning, computer-vision, image-processing, machine-learning
- domain: computer-vision, deep-learning, machine-learning, artificial-intelligence
- platform: python
- tags: head-pose-estimation, hopenet, gaze-estimation, pytorch, face-pose, pretrained-models, cvpr, gpu

## Member repositories
- natanielruiz/deep-head-pose (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:19.108816+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:42:59.854544+00:00, confidence not recorded.
  - readme: https://github.com/natanielruiz/deep-head-pose (fetched 2026-08-28T04:05:19.108816+00:00, sha b767a54e5d36)
- Data as of 2026-08-30T08:39:29.467469+00:00.