human
Human: AI-powered 3D Face Detection & Rotation Tracking, Face Description & Recognition, Body Pose Tracking, 3D Hand & Finger Tracking, Iris Analysis, Age & Gender & Emotion Prediction, Gaze Tracking, Gesture Recognition
File Explorer
- issue.md
- pull_request_template.md
- codeql-analysis.yml
- FUNDING.yml
- settings.json
- facemesh.png
- icon.png
- lato-light.woff2
- README.md
- samples.jpg
- screenshot-facedetect.jpg
- screenshot-faceid.jpg
- screenshot-facematch.jpg
- screenshot-menu.png
- screenshot-results.png
- screenshot-typedoc.png
- screenshot-vrm.jpg
- facedetect.js
- index.html
- index.html
- index.js
- index.js.map
- index.ts
- indexdb.ts
- README.md
- facematch.js
- faces.json
- index.html
- node-match-worker.js
- node-match.js
- README.md
- gl-bench.js
- jsonview.js
- menu.js
- README.md
- webrtc.js
- index.html
- index.js
- node-multiprocess-worker.js
- node-multiprocess.js
- README.md
- worker.js
- node-age-gender.js
- node-bench.js
- node-canvas.js
- node-event.js
- node-fetch.js
- node-similarity.js
- node-simple.js
- node-video.js
- node-webcam.js
- node.js
- process-folder.js
- README.md
- index.html
- index.js
- index.html
- index.js
- index.js.map
- index.ts
- README.md
- tracker.js
- index.html
- index.js
- index.js.map
- index.ts
- README.md
- index.html
- favicon.ico
- icons.css
- index-pwa.js
- index-worker.js
- index.html
- index.js
- manifest.webmanifest
- offline.html
- README.md
- human.d.ts
- human.esm-nobundle.d.ts
- human.esm-nobundle.js
- human.esm.d.ts
- human.esm.js
- human.esm.js.map
- human.js
- human.node-gpu.d.ts
- human.node-gpu.js
- human.node-wasm.d.ts
- human.node-wasm.js
- human.node.d.ts
- human.node.js
- tfjs.esm.d.ts
- tfjs.esm.js
- tfjs.version.js
- antispoof.bin
- antispoof.json
- blazeface.bin
- blazeface.json
- centernet.bin
- centernet.json
- emotion.bin
- emotion.json
- facemesh.bin
- facemesh.json
- faceres.bin
- faceres.json
- handlandmark-lite.bin
- handlandmark-lite.json
- handtrack.bin
- handtrack.json
- iris.bin
- iris.json
- liveness.bin
- liveness.json
- models.json
- movenet-lightning.bin
- movenet-lightning.json
- README.md
- ai-body.jpg
- ai-face.jpg
- ai-upper.jpg
- background.jpg
- cgi-model-1.jpg
- cgi-model-10.jpg
- cgi-model-11.jpg
- cgi-model-12.jpg
- cgi-model-13.jpg
- cgi-model-14.jpg
- cgi-model-15.jpg
- cgi-model-18.jpg
- cgi-model-19.jpg
- cgi-model-2.jpg
- cgi-model-20.jpg
- cgi-model-21.jpg
- cgi-model-22.jpg
- cgi-model-23.jpg
- cgi-model-24.jpg
- cgi-model-25.jpg
- cgi-model-26.jpg
- cgi-model-27.jpg
- cgi-model-28.jpg
- cgi-model-29.jpg
- cgi-model-3.jpg
- cgi-model-30.jpg
- cgi-model-31.jpg
- cgi-model-33.jpg
- cgi-model-34.jpg
- cgi-model-4.jpg
- cgi-model-5.jpg
- cgi-model-6.jpg
- cgi-model-7.jpg
- cgi-model-8.jpg
- cgi-model-9.jpg
- cgi-multiangle-1.jpg
- cgi-multiangle-10.jpg
- cgi-multiangle-11.jpg
- cgi-multiangle-2.jpg
- cgi-multiangle-3.jpg
- cgi-multiangle-4.jpg
- cgi-multiangle-6.jpg
- cgi-multiangle-7.jpg
- cgi-multiangle-8.jpg
- cgi-multiangle-9.jpg
- group-1.jpg
- group-2.jpg
- group-3.jpg
- group-4.jpg
- group-5.jpg
- group-6.jpg
- group-7.jpg
- person-celeste.jpg
- person-christina.jpg
- person-lauren.jpg
- person-lexi.jpg
- person-linda.jpg
- person-nicole.jpg
- person-tasia.jpg
- person-tetiana.jpg
- person-vlado.jpg
- person-vlado1.jpg
- person-vlado5.jpg
- solvay1927.jpg
- stock-emotions-a-1.jpg
- stock-emotions-a-2.jpg
- stock-emotions-a-3.jpg
- stock-emotions-a-4.jpg
- stock-emotions-a-5.jpg
- stock-emotions-a-6.jpg
- stock-emotions-a-7.jpg
- stock-emotions-a-8.jpg
- stock-emotions-b-1.jpg
- stock-emotions-b-2.jpg
- stock-emotions-b-3.jpg
- stock-emotions-b-4.jpg
- stock-emotions-b-5.jpg
- stock-emotions-b-6.jpg
- stock-emotions-b-7.jpg
- stock-emotions-b-8.jpg
- stock-group-1.jpg
- stock-group-2.jpg
- stock-models-1.jpg
- stock-models-10.jpg
- stock-models-11.jpg
- stock-models-12.jpg
- stock-models-13.jpg
- stock-models-14.jpg
- stock-models-15.jpg
- stock-models-16.jpg
- stock-models-2.jpg
- stock-models-3.jpg
- stock-models-4.jpg
- stock-models-5.jpg
- stock-models-6.jpg
- stock-models-7.jpg
- stock-models-8.jpg
- stock-models-9.jpg
- stock-teen-1.jpg
- stock-teen-2.jpg
- stock-teen-3.jpg
- stock-teen-4.jpg
- stock-teen-5.jpg
- stock-teen-6.jpg
- stock-teen-7.jpg
- stock-teen-8.jpg
- ai-body.jpg
- ai-face.jpg
- ai-upper.jpg
- cgi-model-1.jpg
- cgi-model-10.jpg
- cgi-model-11.jpg
- cgi-model-12.jpg
- cgi-model-13.jpg
- cgi-model-14.jpg
- cgi-model-15.jpg
- cgi-model-18.jpg
- cgi-model-19.jpg
- cgi-model-2.jpg
- cgi-model-20.jpg
- cgi-model-21.jpg
- cgi-model-22.jpg
- cgi-model-23.jpg
- cgi-model-24.jpg
- cgi-model-25.jpg
- cgi-model-26.jpg
- cgi-model-27.jpg
- cgi-model-28.jpg
- cgi-model-29.jpg
- cgi-model-3.jpg
- cgi-model-30.jpg
- cgi-model-31.jpg
- cgi-model-33.jpg
- cgi-model-34.jpg
- cgi-model-4.jpg
- cgi-model-5.jpg
- cgi-model-6.jpg
- cgi-model-7.jpg
- cgi-model-8.jpg
- cgi-model-9.jpg
- cgi-multiangle-1.jpg
- cgi-multiangle-10.jpg
- cgi-multiangle-11.jpg
- cgi-multiangle-2.jpg
- cgi-multiangle-3.jpg
- cgi-multiangle-4.jpg
- cgi-multiangle-6.jpg
- cgi-multiangle-7.jpg
- cgi-multiangle-8.jpg
- cgi-multiangle-9.jpg
- group-1.jpg
- group-2.jpg
- group-3.jpg
- group-4.jpg
- group-5.jpg
- group-6.jpg
- group-7.jpg
- person-celeste.jpg
- person-christina.jpg
- person-lauren.jpg
- person-lexi.jpg
- person-linda.jpg
- person-nicole.jpg
- person-tasia.jpg
- person-tetiana.jpg
- person-vlado.jpg
- person-vlado1.jpg
- person-vlado5.jpg
- solvay1927.jpg
- stock-emotions-a-1.jpg
- stock-emotions-a-2.jpg
- stock-emotions-a-3.jpg
- stock-emotions-a-4.jpg
- stock-emotions-a-5.jpg
- stock-emotions-a-6.jpg
- stock-emotions-a-7.jpg
- stock-emotions-a-8.jpg
- stock-emotions-b-1.jpg
- stock-emotions-b-2.jpg
- stock-emotions-b-3.jpg
- stock-emotions-b-4.jpg
- stock-emotions-b-5.jpg
- stock-emotions-b-6.jpg
- stock-emotions-b-7.jpg
- stock-emotions-b-8.jpg
- stock-group-1.jpg
- stock-group-2.jpg
- stock-models-1.jpg
- stock-models-10.jpg
- stock-models-11.jpg
- stock-models-12.jpg
- stock-models-13.jpg
- stock-models-14.jpg
- stock-models-15.jpg
- stock-models-16.jpg
- stock-models-2.jpg
- stock-models-3.jpg
- stock-models-4.jpg
- stock-models-5.jpg
- stock-models-6.jpg
- stock-models-7.jpg
- stock-models-8.jpg
- stock-models-9.jpg
- stock-teen-1.jpg
- stock-teen-2.jpg
- stock-teen-3.jpg
- stock-teen-4.jpg
- stock-teen-5.jpg
- stock-teen-6.jpg
- stock-teen-7.jpg
- stock-teen-8.jpg
- index.html
- README.md
- blazepose.ts
- blazeposecoords.ts
- blazeposedetector.ts
- efficientpose.ts
- efficientposecoords.ts
- movenet.ts
- movenetcoords.ts
- movenetfix.ts
- posenet.ts
- posenetutils.ts
- body.ts
- draw.ts
- face.ts
- gesture.ts
- hand.ts
- labels.ts
- object.ts
- options.ts
- primitives.ts
- angles.ts
- anthropometry.ts
- antispoof.ts
- attention.ts
- blazeface.ts
- constants.ts
- face.ts
- faceboxes.ts
- facemesh.ts
- facemeshcoords.ts
- facemeshutil.ts
- faceres.ts
- insightface.ts
- iris.ts
- liveness.ts
- mask.ts
- match.ts
- mobilefacenet.ts
- emotion.ts
- gear.ts
- ssrnet-age.ts
- ssrnet-gender.ts
- gesture.ts
- fingerdef.ts
- fingergesture.ts
- fingerpose.ts
- handpose.ts
- handposeanchors.ts
- handposedetector.ts
- handposepipeline.ts
- handposeutil.ts
- handtrack.ts
- enhance.ts
- image.ts
- imagefx.ts
- imagefxshaders.ts
- centernet.ts
- labels.ts
- nanodet.ts
- meet.ts
- rvm.ts
- selfie.ts
- backend.ts
- constants.ts
- humangl.ts
- load.ts
- types.ts
- eslint.json
- long.d.ts
- offscreencanvas.d.ts
- tfjs.esm.d.ts
- tsconfig.json
- webgpu.d.ts
- box.ts
- env.ts
- interpolate.ts
- persons.ts
- profile.ts
- util.ts
- webcam.ts
- config.ts
- exports.ts
- human.ts
- models.ts
- README.md
- result.ts
- sample.ts
- warmup.ts
- browser.sh
- build.log
- node.js
- README.md
- test-backend-node-cpu.js
- test-backend-node-gpu.js
- test-backend-node-wasm.js
- test-backend-node.js
- test-browser-esm.html
- test-browser-esm.js
- test-browser-iife.html
- test-browser-iife.js
- test-browser-worker.js
- test-node-emotion.js
- test-node-gear.js
- test-node-load.js
- test-node-main.js
- test.log
- tf-browser.ts
- tf-node-gpu.ts
- tf-node-wasm.ts
- tf-node.ts
- tf-version.ts
- hierarchy.js
- highlight.css
- icons.js
- icons.svg
- main.js
- navigation.js
- search.js
- style.css
- Env.html
- Human.html
- models.Models.html
- Rank.html
- draw.all.html
- draw.body.html
- draw.canvas.html
- draw.face.html
- draw.gesture.html
- draw.hand.html
- draw.init.html
- draw.object.html
- draw.person.html
- draw.tensor.html
- empty.html
- match.distance.html
- match.find.html
- match.similarity.html
- models.validateModel.html
- BodyConfig.html
- BodyKeypoint.html
- BodyResult.html
- Config.html
- DrawOptions.html
- FaceAntiSpoofConfig.html
- FaceAttentionConfig.html
- FaceConfig.html
- FaceDescriptionConfig.html
- FaceDetectorConfig.html
- FaceEmotionConfig.html
- FaceGearConfig.html
- FaceIrisConfig.html
- FaceLivenessConfig.html
- FaceMeshConfig.html
- FaceResult.html
- FilterConfig.html
- GenericConfig.html
- GestureConfig.html
- GraphModel.html
- HandConfig.html
- HandResult.html
- ModelInfo.html
- models.KernelOps.html
- models.ModelStats.html
- ObjectConfig.html
- ObjectResult.html
- PersonResult.html
- Result.html
- SegmentationConfig.html
- Tensor.html
- WebCam.html
- WebCamConfig.html
- draw.html
- match.html
- models.html
- Tensor.html
- AnyCanvas.html
- AnyImage.html
- AnyVideo.html
- BackendEnum.html
- BodyAnnotation.html
- BodyAnnotationBlazePose.html
- BodyAnnotationEfficientPose.html
- BodyGesture.html
- BodyLandmark.html
- BodyLandmarkBlazePose.html
- BodyLandmarkEfficientNet.html
- BodyLandmarkMoveNet.html
- BodyLandmarkPoseNet.html
- Box.html
- Emotion.html
- Events.html
- ExternalCanvas.html
- FaceGesture.html
- FaceLandmark.html
- Finger.html
- FingerCurl.html
- FingerDirection.html
- Gender.html
- GestureResult.html
- HandGesture.html
- HandType.html
- ImageObjects.html
- Input.html
- IrisGesture.html
- match.Descriptor.html
- match.MatchOptions.html
- ObjectType.html
- Point.html
- Race.html
- SegmentationEnum.html
- Tensor1D.html
- Tensor2D.html
- Tensor3D.html
- Tensor4D.html
- TensorLike.html
- WarmupEnum.html
- defaults.html
- draw.options.html
- env.html
- .nojekyll
- hierarchy.html
- index.html
- .eslintrc.json
- human.d.ts
- tfjs-core.d.ts
- tfjs.esm.d.ts
- tsconfig.json
- .api-extractor.json
- .build.json
- .eslintrc.json
- .gitignore
- .gitmodules
- .hintrc
- .markdownlint.json
- .npmignore
- .npmrc
- build.js
- CHANGELOG.md
- CODE_OF_CONDUCT
- CONTRIBUTING
- favicon.ico
- human.service
- LICENSE
- package.json
- README.md
- SECURITY.md
- TODO.md
- tsconfig.json
- wiki
# Installation Guide
nodeSetup Steps
npm install
Install project dependencies.
npm run build
Build the project.
Key Commands
npm install
Installs all required package dependencies for the project.
npm run build
Builds the source code and generates distribution artifacts.
# Use via CDN
jsDelivrjsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.
Release Timeline
- 2024-02-15 Human Release v3.2
- 2023-09-18 Human Release v3.1
- 2022-11-22 Human Release v3.0
- 2022-10-13 Human Release v2.11
- 2022-09-07 Human Release v2.10
- 2022-07-25 Human Release v2.9
- 2022-06-08 Human Release v2.8
- 2022-05-09 Human Release v2.7
- 2022-01-20 Human Release v2.6
- 2021-12-15 Human Release v2.5.6
Command Glossary
Commands referenced in this DOCs, explained below.
ffmpeg
View Details ▼
ffmpeg
Video conversion tool.
See also: `gst-launch-1.0`.
ffmpeg -i {{path/to/video.mp4}} -vn {{path/to/sound.mp3}}
Extract the sound from a video and save it as MP3:
ffmpeg -i {{path/to/input_audio.flac}} -ar 44100 -sample_fmt s16 {{path/to/output_audio.wav}}
Transcode a FLAC file to Red Book CD format (44100kHz, 16bit):
ffmpeg -i {{path/to/video.mp4}} {{[-vf|-filter:v]}} 'scale=-1:1000' -r 15 {{path/to/output.gif}}
Save a video as GIF, scaling the height to 1000px and setting framerate to 15:
fswebcam
View Details ▼
fswebcam
Small and simple webcam for *nix.
fswebcam {{filename}}
Take a picture:
fswebcam {{[-r|--resolution]}} {{width}}x{{height}} {{filename}}
Take a picture with custom resolution:
fswebcam {{[-d|--device]}} {{device}} {{filename}}
Take a picture from selected device(Default is `/dev/video0`):
