Immich Duplicate Finder 项目下载及安装教程
1. 项目介绍
Immich Duplicate Finder 是一个用于识别和管理 Immich 中重复照片的综合解决方案。该项目通过哈希检测和未来将整合的机器学习技术,旨在提高存储优化和组织效率。其主要特点包括高精度检测、易于集成、性能优化和用户友好的界面。
2. 项目下载位置
要下载 Immich Duplicate Finder 项目,请使用以下命令:
git clone https://github.com/vale46n1/immich_duplicate_finder.git
3. 项目安装环境配置
3.1 环境要求
- Python 3.7 或更高版本
- pip 包管理器
- Docker(可选,用于 Docker 安装)
3.2 环境配置步骤
-
安装 Python 和 pip
确保你的系统上已安装 Python 3.7 或更高版本,并安装了 pip 包管理器。
-
安装 Docker(可选)
如果你选择使用 Docker 安装,请确保你的系统上已安装 Docker 和 Docker Compose。
4. 项目安装方式
4.1 使用 pip 安装
-
进入项目目录:
cd immich_duplicate_finder
-
安装依赖项:
pip install -r requirements.txt
-
启动应用:
streamlit run app.py
4.2 使用 Docker 安装
-
进入项目目录:
cd immich_duplicate_finder
-
启动 Docker 容器:
docker-compose up -d
5. 项目处理脚本
5.1 初始配置
在启动应用后,你需要完成以下初始配置:
- 指定 Immich 服务器地址:在应用的侧边栏中输入你的 Immich 服务器地址。
- 生成 API 密钥:在 Immich 应用中生成 API 密钥,并将其输入到 Immich Duplicate Finder 应用中。
5.2 数据持久化
服务器地址和 API 密钥将被安全地保存在数据库中,以便在未来的使用中无需重新输入。
5.3 处理脚本示例
以下是一个简单的处理脚本示例,用于检测和处理重复照片:
from immich_duplicate_finder import DuplicateFinder
# 初始化 DuplicateFinder
finder = DuplicateFinder(server_address="http://your-immich-server", api_key="your-api-key")
# 检测重复照片
finder.detect_duplicates()
# 处理重复照片
finder.handle_duplicates(action="delete")
通过以上步骤,你可以成功下载、安装并配置 Immich Duplicate Finder 项目,开始管理和优化你的照片库。