fparodi commited on
Commit
022319d
·
verified ·
1 Parent(s): 43ab3b1

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +48 -1
README.md CHANGED
@@ -11,4 +11,51 @@ license: mit
11
  short_description: Test cross-primate face detection and facial landmark models
12
  ---
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  short_description: Test cross-primate face detection and facial landmark models
12
  ---
13
 
14
+ ---
15
+ title: PrimateFace Detection Pose and Gaze
16
+ emoji: 🐵
17
+ colorFrom: blue
18
+ colorTo: purple
19
+ sdk: gradio
20
+ sdk_version: 4.44.0
21
+ app_file: app.py
22
+ pinned: true
23
+ license: apache-2.0
24
+ tags:
25
+ - computer-vision
26
+ - object-detection
27
+ - pose-estimation
28
+ - gaze-tracking
29
+ - primates
30
+ - animals
31
+ ---
32
+
33
+ # PrimateFace Demo
34
+
35
+ State-of-the-art primate face detection, pose estimation, and gaze tracking system.
36
+
37
+ ## Features
38
+
39
+ - 🎯 **Multi-species face detection** - Trained on diverse primate species
40
+ - 📍 **68-point facial landmarks** - Detailed facial structure analysis
41
+ - 👀 **Gaze estimation** - Experimental gaze direction tracking
42
+ - 🖼️ **Image & Video support** - Process both static images and videos
43
+ - 📸 **Webcam capture** - Real-time processing from webcam
44
+
45
+ ## Model Architecture
46
+
47
+ - **Detection Backend**: MMDetection with Cascade R-CNN (ResNet101-FPN)
48
+ - **Pose Estimation**: MMPose with HRNet-W18 (68 keypoints)
49
+ - **Gaze Estimation**: Gazelle model (trained only on human faces)
50
+
51
+ ## Usage
52
+
53
+ 1. Upload an image/video or capture from webcam
54
+ 2. Select the task type (detection only, with pose, or with gaze)
55
+ 3. Adjust confidence threshold if needed
56
+ 4. Click "Detect Faces" to process
57
+
58
+ ## Note
59
+
60
+ This demo runs on a dedicated GPU server. If the server is offline, please check back later.
61
+