# Face Recognition
Recognize and manipulate faces from Python or from the command line with
the world's simplest face recognition library.
Built using [dlib](http://dlib.net/)'s state-of-the-art face recognition
built with deep learning. The model has an accuracy of 99.38% on the
[Labeled Faces in the Wild](http://vis-www.cs.umass.edu/lfw/) benchmark.
This also provides a simple `face_recognition` command line tool that lets
you do face recognition on a folder of images from the command line!
[![PyPI](https://img.shields.io/pypi/v/face_recognition.svg)](https://pypi.python.org/pypi/face_recognition)
[![Build Status](https://travis-ci.org/ageitgey/face_recognition.svg?branch=master)](https://travis-ci.org/ageitgey/face_recognition)
[![Documentation Status](https://readthedocs.org/projects/face-recognition/badge/?version=latest)](http://face-recognition.readthedocs.io/en/latest/?badge=latest)
## Features
#### Find faces in pictures
Find all the faces that appear in a picture:
![](https://cloud.githubusercontent.com/assets/896692/23625227/42c65360-025d-11e7-94ea-b12f28cb34b4.png)
```python
import face_recognition
image = face_recognition.load_image_file("your_file.jpg")
face_locations = face_recognition.face_locations(image)
```
#### Find and manipulate facial features in pictures
Get the locations and outlines of each person's eyes, nose, mouth and chin.
![](https://cloud.githubusercontent.com/assets/896692/23625282/7f2d79dc-025d-11e7-8728-d8924596f8fa.png)
```python
import face_recognition
image = face_recognition.load_image_file("your_file.jpg")
face_landmarks_list = face_recognition.face_landmarks(image)
```
Finding facial features is super useful for lots of important stuff. But you can also use for really stupid stuff
like applying [digital make-up](https://github.com/ageitgey/face_recognition/blob/master/examples/digital_makeup.py) (think 'Meitu'):
![](https://cloud.githubusercontent.com/assets/896692/23625283/80638760-025d-11e7-80a2-1d2779f7ccab.png)
#### Identify faces in pictures
Recognize who appears in each photo.
![](https://cloud.githubusercontent.com/assets/896692/23625229/45e049b6-025d-11e7-89cc-8a71cf89e713.png)
```python
import face_recognition
known_image = face_recognition.load_image_file("biden.jpg")
unknown_image = face_recognition.load_image_file("unknown.jpg")
biden_encoding = face_recognition.face_encodings(known_image)[0]
unknown_encoding = face_recognition.face_encodings(unknown_image)[0]
results = face_recognition.compare_faces([biden_encoding], unknown_encoding)
```
You can even use this library with other Python libraries to do real-time face recognition:
![](https://cloud.githubusercontent.com/assets/896692/24430398/36f0e3f0-13cb-11e7-8258-4d0c9ce1e419.gif)
See [this example](https://github.com/ageitgey/face_recognition/blob/master/examples/facerec_from_webcam_faster.py) for the code.
## Installation
Requirements:
* Python 3+ or Python 2.7
* macOS or Linux (Windows untested)
* [Also can run on a Raspberry Pi 2+ (follow these specific instructions)](https://gist.github.com/ageitgey/1ac8dbe8572f3f533df6269dab35df65)
* A [pre-configured VM image](https://medium.com/@ageitgey/try-deep-learning-in-python-now-with-a-fully-pre-configured-vm-1d97d4c3e9b) is also available.
Install this module from pypi using `pip3` (or `pip2` for Python 2):
```bash
pip3 install face_recognition
```
IMPORTANT NOTE: It's very likely that you will run into problems when pip tries to compile
the `dlib` dependency. If that happens, check out this guide to installing
dlib from source (instead of from pip) to fix the error:
[How to install dlib from source](https://gist.github.com/ageitgey/629d75c1baac34dfa5ca2a1928a7aeaf)
After manually installing `dlib`, try running `pip3 install face_recognition`
again to complete your installation.
If you are still having trouble installing this, you can also try out this
[pre-configured VM](https://medium.com/@ageitgey/try-deep-learning-in-python-now-with-a-fully-pre-configured-vm-1d97d4c3e9b).
## Usage
#### Command-Line Interface
When you install `face_recognition`, you get a simple command-line program
called `face_recognition` that you can use to recognize faces in a
photograph or folder full for photographs.
First, you need to provide a folder with one picture of each person you
already know. There should be one image file for each person with the
files named according to who is in the picture:
![known](https://cloud.githubusercontent.com/assets/896692/23582466/8324810e-00df-11e7-82cf-41515eba704d.png)
Next, you need a second folder with the files you want to identify:
![unknown](https://cloud.githubusercontent.com/assets/896692/23582465/81f422f8-00df-11e7-8b0d-75364f641f58.png)
Then in you simply run the command `face_recognition`, passing in
the folder of known people and the folder (or single image) with unknown
people and it tells you who is in each image:
```bash
$ face_recognition ./pictures_of_people_i_know/ ./unknown_pictures/
/unknown_pictures/unknown.jpg,Barack Obama
/face_recognition_test/unknown_pictures/unknown.jpg,unknown_person
```
There's one line in the output for each face. The data is comma-separated
with the filename and the name of the person found.
An `unknown_person` is a face in the image that didn't match anyone in
your folder of known people.
##### Adjusting Tolerance / Sensitivity
If you are getting multiple matches for the same person, it might be that
the people in your photos look very similar and a lower tolerance value
is needed to make face comparisons more strict.
You can do that with the `--tolerance` parameter. The default tolerance
value is 0.6 and lower numbers make face comparisons more strict:
```bash
$ face_recognition --tolerance 0.54 ./pictures_of_people_i_know/ ./unknown_pictures/
/unknown_pictures/unknown.jpg,Barack Obama
/face_recognition_test/unknown_pictures/unknown.jpg,unknown_person
```
If you want to see the face distance calculated for each match in order
to adjust the tolerance setting, you can use `--show-distance true`:
```bash
$ face_recognition --show-distance true ./pictures_of_people_i_know/ ./unknown_pictures/
/unknown_pictures/unknown.jpg,Barack Obama,0.378542298956785
/face_recognition_test/unknown_pictures/unknown.jpg,unknown_person,None
```
##### More Examples
If you simply want to know the names of the people in each photograph but don't
care about file names, you could do this:
```bash
$ face_recognition ./pictures_of_people_i_know/ ./unknown_pictures/ | cut -d ',' -f2
Barack Obama
unknown_person
```
##### Speeding up Face Recognition
Face recognition can be done in parallel if you have a computer with
multiple CPU cores. For example if your system has 4 CPU cores, you can
process about 4 times as many images in the same amount of time by using
all your CPU cores in parallel.
If you are using Python 3.4 or newer, pass in a `--cpus <number_of_cpu_cores_to_use>` parameter:
```bash
$ face_recognition --cpus 4 ./pictures_of_people_i_know/ ./unknown_pictures/
```
You can also pass in `--cpus -1` to use all CPU cores in your system.
#### Python Module
You can import the `face_recognition` module and then easily manipulate
faces with just a couple of lines of code. It's super easy!
API Docs: [https://face-recognition.readthedocs.io](https://face-recognition.readthedocs.io/en/latest/face_recognition.html).
##### Automatically find all the faces in an image
```python
import face_recognition
image = face_recognition.load_image_file("my_picture.jpg")
face_locations = face_recognition.face_locations(image)
# face_locations is now an array listing the co-ordinates of each face!
```
See [this example](https://github.com/ageitgey/face_recognition/blob/master/examples/find_faces_in_picture.py)
to try it out.
You can also opt-in to a somewhat more accurate deep-learning-based face detection model.
Note: GPU acceleration (via nvidia's CUDA library) is required for good
performance with this m
没有合适的资源?快使用搜索试试~ 我知道了~
资源推荐
资源详情
资源评论
收起资源包目录
face_recognition-master.zip (68个子文件)
face_recognition-master
MANIFEST.in 264B
.travis.yml 371B
README.rst 16KB
docs
history.rst 28B
conf.py 9KB
usage.rst 2KB
make.bat 6KB
installation.rst 1KB
modules.rst 85B
authors.rst 28B
readme.rst 27B
Makefile 7KB
index.rst 302B
contributing.rst 33B
face_recognition.rst 178B
AUTHORS.rst 573B
requirements_dev.txt 204B
.github
ISSUE_TEMPLATE.md 327B
Dockerfile 1KB
CONTRIBUTING.rst 3KB
tests
test_face_recognition.py 11KB
__init__.py 24B
test_images
obama_partial_face2.jpg 467KB
obama2.jpg 180KB
obama.jpg 273KB
obama3.jpg 582KB
32bit.png 867KB
biden.jpg 345KB
obama_partial_face.jpg 413KB
tox.ini 279B
LICENSE 1KB
face_recognition
cli.py 5KB
__init__.py 246B
api.py 9KB
requirements_docs.txt 0B
HISTORY.rst 2KB
setup.cfg 508B
requirements.txt 75B
examples
facerec_from_webcam.py 2KB
find_facial_features_in_picture.py 1KB
digital_makeup.py 1KB
alex-lacamoire.png 178KB
find_faces_in_picture_cnn.py 1KB
find_faces_in_picture.py 907B
obama-240p.jpg 36KB
obama-1080p.jpg 378KB
obama-720p.jpg 197KB
find_faces_in_batches.py 2KB
lin-manuel-miranda.png 492KB
facerec_from_webcam_faster.py 3KB
recognize_faces_in_pictures.py 1KB
benchmark.py 2KB
obama2.jpg 180KB
obama.jpg 273KB
obama-480p.jpg 100KB
hamilton_clip.mp4 4.9MB
biden.jpg 345KB
web_service_example.py 5KB
face_distance.py 2KB
obama_small.jpg 33KB
short_hamilton_clip.mp4 600KB
facerec_on_raspberry_pi.py 2KB
facerec_from_video_file.py 3KB
setup.py 2KB
.gitignore 795B
Makefile 2KB
README.md 15KB
.editorconfig 292B
共 68 条
- 1
资源评论
- weiwen69332017-10-26资源不错,好评
- Slaiad2017-11-21这个怎么用?没有一个说明文档什么的吗?表示我不会用啊
爱学习的虫子
- 粉丝: 16
- 资源: 4
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功