2015-10-13 20:02:12 +08:00
|
|
|
# OpenFace
|
|
|
|
|
|
2015-11-12 00:51:56 +08:00
|
|
|
*Free and open source face recognition with
|
|
|
|
|
deep neural networks.*
|
|
|
|
|
|
2015-10-15 23:25:46 +08:00
|
|
|
[ ![Build Status] [travis-image] ] [travis]
|
|
|
|
|
[ ![Release] [release-image] ] [releases]
|
|
|
|
|
[ ![License] [license-image] ] [license]
|
2015-10-19 00:16:27 +08:00
|
|
|
[ ![Gitter] [gitter-image] ] [gitter]
|
2015-10-15 23:25:46 +08:00
|
|
|
|
|
|
|
|
[travis-image]: https://travis-ci.org/cmusatyalab/openface.png?branch=master
|
|
|
|
|
[travis]: http://travis-ci.org/cmusatyalab/openface
|
|
|
|
|
|
2015-10-15 23:27:18 +08:00
|
|
|
[release-image]: http://img.shields.io/badge/release-0.1.1-blue.svg?style=flat
|
2015-10-15 23:25:46 +08:00
|
|
|
[releases]: https://github.com/cmusatyalab/openface/releases
|
|
|
|
|
|
|
|
|
|
[license-image]: http://img.shields.io/badge/license-Apache--2-blue.svg?style=flat
|
|
|
|
|
[license]: LICENSE
|
|
|
|
|
|
2015-10-19 00:16:27 +08:00
|
|
|
[gitter-image]: https://badges.gitter.im/Join%20Chat.svg
|
|
|
|
|
[gitter]: https://gitter.im/cmusatyalab/openface
|
|
|
|
|
|
2015-10-25 02:27:55 +08:00
|
|
|
---
|
|
|
|
|
|
2015-11-03 06:41:09 +08:00
|
|
|
+ Website: http://cmusatyalab.github.io/openface/
|
2015-12-25 07:48:06 +08:00
|
|
|
+ [API Documentation](http://openface-api.readthedocs.org/en/latest/index.html)
|
2015-11-03 06:41:09 +08:00
|
|
|
+ Join the
|
|
|
|
|
[cmu-openface group](https://groups.google.com/forum/#!forum/cmu-openface)
|
|
|
|
|
or the
|
|
|
|
|
[gitter chat](https://gitter.im/cmusatyalab/openface)
|
|
|
|
|
for discussions and installation issues.
|
|
|
|
|
+ Development discussions and bugs reports are on the
|
|
|
|
|
[issue tracker](https://github.com/cmusatyalab/openface/issues).
|
2015-09-25 02:47:17 +08:00
|
|
|
|
2015-11-15 04:35:42 +08:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
This research was supported by the National Science Foundation (NSF)
|
|
|
|
|
under grant number CNS-1518865. Additional support
|
|
|
|
|
was provided by the Intel Corporation, Google, Vodafone, NVIDIA, and the
|
|
|
|
|
Conklin Kistler family fund. Any opinions, findings, conclusions or
|
|
|
|
|
recommendations expressed in this material are those of the authors
|
|
|
|
|
and should not be attributed to their employers or funding sources.
|
|
|
|
|
|
2015-12-05 22:09:02 +08:00
|
|
|
# What's in this repository?
|
|
|
|
|
+ [batch-represent](https://github.com/cmusatyalab/openface/tree/master/batch-represent): Generate representations from
|
|
|
|
|
a batch of images, stored in a directory by names.
|
|
|
|
|
+ [demos/web](https://github.com/cmusatyalab/openface/tree/master/demos/web): Real-time web demo.
|
|
|
|
|
+ [demos/compare.py](https://github.com/cmusatyalab/openface/tree/master/demos/compare.py): Demo to compare two images.
|
|
|
|
|
+ [demos/vis-outputs.lua](https://github.com/cmusatyalab/openface/tree/master/demos/vis-outputs.lua): Demo to
|
|
|
|
|
visualize the network's outputs.
|
|
|
|
|
+ [demos/classifier.py](https://github.com/cmusatyalab/openface/tree/master/demos/classifier.py): Demo to train and use classifiers.
|
|
|
|
|
+ [evaluation](https://github.com/cmusatyalab/openface/blob/master/evaluation): LFW accuracy evaluation scripts.
|
|
|
|
|
+ [openface](https://github.com/cmusatyalab/openface/tree/master/openface): Python library code.
|
|
|
|
|
+ [models](https://github.com/cmusatyalab/openface/tree/master/models): Model directory for openface and 3rd party libraries.
|
|
|
|
|
+ [training](https://github.com/cmusatyalab/openface/tree/master/training): Scripts to train new OpenFace models.
|
|
|
|
|
+ [util](https://github.com/cmusatyalab/openface/tree/master/util): Utility scripts.
|
|
|
|
|
|
2015-11-12 00:51:56 +08:00
|
|
|
# Citations
|
|
|
|
|
|
|
|
|
|
The following is a [BibTeX](http://www.bibtex.org/)
|
|
|
|
|
and plaintext reference
|
|
|
|
|
for the OpenFace GitHub repository.
|
|
|
|
|
The reference may change in the future.
|
|
|
|
|
The BibTeX entry requires the `url` LaTeX package.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
@misc{amos2015openface,
|
|
|
|
|
title = {{OpenFace: Face Recognition with Deep Neural Networks}},
|
|
|
|
|
author = {Amos, Brandon and Harkes, Jan and Pillai, Padmanabhan and Elgazzar, Khalid and Satyanarayanan, Mahadev},
|
|
|
|
|
howpublished = {\url{http://github.com/cmusatyalab/openface}},
|
|
|
|
|
note = {Accessed: 2015-11-11}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
Brandon Amos, Jan Harkes, Padmanabhan Pillai, Khalid Elgazzar,
|
|
|
|
|
and Mahadev Satyanarayanan.
|
|
|
|
|
OpenFace: Face Recognition with Deep Neural Networks.
|
|
|
|
|
http://github.com/cmusatyalab/openface.
|
|
|
|
|
Accessed: 2015-11-11.
|
|
|
|
|
```
|
|
|
|
|
|
2015-09-25 02:47:17 +08:00
|
|
|
# Licensing
|
2015-10-13 01:18:23 +08:00
|
|
|
The source code and trained models `nn4.v1.t7` and
|
|
|
|
|
`celeb-classifier.nn4.v1.t7` are copyright
|
|
|
|
|
Carnegie Mellon University and licensed under the
|
|
|
|
|
[Apache 2.0 License](./LICENSE).
|
2015-09-25 02:47:17 +08:00
|
|
|
Portions from the following third party sources have
|
|
|
|
|
been modified and are included in this repository.
|
|
|
|
|
These portions are noted in the source files and are
|
|
|
|
|
copyright their respective authors with
|
|
|
|
|
the licenses listed.
|
|
|
|
|
|
|
|
|
|
Project | Modified | License
|
|
|
|
|
---|---|---|
|
|
|
|
|
[Atcold/torch-TripletEmbedding](https://github.com/Atcold/torch-TripletEmbedding) | No | MIT
|
|
|
|
|
[facebook/fbnn](https://github.com/facebook/fbnn) | Yes | BSD
|
