Immich重复照片查找器：用户指南和技术文档

Immich重复照片查找器：用户指南和技术文档

immich_duplicate_finder A Comprehensive Solution for Identifying and Managing Duplicate Photos in Immich 项目地址: https://gitcode.com/gh_mirrors/im/immich_duplicate_finder

---

概览

Immich重复照片查找器是专为Immich平台设计的一款高效工具，它利用哈希检测（以及未来计划中的机器学习技术）来识别并管理重复的照片。此工具旨在通过优化存储空间和提升图片管理效率，加强Immich生态系统的实用性。

---

安装指南

Git克隆与依赖安装

1. 获取源代码: 在终端或命令提示符中执行以下命令以克隆仓库到本地：

   git clone https://github.com/vale46n1/immich_duplicate_finder.git
   

2. 安装依赖: 切换至项目目录，并运行以下命令来安装所有必需的Python包：

   cd immich_duplicate_finder
   pip install -r requirements.txt
   

Docker部署选项

对于希望使用Docker容器化的用户，可以按照以下步骤操作：

• 导航至项目中的docker/子文件夹。
• 确保已安装Docker，然后运行：

  docker-compose up -d
  

  这将在本地启动服务，并在localhost:8501提供访问。

---

项目使用说明

1. 启动应用: 使用以下命令启动Streamlit应用：

   streamlit run app.py
   

   或者，如果您选择Docker方式，应用会自动启动并可供访问。

2. 初次配置: 应用首次启动时，您需要配置与您的Immich服务器的连接：

   • 输入Immich服务器地址。
   • 生成并输入API密钥。请遵循Immich官方文档指引以获取API密钥。
   • 一旦设置完成，应用程序将记住这些信息，提高后续使用的便捷性。

---

项目API使用文档

本项目的核心在于其对Immich API的集成，主要功能包括：

• 利用ResNet152进行深度特征提取，结合FAISS库实现高效的图像相似度搜索和精确的重复照片识别。
• 通过Euclidean距离计算，确保照片相似度评估的准确性。
• 用户界面通过Streamlit构建，提供了直观的交互方式来监控处理进度和探索数据。

API交互流程简述

1. 认证: 使用提供的API密钥进行应用与Immich服务器之间的安全通信。
2. 数据检索: 向Immich请求媒体库中的照片数据。
3. 分析处理: 使用算法处理照片数据，检测潜在的重复项。
4. 结果展示: 将重复照片的比较结果呈现在用户界面上，供进一步的操作决策。

---

结论

通过上述指南，您可以顺利地安装并开始使用Immich重复照片查找器，享受它为您带来的 Immich 图片管理优化体验。记得，该软件尚处于持续开发阶段，反馈问题或贡献改进都是受欢迎的！

请注意保护个人数据，合理测试，避免因不当使用导致的数据风险。

immich_duplicate_finder A Comprehensive Solution for Identifying and Managing Duplicate Photos in Immich 项目地址: https://gitcode.com/gh_mirrors/im/immich_duplicate_finder