You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
PrimateFace contains data, models, and tutorials for analyzing facial behavior across primates ([Parodi et al., 2025](https://www.biorxiv.org/content/10.1101/2025.08.12.669927v2)).
23
+
PrimateFace contains data, models, and tutorials for analyzing facial behavior across primates ([Parodi et al., 2025](https://www.biorxiv.org/content/10.1101/2025.08.12.669927)).
24
24
25
25
This codebase enables you to use an off-the-shelf PrimateFace model for tracking facial movements or you can quickly fine-tune a PrimateFace model.
26
26
27
-
Most of the PrimateFace modules require GPU access. If you don't have access to a GPU, you can still use PrimateFace in Google Colab (see [notebooks](https://docs.primateface.studio/notebooks/index.html)).
27
+
Most of the PrimateFace modules require GPU access. If you don't have access to a GPU, you can still use PrimateFace in Google Colab (see [tutorials](https://docs.primateface.studio/tutorials/)).
28
28
29
29
30
30
<palign="center">
@@ -35,7 +35,7 @@ Most of the PrimateFace modules require GPU access. If you don't have access to
35
35
#### **Quick Start**
36
36
1. Test the [Hugging Face demo](https://huggingface.co/datasets/fparodi/PrimateFace) to get a feel for the capabilities of PrimateFace on your own data.
37
37
38
-
2. Run through the [Google Colab Notebook tutorials](https://docs.primateface.studio/notebooks/index.html) to explore several applications of PrimateFace.
38
+
2. Run through the [Google Colab Notebook tutorials](https://docs.primateface.studio/tutorials/) to explore several applications of PrimateFace.
39
39
40
40
3. Clone this repository, install the dependencies, and run through the different modules (e.g., DINOv2, image and video demos, pseudo-labeling GUI, etc.) to fully utilize PrimateFace.
41
41
@@ -118,18 +118,16 @@ Note: You may see a harmless `RequestsDependencyWarning` about urllib3 versions
|**1. Lemur Face Visibility Time-Stamping**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/blob/main/demos/notebooks/App1_Lemur_time_stamping.ipynb)|
128
-
|**2. Rapid Macaque Face Recognition**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/blob/main/demos/notebooks/App2_Macaque_Face_Recognition.ipynb)|
|**4. Human Infant Social Gaze Tracking**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/blob/main/demos/notebooks/App4_Gaze_following.ipynb)|
131
-
|**5. Data-Driven Discovery of Facial Actions**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/blob/main/demos/notebooks/App5_Data_Driven_Discovery_of_Facial_Actions.ipynb)|
132
-
|**6. Cross-Subject Neural Decoding of Facial Actions**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/blob/main/demos/notebooks/App6_Cross_Subject_Neural_Decoding_of_Facial_Actions.ipynb)|
125
+
|**1. Lemur Face Visibility Time-Stamping**|[](https://colab.research.google.com/github/KordingLab/PrimateFace/blob/main/demos/notebooks/App1_Lemur_time_stamping.ipynb)|
126
+
|**2. Rapid Macaque Face Recognition**|[](https://colab.research.google.com/github/KordingLab/PrimateFace/blob/main/demos/notebooks/App2_Macaque_Face_Recognition.ipynb)|
127
+
|**4. Human Infant Social Gaze Tracking**|[](https://colab.research.google.com/github/KordingLab/PrimateFace/blob/main/demos/notebooks/App4_Gaze_following.ipynb)|
128
+
|**3. Howler Vocal-Motor Coupling**|Coming soon|
129
+
|**5. Data-Driven Discovery of Facial Actions**|Coming soon|
130
+
|**6. Cross-Subject Neural Decoding of Facial Actions**|Coming soon|
"Welcome! This tutorial notebook walks through using a **PrimateFace** detection model to automatically find and timestamp primate faces in videos, creating a 'visibility baseline' for behavioral coding.\n",
"Welcome! This tutorial notebook demonstrates a complete, closed-set face recognition pipeline. That is, given a set of images with corresponding primate IDs, we will chain together PrimateFace models with off-the-shelf face recognition models to achieve rapid identity recognition.\n",
"Welcome! This tutorial notebook demonstrates a gaze-following heuristic for videos containing two primates. It uses models from the **PrimateFace** and **Gazelle** projects to analyze social attention dynamics.\n",
Copy file name to clipboardExpand all lines: demos/notebooks/README.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,13 +2,13 @@
2
2
3
3
These notebooks are designed to help you get started with PrimateFace.
4
4
5
-
These correspond to the scientific applications outlined in the PrimateFace [paper](https://www.biorxiv.org/content/10.1101/2025.08.12.669927v2).
5
+
These correspond to the scientific applications outlined in the PrimateFace [paper](https://www.biorxiv.org/content/10.1101/2025.08.12.669927).
6
6
7
7
| Tutorial | Open in Colab |
8
8
|---------|----------------|
9
-
|**1. Lemur Face Visibility Time-Stamping**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/demos/notebooks/App1_Lemur_time_stamping.ipynb)|
10
-
|**2. Rapid Macaque Face Recognition**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/demos/notebooks/App2_Macaque_Face_Recognition.ipynb)|
|**4. Human Infant Social Gaze Tracking**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/demos/notebooks/App4_Gaze_following.ipynb)|
13
-
|**5. Data-Driven Discovery of Facial Actions**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/demos/notebooks/App5_Data_Driven_Discovery_of_Facial_Actions.ipynb)|
14
-
|**6. Cross-Subject Neural Decoding of Facial Actions**|[](https://colab.research.google.com/github/PrimateFace/primateface_oss/demos/notebooks/App6_Cross_Subject_Neural_Decoding_of_Facial_Actions.ipynb)|
9
+
|**1. Lemur Face Visibility Time-Stamping**|[](https://colab.research.google.com/github/KordingLab/PrimateFace/blob/main/demos/notebooks/App1_Lemur_time_stamping.ipynb)|
10
+
|**2. Rapid Macaque Face Recognition**|[](https://colab.research.google.com/github/KordingLab/PrimateFace/blob/main/demos/notebooks/App2_Macaque_Face_Recognition.ipynb)|
11
+
|**4. Human Infant Social Gaze Tracking**|[](https://colab.research.google.com/github/KordingLab/PrimateFace/blob/main/demos/notebooks/App4_Gaze_following.ipynb)|
12
+
|**3. Howler Vocal-Motor Coupling**|Coming soon|
13
+
|**5. Data-Driven Discovery of Facial Actions**|Coming soon|
14
+
|**6. Cross-Subject Neural Decoding of Facial Actions**|Coming soon|
0 commit comments