全面指导： Immich重复照片查找器安装与配置手册
项目地址: https://gitcode.com/gh_mirrors/im/immich_duplicate_finder 项目基础介绍及主要编程语言
Immich重复照片查找器是一款专为Immich平台设计的高效工具，旨在通过哈希检测（未来将集成机器学习技术）精确识别并管理重复图片，以优化存储空间和增强图像库的组织性。该工具利用Python编写，结合Streamlit进行用户界面设计，确保了技术与非技术人员都能轻松上手。
关键技术和框架
- 核心技术: 利用ResNet152模型进行图片哈希生成，FAISS作为矢量数据库来实现相似图片的高速检索。
- 框架: 主要基于Python的Streamlit构建用户界面，以及Docker支持可选部署方案。
- 算法: 高精度的图像相似度计算采用Euclidean距离，且支持ResNet18模型进行特征提取。
安装与配置指南
准备工作
- 环境需求: 确保您的系统已安装Python 3.6及以上版本。
- 安装pip: 如果未安装pip，可以通过命令
sudo apt-get install python3-pip(Ubuntu) 或python3 -m ensurepip --default-pip(MacOS/Windows) 来安装。 - Git: 安装Git用于克隆代码仓库。
步骤一：项目克隆
打开终端或命令提示符，执行以下命令克隆项目到本地：
git clone https://github.com/vale46n1/immich_duplicate_finder.git
步骤二：安装依赖项
进入项目目录，并使用pip安装所有必要的依赖：
cd immich_duplicate_finder
pip install -r requirements.txt
步骤三：启动应用
对于基本运行，简单执行以下命令来启动Streamlit应用：
streamlit run app.py
此时，浏览器应自动打开应用程序页面，或者您可以查看终端提供的本地URL访问应用。
Docker方式部署
如果您偏好Docker环境，首先确保您已安装Docker。然后，在项目根目录下：
- 复制
docker-compose.yml和Dockerfile至当前目录。 - 运行Docker容器:
docker-compose up -d
应用会部署在localhost:8501，通过浏览器访问此地址即可。
初始配置
- 在应用程序首次启动时，需配置Immich服务器地址与API密钥：
- 服务器地址: 在应用侧边栏输入您的Immich服务器地址。
- 生成API Key: 登录Immich平台生成API密钥，并在应用内输入。
- 输入完成后，您的设置会被安全保存，下次无需再次输入。
至此，您已经成功安装并配置了“Immich重复照片查找器”，可以开始享受便捷的重复图片管理和优化存储的过程了。在使用过程中遇到任何问题，欢迎反馈给开发者社区。祝您使用愉快！