human-models/README.md

# Human Models

Link to [Human main repository](https://github.com/vladmandic/human)  

For model details and credits see [documentation in the main library](https://github.com/vladmandic/human/wiki/Models)  

Default models are included in the main library  

Optional models are published here to keep the size of the main library contained  

## Usage

`Human` includes default models but supports number of additional models and model variations of existing models  

Additional models can be accessed via:
 - [GitHub repository](https://github.com/vladmandic/human-models)
 - [NPMjs package](https://www.npmjs.com/package/@vladmandic/human-models)

To use alternative models from local host:
- download them either from *github* or *npmjs* and either
- set human configuration value `modelPath` for each model or
- set global configuration value `baseModelPath` to location of downloaded models

To use alternative models from a CDN use location prefix `https://cdn.jsdelivr.net/gh/vladmandic/human-models/models/` for either configuration value of `modelPath` or `baseModelPath`

<br>

## List of Included Models

**Pose detection alternatives**

- `movenet-lightning`
- `movenet-thunder`
- `movenet-multipose`
- `efficientpose`
- `posenet`
- `blazepose-lite`
- `blazepose-full`
- `blazepose-heavy`

**HandPose and HandTrack family:**

- `handdetect`
- `handtrack`
- `handskeleton`
- `handlandmark-full`
- `handlandmark-lite`
- `handlandmark-sparse`

**Object detection:**

- `mb3-centernet`
- `nanodet`

**Segmentation:**

- `meet`
- `selfie`

**Face analysis:**

- `blazeface`
- `blazeface-back`
- `blazeface-front`
- `age`
- `emotion`
- `faceboxes`
- `facemesh`
- `facemesh-attention`
- `faceres`
- `faceres-deep`
- `gear`
- `gender`
- `gender-ssrnet-imdb`
- `iris`
- `liveness`
- `mobileface`
- `mobilefacenet`