FacePsy Mood Screening

Detect depressive mood tendencies from facial features using client-side MediaPipe and FacePsy AU CNN.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/Bright2704/Depression --skill facepsy-mood-screening
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: FacePsy Mood Screening
Source: https://github.com/Bright2704/Depression/tree/main
Command: npx skills add https://github.com/Bright2704/Depression --skill facepsy-mood-screening

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Privacy-preserving mood screening using facial features, enabling non-intrusive mental wellbeing assessments without storing raw images.

Core Features & Use Cases

  • Real-time extraction of facial landmarks, action units (AUs), head pose, and derived mood risk to support depression screening in consumer wellness apps.
  • Privacy-by-design: on-device processing with anonymized vectors stored locally; optional data sharing with explicit consent.
  • Use Case: researchers or telewellness platforms can monitor mood trends across days/weeks while preserving user privacy.

Quick Start

Ask the app to perform a privacy-first mood screening by scanning your face in-browser and returning a mood score without storing or transmitting raw images.

Frequently Asked Questions about FacePsy Mood Screening

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does on-device mood screening from facial cues protect user privacy?

On-device mood screening protects privacy by processing facial landmarks and action units locally in the browser, storing only anonymized encrypted vectors instead of raw images. It ensures facial features are extracted without transmitting visual data externally.

How do I perform a privacy-first depression screening using facial landmarks?

To perform a privacy-first depression screening, you scan your face in-browser to extract MediaPipe landmarks, 12 key action units, and head pose. The pipeline generates a mood risk score locally without storing or transmitting raw images.

Can I use facial action unit detection for clinical mood tracking workflows?

Yes, facial action unit detection supports clinical mood tracking workflows by computing window-based features and hybrid universal-plus-personal models. It enables day-to-day mood trend monitoring for researchers and telewellness platforms while preserving patient privacy.

What is the best way to track depressive mood tendencies without storing raw images?

The best way to track depressive mood tendencies without storing raw images is using a privacy-by-design pipeline that extracts facial features on-device. It stores encrypted vectors locally and shares data only with explicit consent.

Do I need external libraries to extract facial action units for mood scoring?

You do not need external libraries beyond the integrated client-side pipeline, which uses MediaPipe for landmark extraction and a dedicated AU CNN for action units. The system operates independently with no external dependencies.

What are the limitations of using facial features for PHQ-9 mood screening?

A limitation of using facial features for PHQ-9 mood screening is that it detects mood tendencies rather than providing clinical diagnoses. It is designed as a non-intrusive screening support tool and should supplement, not replace, professional clinical assessment.