immich-app/immich

[Feature] Per user "minimum face count"

Open

#21,279 opened on 2025年8月26日

GitHub で見る
 (4 comments) (2 reactions) (0 assignees)TypeScript (100,600 stars) (5,601 forks)batch import
good first issue

説明

Each individual user should be able to specify a "minimum face count" that filters out people on the /people endpoint & associated page. This should be added as a user preference (probably at people.minimumFaces), and can be set to any number, with 0 implying that no people are filtered out of view.

Background

There is a server config option (machineLearning.facialRecognition.minFaces), that is used during the clustering process to determine at what threshold a Person is created. This same configuration setting is being used as a global cutoff for the /people endpoint, and has led to some confusion.

コントリビューターガイド

技術スタック
typescript
領域
full stack
Issue 種別
feature
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
3
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
half day
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
fresh
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
Immich architecture overviewTypeScript/Node.js basicsREST API understanding
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
75
調査方針
The issue requests a per user 'minimum face count' preference. First, examine how existing user preferences are stored and retrieved (likely in a user preferences service or similar). Then, locate the `/people` endpoint and its associated controller/service to understand how the global config `machineLearning.facialRecognition.minFaces` is currently applied. Implement a new preference field `people.minimumFaces` in the user preferences schema, defaulting to 0. Modify the endpoint to filter people based on the user's preference instead of the global config. Finally, add a UI component in the user settings page to allow users to set this value. Ensure backward compatibility for users without the preference set.