https://github.com/wzulfikar/facegrep

Find faces in photo using Rustface.
https://github.com/wzulfikar/facegrep

Last synced: about 2 months ago
JSON representation

Find faces in photo using Rustface.

• Host: GitHub
• URL: https://github.com/wzulfikar/facegrep
• Owner: wzulfikar
• Created: 2022-11-03T23:52:23.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2022-11-04T13:02:52.000Z (almost 2 years ago)
• Last Synced: 2024-07-03T14:52:45.084Z (3 months ago)
• Language: Rust
• Size: 4.05 MB
• Stars: 15
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
facegrep


I want to learn Rust and found about [Rustface](https://github.com/atomashpolskiy/rustface) (which is a port of [C++ SeetaFace Engine](https://github.com/seetaface/SeetaFaceEngine)). It detects faces in a picture. What interesting is it doesn't need external dependencies (eg. opencv).

I think it'll be a good exercise.

## Goal

- [x] Use the [example code](https://github.com/atomashpolskiy/rustface/blob/master/examples/image_demo.rs) from rustface as base

- [x] Get model path from environment variable so users don't have to put it as argument

- [x] Show output file (image file with bounding boxes)

- [x] Add json support

## Usage

```sh

# Clone repo

git clone --depth 1 https://github.com/wzulfikar/facegrep

# Download model from Rustface repo

curl -L -O --output-dir /tmp https://github.com/atomashpolskiy/rustface/raw/master/model/seeta_fd_frontal_v1.0.bin

# Expose the model as environment variable

export RUSTFACE_MODEL=/tmp/seeta_fd_frontal_v1.0.bin

# Run the binary with the test image

cargo run assets/test/scientists.jpg

# Use --json flag to show json output

cargo run assets/test/scientists.jpg --json

```

If you don't want to install Rust cargo:

- for M1, try use the binary at `bin/facegrep-m1`

- for Windows (Rust target x86_64-pc-windows-gnu), try use `bin/facegrep-win`

You'll still need to download the model and expose its path as environment variable.

## Preview



▲▼▲


**Note to self:**

- JSON should be properly handled instead of just string-concatenated ([main.rs#L57](https://github.com/wzulfikar/facegrep/blob/5d02d6c9a9eac9c78327e71e76fd9f116ccaf461/src/main.rs#L57), [L69](https://github.com/wzulfikar/facegrep/blob/5d02d6c9a9eac9c78327e71e76fd9f116ccaf461/src/main.rs#L69))

- If I want to reuse the code in web, how difficult is it to port to wasm? Would there be performance penalty?

- Took me 1 hour to put this together. How long will it take me to do similar thing after I learn more Rust?