Skip to content
Vladimir Mandic edited this page Mar 14, 2021 · 49 revisions

Human Library

3D Face Detection & Rotation Tracking, Face Embedding & Recognition,
Body Pose Tracking, Hand & Finger Tracking,
Iris Analysis, Age & Gender & Emotion Prediction
& Gesture Recognition

JavaScript module using TensorFlow/JS Machine Learning library

  • Browser:
    Compatible with CPU, WebGL, WASM backends
    Compatible with both desktop and mobile platforms
    Compatible with WebWorker execution
  • NodeJS:
    Compatible with both software tfjs-node and GPU accelerated backends tfjs-node-gpu using CUDA libraries

Project pages


Wiki pages


Additional notes


Default models

Default models in Human library are:

  • Face Detection: MediaPipe BlazeFace-Back
  • Face Mesh: MediaPipe FaceMesh
  • Face Iris Analysis: MediaPipe Iris
  • Emotion Detection: Oarriaga Emotion
  • Gender Detection: Oarriaga Gender
  • Age Detection: SSR-Net Age IMDB
  • Body Analysis: PoseNet
  • Face Embedding: BecauseofAI MobileFace Embedding

Note that alternative models are provided and can be enabled via configuration
For example, PoseNet model can be switched for BlazePose model depending on the use case

For more info, see Configuration Details and List of Models




Human library is written in TypeScript 4.3
Conforming to JavaScript ECMAScript version 2020 standard
Build target is JavaScript EMCAScript version 2018


See issues and discussions for list of known limitations and planned enhancements

Suggestions are welcome!




Clone this wiki locally