# justadudewhohacks/face-api.js

JavaScript API for face detection and face recognition in the browser and nodejs with tensorflow.js

Repository: https://github.com/justadudewhohacks/face-api.js
Canonical: https://ross.abutalabs.com/products/face-apijs
Language: TypeScript
License: MIT
License Family: permissive
Topics: face-recognition, javascript, tensorflow, tfjs, face-detection, face-landmarks, tensorflowjs, js, nodejs, age-estimation, gender-recognition, emotion-recognition
Last push: 2024-01-24T09:25:35+00:00

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

## Adoption (not part of the score)
Stars 17945, forks 3887 (observed 2026-08-28T04:11:20.569572+00:00)

## What it is
A JavaScript face detection and face recognition library built on top of tensorflow.js, usable in the browser and Node.js. It provides models for face detection, landmark detection, recognition, expression recognition, and age/gender estimation.

## Use cases
- detect faces in images or webcam video in the browser
- recognize and identify faces from a reference set
- detect face landmarks like eyes, nose, and mouth
- estimate age and gender from a face photo
- recognize facial expressions and emotions in real time
- track faces in a live webcam stream

## When to choose
- you need client-side face detection or recognition without a backend
- you want a simple high-level JavaScript API on top of tensorflow.js
- you need landmarks, expressions, age, or gender estimation alongside detection
- you are building a webcam-based demo or interactive web app with face features

## When to avoid
- you need state-of-the-art accuracy or the latest model architectures
- you need server-side GPU-accelerated face recognition at scale
- you require active maintenance and frequent updates
- you need non-face object detection or general image classification

## Facets
- artifact type: library
- maturity: maintenance
- function: machine-learning, computer-vision, image-processing
- domain: computer-vision, machine-learning, web-development, artificial-intelligence
- platform: browser
- tags: face-detection, face-recognition, tensorflowjs, face-landmarks, age-estimation, gender-recognition, emotion-recognition, webcam, nodejs, javascript

## Member repositories
- justadudewhohacks/face-api.js (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:20.569572+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-29T17:02:12.862331+00:00, confidence not recorded.
  - readme: https://github.com/justadudewhohacks/face-api.js (fetched 2026-08-28T04:11:20.569572+00:00, sha 48825980bf84)
- Data as of 2026-08-30T08:39:29.467469+00:00.