openface README

The project's README from github.com/cmusatyalab/openface. As one markdown file: README.md.

OpenFace • Build Status Release License Gitter

Free and open source face recognition with deep neural networks.



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.

What's in this repository?

Citations

Please cite OpenFace in your publications if it helps your research. The following is a BibTeX and plaintext reference for our OpenFace tech report.

@techreport{amos2016openface,
  title={OpenFace: A general-purpose face recognition
    library with mobile applications},
  author={Amos, Brandon and Bartosz Ludwiczuk and Satyanarayanan, Mahadev},
  year={2016},
  institution={CMU-CS-16-118, CMU School of Computer Science},
}

B. Amos, B. Ludwiczuk, M. Satyanarayanan,
"Openface: A general-purpose face recognition library with mobile applications,"
CMU-CS-16-118, CMU School of Computer Science, Tech. Rep., 2016.

Licensing

Unless otherwise stated, the source code and trained Torch and Python model files are copyright Carnegie Mellon University and licensed under the Apache 2.0 License. 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 No MIT
facebook/fbnn Yes BSD
dlib-models (68 face landmark detector) No CC0

openface (cmusatyalab/openface)

Searching Database…

15.4K ·GitHub
Что это такое?OpenFace — бесплатный инструмент с открытым исходным кодом для распознавания лиц на основе глубоких нейронных сетей, разработанный Carnegie Mellon University.
Это готовое приложение или то, что можно подключить к своему коду?В основном это Python-библиотека (пакет 'openface') на основе нейросети на Torch/Lua, а также отдельные демо-скрипты для сравнения, классификации и веб-демо в реальном времени, а не одно законченное приложение.
Как это попробовать?Начните со скриптов в demos/: 'compare.py' проверяет, совпадают ли два фото, 'classifier.py' обучает и запускает классификатор, 'classifierwebcam.py' применяет обученный классификатор к видеопотоку с веб-камеры в реальном времени, а 'batch-represent' генерирует эмбеддинги для пакета изображений.
Нужно ли настраивать Torch и dlib перед использованием?Да: сама нейросеть работает на Torch (Lua), выравнивание лиц использует детектор 68 ключевых точек из dlib, а для удобства предоставлен Docker-образ, так что собирать весь стек вручную не нужно.
Для кого это?Это для исследователей и разработчиков, которые хотят экспериментировать с распознаванием лиц на основе глубокого обучения: верификацией и кластеризацией. Это не готовое сразу к работе потребительское приложение для обычных пользователей.
Можно ли обучить собственную модель распознавания лиц вместо встроенной?Да, в каталоге training/ есть скрипты для обучения новых нейросетевых моделей OpenFace с нуля.
Как измеряется точность?В папке evaluation/ есть скрипты, которые тестируют модель на наборе данных LFW (Labeled Faces in the Wild).
Кто финансировал это исследование?Разработку поддержал грант NSF, а также Intel, Google, Vodafone и NVIDIA.
Нужно ли ссылаться на OpenFace, если я использую его в работе?Да, в README просят, чтобы публикации, использующие OpenFace, ссылались на технический отчёт проекта, и там есть готовая запись BibTeX.
Size
24.1 MB
Stars
15.4K
Age
11y
Commits · 90 Days