Face recognition

tessera-web can detect faces in images and associate them with named subjects. Once a face is assigned a name, tessera can find all images containing that person.

Enabling face detection

Face detection requires an optional face detection model. Configure the endpoint in Settings → Features → Face detection.

Detecting faces

Open an image in the detail panel. If faces are detected, bounding boxes appear over the image. Each face has a label showing the assigned name (if known) or "Unknown".

Click a bounding box to open the face panel, where you can:

• Assign a name to the face.
• Confirm or reject a suggested match.
• Remove the detection.

Finding all images of a person

Once a subject has been named, use the tag sidebar or search to find all images containing them:

subject:Alice

Or in the web search bar:

subject:Alice and year=2024

Training and matching

tessera stores a face embedding (a vector representation of the face) for each detection. When you name a face, all future detections of similar faces are automatically suggested as the same person.

The quality of matching depends on image resolution and the detection model. Detections with low confidence scores may produce more false positives.