| name | face |
| description | Remember someone's face, save it permanently with their consent, or forget someone. You can also add more angles of a known person.
|
| metadata | {"author":"reachy-nova","version":"1.0"} |
Face Skill
Manage face recognition and identity for people you interact with.
Parameters
- operation (string, required): The face operation to perform
- name (string, optional): Full name of the person (required for consent, forget, add_angles, merge, whois)
- unique_id (string, optional): Face ID (required for forget, add_angles, merge, images)
- target_id (string, optional): Second face ID for merge operations
- target_name (string, optional): Second face name for merge operations
Operations
remember
Remember the face currently visible in the camera temporarily (15 minutes).
No name needed. Returns a temporary ID.
consent
Save a temporarily remembered face permanently. Requires the temp_id (from remember)
and the person's full name. The person must explicitly consent to being saved.
forget
Delete a permanently saved face. Requires unique_id and full_name.
Admin faces cannot be deleted.
add_angles
Add another angle/view of a known person for better recognition.
The person should be visible in the camera. Requires unique_id and full_name.
merge
Combine two face entries that are the same person. Keeps the first ID,
merges embeddings from the second. Requires unique_id + name and target_id + target_name.
list (admin only)
List all known faces with their IDs and details.
count (admin only)
Get the total number of known faces.
images (admin only)
Get embedding file paths for a specific person. Requires unique_id and name.
whois (admin only)
Look up a person's unique_id by their name.
Examples
- "Remember my face" → operation: remember
- "Save me permanently as John Smith" → operation: consent, name: "John Smith"
- "Forget face abc1 John Smith" → operation: forget, unique_id: "abc1", name: "John Smith"
- "Add another angle for abc1 John Smith" → operation: add_angles, unique_id: "abc1", name: "John Smith"
- "How many faces do you know?" → operation: count
- "Who is stored as Jane Doe?" → operation: whois, name: "Jane Doe"
