OpenSource-Hub
L

LibrePhotos

8.0k stars·파일 관리·SHA-256 체크섬 확인됨

自托管的AI照片管理,自动识别人脸、物体,支持语义搜索。

스마트 다운로드

프로젝트 홈페이지 방문

아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요

开源版Google Photos,让照片管理AI化且私有。

주요 기능

  • 自动扫描文件系统,支持原始照片和视频
  • 人脸识别与分类,自动聚合同一人脸
  • 物体/场景检测与反向地理编码
  • 语义搜索:用自然语言描述即可找到照片
  • 事件相册智能生成(如“周四在柏林”)

할 수 없는 것

  • 人脸识别等 ML 功能非常消耗内存,建议 8GB RAM 以上,否则可能卡死。2. 首次扫描大量照片时 CPU 和内存占用很高,建议分批添加。3. face_recognition 库在 ARM 设备(如树莓派)上安装困难,不推荐。4. 不支持 iOS 客户端(仅有 Android 移动端)。5. 若要公开部署,务必配置反向代理和 HTTPS。

사용 사례

  • 个人/家庭照片库的本地化管理,替代云服务
  • 需要隐私保护或不想付费订阅 Google Photos 的用户
  • 通过 AI 能力快速组织海量照片(如摄影师、媒体从业者)
  • 希望完全掌控自己数据的技术爱好者或小型企业

상세 설명

LibrePhotos 是一款开源自托管的照片管理工具,旨在替代 Google Photos。它能自动扫描你的照片库,识别人脸和物体,基于事件生成相册(例如“周四在柏林”),并支持语义搜索。后端基于 Django 5,前端使用 React 18,通过 Docker Compose 一键部署,数据完全由你掌控。内置机器学习流水线,开箱即用地实现人脸聚类、场景分类、图像描述和反向地理编码。支持所有照片格式(包括原始照片)和视频。

문제 해결 & FAQ (1)

문제 해결
LibrePhotos에서 delete_missing_photos 작업이 GreenletExit 오류로 중단되는 이유는 무엇인가요?

이는 누락된 사진이 매우 많을 때(예: 400k 이상) 발생하며, gevent 기반 워커가 타임아웃되거나 동시성 제한에 도달하게 합니다. 해결 방법으로 Django 관리 명령이나 직접 SQL 쿼리를 사용하여 누락된 사진을 배치로 수동 정리합니다. 예를 들어 python manage.py shell을 실행하고 다음을 입력합니다: from api.models import Photo; missing = Photo.objects.filter(files__isnull=True)[:1000]; Photo.objects.filter(id__in=missing.values_list('id', flat=True)).delete() — 모든 사진이 제거될 때까지 반복합니다. 또는 스레드가 있는 gunicorn 같은 비-gevent 워커로 전환하거나 작업 타임아웃을 늘려보세요.

원본 Issue #1405

태그

照片管理自托管人脸识别机器学习开源隐私优先

시작하기

1

설치 프로그램 다운로드

위 버튼을 클릭하여 시스템에 맞는 설치 프로그램을 다운로드

2

소프트웨어 설치

다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요

3

步骤1:确保系统已安装 Docker 和 Docker Compose

4

步骤2:克隆仓库:git clone https://github.com/LibrePhotos/librephotos.git

5

步骤3:进入 deploy/compose 目录,运行 docker compose up -d

설치 가이드
  1. 步骤1:确保系统已安装 Docker 和 Docker Compose
  2. 步骤2:克隆仓库:git clone https://github.com/LibrePhotos/librephotos.git
  3. 步骤3:进入 deploy/compose 目录,运行 docker compose up -d
파일 무결성

체크섬 없음

이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다

SHA256 체크섬

체크섬 없음

GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요

이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.

오픈소스 투명성

GitHub 소스 보기
환경 가이드

제거 정보

停止并移除容器:在 deploy/compose 目录下执行 docker compose down -v,然后删除整个 librephotos 目录。注意 -v 会清除数据库和已生成的数据,如需保留请提前备份。

추가 의존성 없음

다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.

프로젝트 정보
라이선스MIT
마지막 업데이트2026-06-27 14:25:14
GitHub 저장소공식 웹사이트

문제 발생? 아래 FAQ 확인

1 FAQ

유사한 프로젝트