3.0 KiB
FaceAPI
Forked from face-api.js version 0.22.2 released on March 22nd, 2020
Note
I don't plan to maintain a separate distribution of face-api.js, this is only a temporary repository to use latest available face-api with latest available tensorflow/js as original face-api.js is not compatible with tfjs 2.0+.
If original repository is updated, this one will become obsolete.
Differences
-
Removed tests, docs, examples
-
Updated all package dependencies
-
Modified to make compatible with TensorFlow/JS 2.0+
-
Trivial code changes for updated TypeScript type checking
-
Removed unnecesary package dependencies (karma, jasmine, etc.)
-
Updated Typescript build process to target ES2018 instead of dual ES5/ES6
-
Changed browser bundle process to use ESBuild instead of Rollup
-
Updated dependencies to @tensorflow/tfjs since backends were removed from @tensorflow/tfjs-core
-
Removed following models as they are either obsolete or non-functional with tfjs 2.0+
- mtcnn: Mostly obsolete
- tinyYolov2: Non-functional since weights are missing
-
Updated newer version for mobileNetv1 model from https://github.com/yeephycho/tensorflow-face-detection
Note that updated model was in TF Frozen format and needed to be converted to TFJS Graph format
Which means valid models are tinyFaceDetector and mobileNetv1
Due to reduced code and changed build process, resulting bundle is about 2x smaller than the original!
Weights
Pretrained models are includes in ./weights and uplodaed using GIT LFS support.
Build
Both ./build and ./dist folders are included by default, so no need for build during install.
However, if you want to rebuild use:
npm run build
Which will compile everything in ./src into ./build and create both standard and minified bundles as well as a sourcemap in ./dist
Documentation
For documentation refer to original project
Todo
face-api.js mobilenetv1 model actuall comes from https://github.com/yeephycho/tensorflow-face-detection which has been updated for tfjs@2.0 compatibility. unfortunately, model provided at https://drive.google.com/open?id=0B5ttP5kO_loUdWZWZVVrN2VmWFk is in frozen format, so needed to convert it to tfjs graph model:
summarize_graph
--in_graph="./frozen_inference_graph_face.pb"
--print_structure=false Found 4 possible outputs: (name=detection_boxes, op=Identity) (name=detection_scores, op=Identity) (name=detection_classes, op=Identity) (name=num_detections, op=Identity) tensorflowjs_converter
--input_format tf_frozen_model
--output_format tfjs_graph_model
--skip_op_check
--strip_debug_ops=True
--weight_shard_size_bytes 4194304
--output_node_names detection_boxes,detection_scores,num_detections
./frozen_inference_graph_face.pb
./converted/ cat converted/model.json | sed 's/group1-/ssd_mobilenetv1_model-/g' > converted/ssd_mobilenetv1_model-weights_manifest.json rm converted/model.json