SeetaPsych Face Hub

Community open-source face modules for SeetaPsych

Usage

This project is already included in the seetapsych-lib default configuration. Download and use it via seetapsych-manager download.

For usage, refer to SeetaPsych.

You can additionally add this algorithm module using the following methods.

WebUI

Run seetapsych-webui with the --dirs argument to use it.

seetapsych-webui --files seetapsych_face_hub/modules/insightface/retinaface.yml

Programmatic Usage

Add the following code in your program to use this algorithm module.

from seetapsych_lib.runtime.factory import Factory
from seetapsych_lib.runtime.pipeline import Pipeline

factory = Factory()
factory.load_file_modules("seetapsych_face_hub/modules/insightface/retinaface.yml")

pipeline = Pipeline(factory, ...)

pipeline.add_attributes("face/detection")

Module Catalog

Module YML Packages
insightface/retinaface.yml FaceDetection-RetinaFace(InsightFace)
insightface/arcface.yml FaceFeature-ArcFace(InsightFace)
mediapipe.yml FaceDetection-MediaPipe, FaceMesh-MediaPipe
retinaface.yml FaceDetection-RetinaFace(PyTorch)

InsightFace (RetinaFace)

InsightFace Buffalo RetinaFace detector: face bounding box + 5-point landmark detection with 500M / 2.5G / 10G FLOPs model variants.

Module config: insightface/retinaface.yml

Package Name Provides Attributes Requires Attributes
FaceDetection-RetinaFace(InsightFace) face/detection, face/landmarks (none)

Description: InsightFace RetinaFace detecting face boxes + 5-point landmarks with configurable input size; 3 accuracy/speed model tiers

Parameters

Name Type Default Description & Tuning
input_size number[] [640, 640] Network input [width, height] in pixels. Larger sizes improve small-face recall but slow inference. Square inputs are recommended.

Models

Name Recommended Notes
det_500m.onnx ✓
det_2.5g.onnx
det_10g.onnx

Output Attributes

  • face/detection — spec.
  • face/landmarks — spec.

InsightFace (ArcFace)

InsightFace Buffalo face feature extraction via ArcFace models producing L2-normalized 512-dim embeddings.

Module config: insightface/arcface.yml

Package Name Provides Attributes Requires Attributes
FaceFeature-ArcFace(InsightFace) face/feature face/landmarks

Description: Extract L2-normalized 512-dim face embeddings for recognition, clustering, or similarity search from 5-point aligned faces

Parameters: (none)

Models

Name Recommended Notes
w600k_r50.onnx ✓
w600k_mbf.onnx

Output Attributes

  • face/feature — spec.

MediaPipe

MediaPipe Tasks face detection and 468-point 3D face mesh landmarking via BlazeFace short/full-range models.

Module config: mediapipe.yml

Package Name Provides Attributes Requires Attributes
FaceDetection-MediaPipe face/detection (none)
FaceMesh-MediaPipe face/mesh face/detection

Package: FaceDetection-MediaPipe

Description: Face bounding box detection via MediaPipe BlazeFace detector with short/full-range/sparse model variants

Parameters

Name Type Default Description & Tuning
running_mode selection (IMAGE, VIDEO, LIVE_STREAM) IMAGE Task execution mode. IMAGE for single static frames; VIDEO/LIVE_STREAM for time-series smoothing across frames.
min_detection_confidence number 0.5 Minimum confidence score for a detection box to be returned. Lower values catch more faces at the cost of false positives.
min_suppression_threshold number 0.3 IoU threshold for non-maximum suppression. Higher values keep more overlapping boxes; lower values prune aggressively.

Models

Name Recommended Notes
blaze_face_full_range.tflite ✓
blaze_face_full_range_sparse.tflite
blaze_face_short_range.tflite

Output Attributes

  • face/detection — spec.

Package: FaceMesh-MediaPipe

Description: 468-point normalized 3D face mesh landmark extraction from detected face boxes with optional blendshapes and pose matrices

Parameters

Name Type Default Description & Tuning
running_mode selection (IMAGE, VIDEO, LIVE_STREAM) IMAGE Task execution mode. VIDEO/LIVE_STREAM enable temporal landmark smoothing when num_faces = 1.
num_faces integer 1 Maximum number of faces to landmark simultaneously. Smoothing is only active when num_faces is 1.
min_face_detection_confidence number 0.5 Minimum confidence for the built-in face detector to succeed when initializing landmark placement.
min_face_presence_confidence number 0.5 Minimum confidence that a face is present in the frame before landmark output; filters intermittent dropouts in video.
min_tracking_confidence number 0.5 Minimum tracking confidence to reuse the last known face position vs. re-running full detection. Higher values reduce drift but trigger re-detection more often.
output_face_blendshapes boolean false Whether to output 52 face blendshape coefficients for 3D avatar/AR rendering. Adds minor compute overhead.
output_facial_transformation_matrixes boolean false Whether to output 4x4 facial pose transformation matrices for rigid head pose estimation.

Models

Name Recommended Notes
face_landmarker.task ✓

Output Attributes

  • face/mesh — spec.

References

Project links

Data verified by PyPI on Sep 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Levalup from gravatar.com Levalup

GitHub Statistics

Data verified by PyPI on Sep 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

BSD 3-Clause License

Requires

Python >=3.10

Provides Extra

all dev

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seetapsych_face_hub-0.0.3.post1.tar.gz (283.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seetapsych_face_hub-0.0.3.post1-py3-none-any.whl (63.4 kB view details)

Uploaded Python 3

File details

Details for the file seetapsych_face_hub-0.0.3.post1.tar.gz.

File metadata

File hashes

Hashes for seetapsych_face_hub-0.0.3.post1.tar.gz
Algorithm Hash digest
SHA256 e6e47ee5540e482a158e077120d0c7e42d39ee794c26d12c278fb6313eebf43b
MD5 26119b43ca1d97727118ab59481fe2f3
BLAKE2b-256 afd6cef96f545b8ab5d98b38d8d8b3542d3da517591676a4acabbc9c4fcd1dc0

See more details on using hashes here.

Provenance

The following attestation bundles were made for seetapsych_face_hub-0.0.3.post1.tar.gz:

Publisher: publish.yml on seetapsych/seetapsych-face-hub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file seetapsych_face_hub-0.0.3.post1-py3-none-any.whl.

File metadata

File hashes

Hashes for seetapsych_face_hub-0.0.3.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 ea97fc63f9fe5c7a56ab79b61549b426ed86986659bae2d9f0b4f74d7115a625
MD5 467489dde7a4c89626b435399458127f
BLAKE2b-256 ec81e4216eab62c250a4e6478163eb15cef0e28a698b2c75ad5b03830d9ba434

See more details on using hashes here.

Provenance

The following attestation bundles were made for seetapsych_face_hub-0.0.3.post1-py3-none-any.whl:

Publisher: publish.yml on seetapsych/seetapsych-face-hub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.0.3.post1 This release

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

1 file

Pre-release

0.0.1rc4

1 file

Pre-release

0.0.1rc3

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page