Repo brief: ShiqiYu/libfacedetection

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T11:03:08.200Z · commit 82689db4ffd9

Verdict

Mixed — Slowing — last commit 8mo ago

• Last commit 8mo ago
• 13 active contributors
• Distributed ownership (top contributor 39% of recent commits)
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

libfacedetection is a high-speed CNN-based face detection library that achieves ~1000 FPS on optimized hardware. It detects faces in images by embedding a trained YuNet neural network as static C/C++ arrays in src/facedetectcnn-data.cpp, eliminating external model dependencies. The library accelerates detection via SIMD instructions (AVX2 on Intel, NEON on ARM) and requires only a C++ compiler—no framework dependencies. Single-library structure: core CNN detection logic in src/ (C++ arrays + detection functions), language bindings via JNI (mobile/Android/FaceDetection/app/src/main/cpp/facedetectcnn-jni.cpp), and reference examples in example/ for desktop (C++) and mobile. Build via…

Start here

Open these first:

• src/facedetectcnn.cpp — Core face detection implementation using CNN model; primary entry point for all detection operations
• src/facedetectcnn-data.cpp — Embedded CNN model weights and architecture as static C++ arrays; essential for the detection algorithm
• example/detect-image.cpp — Demonstrates the canonical API usage pattern for single-image face detection
• example/detect-camera.cpp — Shows real-time camera streaming integration; reference for video/stream processing workflows
• CMakeLists.txt — Build configuration for all platforms (Windows, Linux, ARM); controls SIMD compilation flags and target selection

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/ShiqiYu/libfacedetection.git
cd libfacedetection
mkdir build && cd build
cmake -DENABLE_AVX2=ON ..
make
./example/detect-image path/to/image.jpg

For Android: run ./build_android.sh or open mobile/Android/FaceDetection/ in Android Studio with NDK installed.

Daily commands:

Desktop (Linux/macOS): ./build/example/detect-image <image_path> or ./build/example/detect-camera. Android: compile APK via ./build_android.sh or Gradle, then install and run MainActivity.kt.

Key cautions & unknowns

• Slowing — last commit 8mo ago
• 1. facedetection_export.h must be manually created in your include path if embedding; see issue #222. 2) Optimization flags are critical: -O3 for g++, /O2 for MSVC—unoptimized builds will report artificially low FPS.…
• License evidence is incomplete or ambiguous.
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.