{"id":22432068,"url":"https://github.com/chenwr727/face-album-mind","last_synced_at":"2025-06-26T14:31:47.277Z","repository":{"id":109612479,"uuid":"480178659","full_name":"chenwr727/Face-Album-Mind","owner":"chenwr727","description":"FaceAlbumMind is an AI-powered tool for automatic photo album organization. It detects faces, generates feature vectors, and clusters photos based on facial similarities, helping you efficiently manage your photo collection.","archived":false,"fork":false,"pushed_at":"2024-09-05T03:18:07.000Z","size":23772,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T22:26:09.759Z","etag":null,"topics":["face-clustering","face-detection","face-recognition","knn-classification","streamlit-webapp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chenwr727.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-11T00:45:14.000Z","updated_at":"2025-03-30T10:35:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"dd08b4b6-cbbe-403e-8869-4f64878013d5","html_url":"https://github.com/chenwr727/Face-Album-Mind","commit_stats":null,"previous_names":["chenwr727/smart-album","chenwr727/facealbummind","chenwr727/face-album-mind"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chenwr727/Face-Album-Mind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenwr727%2FFace-Album-Mind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenwr727%2FFace-Album-Mind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenwr727%2FFace-Album-Mind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenwr727%2FFace-Album-Mind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chenwr727","download_url":"https://codeload.github.com/chenwr727/Face-Album-Mind/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenwr727%2FFace-Album-Mind/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262084831,"owners_count":23256302,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["face-clustering","face-detection","face-recognition","knn-classification","streamlit-webapp"],"created_at":"2024-12-05T22:10:25.473Z","updated_at":"2025-06-26T14:31:47.237Z","avatar_url":"https://github.com/chenwr727.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"English | [简体中文](readme_cn.md)\r\n\r\n# FaceAlbumMind\r\n\r\n\u003e **FaceAlbumMind** is an intelligent photo album management tool based on facial recognition. It automatically analyzes the people in your photos, detects faces, generates vectors, and clusters based on facial features, helping users effortlessly organize and manage their photos.\r\n\r\n## Table of Contents\r\n\r\n- [1. Introduction](#1)\r\n- [2. Features Overview](#2)\r\n- [3. Installation](#3)\r\n  - [3.1 Clone the Repository](#3.1)\r\n  - [3.2 Install Dependencies](#3.2)\r\n- [4. Quick Start](#4)\r\n  - [4.1 Create a New Album](#4.1)\r\n  - [4.2 Upload Photos](#4.2)\r\n  - [4.3 Automatic Clustering](#4.3)\r\n  - [4.4 View Results](#4.4)\r\n- [5. Technologies Used](#5)\r\n- [6. Future Development](#6)\r\n- [7. Support \u0026 Feedback](#7)\r\n\r\n\u003ca name=\"1\"\u003e\u003c/a\u003e\r\n\r\n## 1. Introduction\r\n\r\n**FaceAlbumMind** is a facial recognition tool based on deep learning, designed for automatic organization and management of people in your photo albums. No matter how many photos you have, FaceAlbumMind can automatically categorize individuals through facial recognition, making it easy to search and manage your photos.\r\n\r\n### Key Features:\r\n- **Face Detection**: Detect faces in photos using advanced deep learning algorithms.\r\n- **Face Vectors**: Convert detected faces into feature vectors for clustering.\r\n- **Face Clustering**: Automatically categorize similar faces based on facial features, simplifying album management.\r\n- **Easy-to-use Interface**: Powered by Streamlit, the user interface makes it simple to upload photos and view results.\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"./images/demo.gif\" alt=\"FaceAlbumMind Demo\"\u003e\r\n\u003c/div\u003e\r\n\r\n\u003ca name=\"2\"\u003e\u003c/a\u003e\r\n\r\n## 2. Features Overview\r\n\r\nFaceAlbumMind offers the following key features:\r\n\r\n- **Face Detection and Recognition**: Batch process your photo albums to detect and extract faces.\r\n- **Face Clustering**: Use facial vectors to cluster similar faces into groups.\r\n- **Vector Search**: Planned integration with Milvus for large-scale photo search and similarity matching.\r\n- **User-Friendly Interface**: Built with Streamlit, providing an interactive, easy-to-use front-end interface for photo management.\r\n\r\n\u003ca name=\"3\"\u003e\u003c/a\u003e\r\n\r\n## 3. Installation\r\n\r\nFollow these steps to install and run FaceAlbumMind.\r\n\r\n\u003ca name=\"3.1\"\u003e\u003c/a\u003e\r\n\r\n### 3.1 Clone the Repository\r\n\r\nFirst, clone the project to your local environment:\r\n\r\n```bash\r\ngit clone https://github.com/FaceAlbumMind/SmartAlbum.git\r\ncd SmartAlbum\r\n```\r\n\r\n\u003ca name=\"3.2\"\u003e\u003c/a\u003e\r\n\r\n### 3.2 Install Dependencies\r\n\r\nFaceAlbumMind is developed using Python. Ensure you have Python 3.7 or above installed. Then, install the required dependencies with the following command:\r\n\r\n```bash\r\npip install --upgrade -r requirements.txt -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple\r\n```\r\n\r\nDependencies include:\r\n- [InsightFace](https://github.com/deepinsight/insightface): For face detection and feature extraction.\r\n- [Streamlit](https://github.com/streamlit/streamlit): For building the interactive front-end.\r\n- [Milvus](https://github.com/milvus-io/milvus) (planned): For efficient vector search and management.\r\n\r\n\u003ca name=\"4\"\u003e\u003c/a\u003e\r\n\r\n## 4. Quick Start\r\n\r\nOnce installed, you can launch FaceAlbumMind by running:\r\n\r\n```bash\r\npython -m streamlit run main.py\r\n```\r\n\r\nThe FaceAlbumMind user interface will open in your local browser. Follow the steps below to explore the main features.\r\n\r\n\u003ca name=\"4.1\"\u003e\u003c/a\u003e\r\n\r\n### 4.1 Create a New Album\r\n\r\nClick the `New Album` button to create a new album to manage your photos. You can assign a name and description to the album for easier reference later.\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"./images/add_new_group.png\" alt=\"Create New Album\"\u003e\r\n\u003c/div\u003e\r\n\r\n\u003ca name=\"4.2\"\u003e\u003c/a\u003e\r\n\r\n### 4.2 Upload Photos\r\n\r\nIn the album, click `Upload Photos` to select multiple photos for upload. The uploaded photos will automatically be processed, and facial features will be extracted.\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"./images/upload_pictures.png\" alt=\"Upload Photos\"\u003e\r\n\u003c/div\u003e\r\n\r\n\u003ca name=\"4.3\"\u003e\u003c/a\u003e\r\n\r\n### 4.3 Automatic Clustering\r\n\r\nOnce the photos are uploaded, FaceAlbumMind will automatically perform face detection and feature extraction. After processing, the photos will be displayed, grouped by detected individuals. You can click on each group to view all photos of that person.\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"./images/show_pictures.png\" alt=\"Automatic Clustering\"\u003e\r\n\u003c/div\u003e\r\n\r\n\u003ca name=\"4.4\"\u003e\u003c/a\u003e\r\n\r\n### 4.4 View Results\r\n\r\nThe system will create a category for each person, allowing users to view the list of photos grouped by individuals, making it easier to search and manage photos.\r\n\r\n\u003ca name=\"5\"\u003e\u003c/a\u003e\r\n\r\n## 5. Technologies Used\r\n\r\nFaceAlbumMind is built using the following technologies:\r\n\r\n- **[InsightFace](https://github.com/deepinsight/insightface)**: For face detection and feature extraction.\r\n- **[Streamlit](https://github.com/streamlit/streamlit)**: To quickly build web-based interactive user interfaces.\r\n- **[Pandas](https://pandas.pydata.org/)**: For data management and manipulation.\r\n- **[Milvus](https://github.com/milvus-io/milvus)**: Planned for vector search to handle large-scale face clustering.\r\n\r\n\u003ca name=\"6\"\u003e\u003c/a\u003e\r\n\r\n## 6. Future Development\r\n\r\nFuture development plans for FaceAlbumMind include:\r\n\r\n- **Milvus Integration**: To enable efficient vector search, supporting large-scale photo datasets.\r\n- **Additional Clustering Algorithms**: Support for more face clustering algorithms such as DBSCAN.\r\n- **Multiple Classification Modes**: In addition to people-based classification, support for categorizing photos by scene, date, and other criteria.\r\n- **Enhanced User Experience**: Add more interactive features, such as batch photo processing and tag management.\r\n\r\n\u003ca name=\"7\"\u003e\u003c/a\u003e\r\n\r\n## 7. Support \u0026 Feedback\r\n\r\nIf you encounter any issues while using FaceAlbumMind or have suggestions, please reach out to us through:\r\n\r\n- Submit an [Issue](https://github.com/chenwr727/FaceAlbumMind/issues)\r\n\r\nWe will respond to your feedback as soon as possible and continuously improve the project!\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchenwr727%2Fface-album-mind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchenwr727%2Fface-album-mind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchenwr727%2Fface-album-mind/lists"}