English | 简体中文

LocalLens

快速上手

1. 下载

• 便携版（推荐）： 从 Releases 下载便携版构建。
  • Windows： 无需额外系统要求。
  • Linux / macOS： 需要系统安装 Python 3.11+ 和 Git。
• 源码安装：

  git clone https://github.com/meangrinch/LocalLens.git
  cd LocalLens
  python -m venv venv
  .\venv\Scripts\activate # 或 source venv/bin/activate (Linux/macOS)
  pip install torch==2.14.1+cu130 torchvision==0.29.1+cu130 --extra-index-url https://download.pytorch.org/whl/cu130 # 或 pip install torch==2.14.1 torchvision==0.29.1 (macOS)
  pip install -r requirements.txt
  

更多信息请参阅 安装。

2. 索引

• Web UI： 在 Database Management 中输入目录路径，然后点击 Add Folder。
• CLI：

  python build_db.py --model_path "google/embeddinggemma-2" --db_path "img_db/embeddinggemma_2" --add "path/to/images"
  

• 同步更改： 在 Web UI 中点击 Update/Sync，或在命令行中传入 --update，重新扫描已索引文件夹中的新增或删除内容。
• 图像细节（EmbeddingGemma 2）： 在 Select Model 下方的 Image Detail 中选择 70 到 1120 个软令牌（默认 280）。数值越高，识别的细节越精细，但索引越慢。每个数值使用独立的索引，因此更改后需要重新添加文件夹。在命令行中加上 --max_soft_tokens 140，并搭配相应的 --db_path，例如 img_db/embeddinggemma_2_140。

3. 搜索

• 文本搜索： 输入描述（例如 "a monarch butterfly"）即可按相似度排序检索匹配的媒体。在 Advanced Parameters 中启用 Live Search，即可在输入时实时更新结果。
• 以图搜图： 上传图像以查找视觉上相似的文件，或结合文本与图像输入精细调整搜索结果。
• 查找重复项： 在 Find Duplicates 中选择 Folder to Scan 并设置 Similarity Threshold，然后在 Duplicate Inspector 选项卡中查看重复的图像与视频对。
• 访问限制（可选）： 默认情况下，Gradio 相册可以显示来自任何已索引目录的图像。在启动应用前于系统环境中设置 LOCALLENS_ALLOWED_PATHS 即可限制允许访问的目录。

功能特点

• 索引：递归目录索引与增量同步（ChromaDB）
• 搜索：自然语言文本、图像以及图文混合查询
• 以图搜图：通过上传的图像查找视觉上相似的媒体
• 重复检测：通过相似度阈值定位完全重复与高度相似的图像与视频对
• 模型：视觉嵌入骨干网络（EmbeddingGemma 2、SigLIP 2）
• 格式：支持常见图像与视频格式（jpg、png、webp、mp4、mkv 等）
• 界面：Web UI (Gradio) 和命令行界面 (CLI)

文档

• 硬件要求
• 安装

支持项目

LocalLens 是免费且开源的。如果它为您查找照片或清理重复图像节省了时间，欢迎考虑支持它的开发！

许可证和鸣谢

• 许可证：Apache-2.0（参见 LICENSE）
• 作者：grinnch
• 灵感来源：Om-Alve 的 Where's My Pic?