Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vearutop/faces
Face recognition HTTP microservice
https://github.com/vearutop/faces
dlib dlib-face-detection dlib-face-recognition face-recognition golang microservice
Last synced: 4 months ago
JSON representation
Face recognition HTTP microservice
- Host: GitHub
- URL: https://github.com/vearutop/faces
- Owner: vearutop
- License: cc0-1.0
- Created: 2023-11-01T14:42:03.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-02-01T13:41:50.000Z (about 1 year ago)
- Last Synced: 2024-10-07T17:55:24.925Z (4 months ago)
- Topics: dlib, dlib-face-detection, dlib-face-recognition, face-recognition, golang, microservice
- Language: Go
- Homepage: https://dev.to/vearutop/building-a-portable-face-recognition-application-with-go-and-dlib-12p1
- Size: 27.8 MB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# faces
[](https://wakatime.com/badge/user/d4d32a01-9dcc-43f3-96a3-fe3be55e75fd/project/018b8b57-d925-41b0-8f56-b65f8c46b532)
Face detection HTTP microservice based on [`dlib`](https://github.com/davisking/dlib-models).
## Installation
Portable statically-linked binary for Linux AMD64 is available
on [releases](https://github.com/vearutop/faces/releases).
```
wget https://github.com/vearutop/faces/releases/latest/download/linux_amd64.tar.gz && tar xf linux_amd64.tar.gz && rm linux_amd64.tar.gz
./faces -h
```
It is also available as docker image.
```
docker run --rm -p 8011:80 vearutop/faces
```
If you want to build the app from source, please follow the instructions on
[dependencies setup](https://github.com/Kagami/go-face?tab=readme-ov-file#requirements).
## Usage
```
./faces -h
Usage of ./faces:
-listen string
listen address (default "localhost:8011")
```
Start server.
```
./faces
2024/01/15 23:44:22 recognizer init 424.357089ms
2024/01/15 23:44:22 http://localhost:80/docs
```
Send request.
```
curl -X 'POST' \
'http://localhost:8011/image' \
-H 'accept: application/json' \
-H 'Content-Type: multipart/form-data' \
-F '[email protected];type=image/jpeg'
```
```json
{
"elapsedSec": 2.373028184,
"found": 4,
"faces": [
{
"Rectangle": {
"Min": {
"X": 584,
"Y": 1228
},
"Max": {
"X": 1029,
"Y": 1673
}
},
"Descriptor": [
-0.122200325,
0.10511437,
0.05358115,
0.011272355,
-0.09460048,
"............. cut here ..........."
]
}
]
}
```
This repo contains models, that were created by `Davis King `__ and are
licensed in the public domain or under CC0 1.0 Universal. See [LICENSE](./LICENSE).