Feat: Cluster Management System - Create Clusters & Assign Images

[VasuS609]

Describe the feature

📋 Description

Currently, PictoPy's AI Tagging can detect and cluster faces automatically, but users cannot create custom clusters manually or assign images to existing clusters. This limits users' ability to organize photos when AI detection is imperfect or when they want custom organizational structures.

🎯 Problem Statement

• No way to create new person/face clusters manually
• Cannot add/remove images to/from existing clusters after AI tagging
• Cluster names are auto-generated IDs (e.g., "Person 6874") with no easy way to customize
• No bulk image assignment UX for cluster management
• Users cannot fix AI mistakes by manually curating clusters

💡 Proposed Solution

1. Create Cluster

2. Enhanced Cluster Detail View
   Improve the cluster detail page with:

• "Add Images" button opening multi-select gallery picker
• Drag-and-drop image assignment
• Bulk selection with checkbox grid
• Preview of cluster members with remove option
• Image count and search/filter capabilities

3. Backend API Extensions
   New/updated endpoints:

Add ScreenShots

Screen.Recording.2026-02-20.073022.mp4

Record

• I agree to follow this project's Code of Conduct
• I want to work on this issue

[github-actions]

👋 Thanks for opening this issue! The maintainers will review it shortly. Till then, do not open any PR. This is a strict rule we like to follow around here :)

[VasuS609]

@rahulharpal1603,
There was the issue of flickering images, but issue already raised so I haven't Fixed it Yet. Would love to know any enhancement required.

[Arunodoy18]

Hi 👋

I’d like to work on this feature if it’s available.

Since this involves both frontend UX and backend API changes, I propose breaking it into clear phases:

Phase 1 – Backend API Support

• Add endpoints to:
  • Create custom clusters
  • Rename clusters
  • Assign/remove images from clusters
• Ensure safe updates without breaking AI tagging logic
• Add basic validation and tests

Phase 2 – Cluster Management UI

• Add “Create Cluster” option
• Enable renaming clusters
• Add multi-select image picker for bulk assignment
• Provide remove-from-cluster option in detail view

Phase 3 – UX Enhancements

• Improve cluster detail layout
• Add search/filter
• Display image count
• Ensure performance remains smooth

I will wait for confirmation/assignment before opening any PR, as per project rules.

Please let me know if this direction aligns with the maintainers’ expectations.