https://github.com/andriykalashnykov/go-faces-http
https://github.com/andriykalashnykov/go-faces-http
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/andriykalashnykov/go-faces-http
- Owner: AndriyKalashnykov
- License: cc0-1.0
- Created: 2024-10-19T04:28:58.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-02-19T14:11:10.000Z (8 months ago)
- Last Synced: 2025-02-24T06:49:50.067Z (8 months ago)
- Language: Go
- Size: 26.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-faces-http
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/AndriyKalashnykov/go-faces-htdtp/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 'image=@faces.jpg;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).