# vladmandic/face-api

FaceAPI: AI-powered Face Detection & Rotation Tracking, Face Description & Recognition, Age & Gender & Emotion Prediction for Browser and NodeJS using TensorFlow/JS

Repository: https://github.com/vladmandic/face-api
Canonical: https://ross.abutalabs.com/products/face-api
Homepage: https://vladmandic.github.io/face-api/demo/webcam.html
Language: HTML
License: MIT
License Family: permissive
Topics: tensorflow, tfjs, face-api, face-detection, age-gender, emotion-detection, face-recognition
Archived: true
Last push: 2025-02-05T14:16:19+00:00

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

## Adoption (not part of the score)
Stars 1083, forks 207 (observed 2026-08-28T04:03:31.226745+00:00)

## What it is
FaceAPI is a JavaScript library built on TensorFlow/JS that provides AI-powered face detection, rotation tracking, face description and recognition, plus age, gender, and emotion prediction. It runs in both the browser and NodeJS, with demos for static images and live webcam processing.

## Use cases
- detect faces in images or webcam video in the browser
- recognize and compare faces for identity matching
- predict age, gender, and emotion from face images
- track face rotation and landmarks in real time
- run face analysis in NodeJS on image folders
- build a webcam-based face demo app

## When to choose
- you need face detection and recognition in JavaScript without a Python backend
- you want TensorFlow.js-based face analysis that works in browser and NodeJS
- you need age, gender, and emotion prediction alongside face landmarks

## When to avoid
- you need server-side high-throughput face recognition at scale
- you require native performance or GPU-accelerated Python tooling
- you need liveness/anti-spoofing or production-grade biometric security

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

## Member repositories
- vladmandic/face-api (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:31.226745+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-30T06:51:12.574267+00:00, confidence not recorded.
  - readme: https://github.com/vladmandic/face-api (fetched 2026-08-28T04:03:31.226745+00:00, sha 5925258fb992)
  - homepage: https://vladmandic.github.io/face-api/demo/webcam.html (fetched 2026-08-29T12:53:10.223836+00:00, sha 88e5d1b843ab)
- Data as of 2026-08-30T08:39:29.467469+00:00.