SemanticGallery：给 Mac 本地图片文件夹加一个基于 MLX 的语义搜索，已开源

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

爱意满满的作品展示区。

最近为了从一堆照片和截图里找图，写了个本地优先的语义搜图工具：SemanticGallery 。

给它一个本地图片文件夹，它会在本机自动准备运行环境、做一次简短的 gallery-specific adaptation 、建立索引，然后直接在浏览器里搜索，不需要把相册上传到云端。

GitHub： https://github.com/yongyaoduan/SemanticGallery

Demo GIF： SemanticGallery demo

我现在主要拿它处理这几类场景：

找“微信聊天截图 / 知乎截图 / 淘宝截图”
找“健身照片 / 练车照片 / 相机拍摄的日常照片”
从一张现有图片继续找相似图片

目前已经做好的功能：

纯本地运行，默认只监听 127.0.0.1
支持自然语言搜图，也支持上传图片搜图 / 相似图搜索
支持照片和截图混合图库
首次运行会自动准备依赖、下载已发布 checkpoint 、构建本地索引
Web UI 支持预览、查看文件路径和时间元数据、批量选择、永久删除
底层运行时基于 MLX ，针对 Apple Silicon

启动方式：

GALLERY_DIR=/absolute/path/to/gallery ./scripts/quickstart.sh

有几点先提前说明：

目前只支持 Apple Silicon
第一次启动会下载模型和 checkpoint ，所以会比后续启动慢
删除是永久删除，没有回收站
图库文件新增或变化后，需要 FORCE=1 重新构建索引

如果你平时照片和截图很多，或者也想在本地文件夹里试试“自然语言找图 / 以图搜图”，欢迎体验和提意见。

如果大家感兴趣，我下一步优先继续补这些：

更好的增量更新体验
更完整的打包和安装方式
更稳妥的删除确认和恢复策略

语义搜索

本地

图片

1 条回复

yongyao

18 天前

补充几件容易被问到的事：

1. 目前是 source-first 方案，先通过 `quickstart.sh` 跑起来，还没有做成现成安装包。
2. 默认只绑定 `127.0.0.1`，图片不会上传；联网主要发生在首次准备 Python 依赖、下载 MLX 模型和已发布 checkpoint 和小型公开参考集的时候。
3. 删除是永久删除，不是移到回收站，这个我已经在 README 和正文里写明了。