photoprism/photoprism

AI-Powered Photos App 🌈💎✨

PhotoPrism – AI 기반 개인 사진 관리자

개요 – PhotoPrism은 사진과 동영상을 탐색, 정리 및 공유할 수 있는 오픈 소스 셀프 호스팅 웹 애플리케이션입니다. 기기 내 머신러닝 모델을 사용하여 데이터를 프라이버시 상태로 유지하면서 이미지에 자동으로 레이블을 지정하고, 얼굴을 인식하며, 메타데이터를 추출합니다.

핵심 기능

  • 자동 태그 지정 – 딥러닝 모델이 이미지 콘텐츠를 분석하여 설명 레이블(예: dog, beach, sunset) 및 위치 정보를 추가합니다.
  • 얼굴 인식 – 얼굴을 감지하고 그룹화하여 가족이나 친구의 사진을 빠르게 찾을 수 있습니다.
  • 강력한 검색 – 레이블, 날짜, 위치, 해상도, 색상, 품질 등의 필터를 조합하여 몇 초 만에 미디어를 찾을 수 있습니다.
  • RAW 및 비디오 지원 – 변환 없이 카메라 RAW 파일과 다양한 비디오 형식을 처리합니다.
  • Progressive Web App – 데스크톱, 태블릿 또는 휴대폰에서 작동하며 네이티브 앱처럼 설치할 수 있습니다.
  • 동기화 및 편집 – WebDAV, PhotoSync 및 기타 호환 앱을 사용하여 모바일 장치를 백업하고 컴퓨터에서 직접 파일을 편집할 수 있습니다.
  • 프라이버시 우선 – 모든 AI 프로세싱은 로컬(또는 자체 서버)에서 실행됩니다. 사용자가 선택하지 않는 한 데이터가 제3자 클라우드 서비스로 전송되지 않습니다.

작동 방식 (개요)

  1. 수집(Ingestion) – PhotoPrism을 폴더로 지정하거나 WebDAV/PhotoSync를 통해 동기화합니다. 파일 스캔, EXIF/XMP 메타데이터 추출 및 썸네일을 저장합니다.
  2. 인덱싱(Indexing) – 내장된 TensorFlow 기반 모델이 각 이미지를 분석하여 태그와 얼굴 임베딩을 생성합니다.
  3. 검색 인덱스 – 태그, 위치, 타임스탬프, 색상 등이 검색 가능한 데이터베이스(SQLite/PostgreSQL)에 저장됩니다.
  4. Web UI / PWA – 프런트엔드(Vue.js)가 인덱스를 쿼리하고 반응형 갤러리에 결과를 표시합니다.

시작하기

  • 사전 요구 사항 – Docker (또는 Docker-Compose) 및 웹 브라우저. 이 프로젝트는 AMD64, ARM64 및 Raspberry Pi용 멀티 아키텍처 Docker 이미지를 제공합니다.
  • 일반적인 설치docker run -p 2342:2342 -v /path/to/pictures:/photoprism/storage photoprism/photoprism:latest (전체 compose 파일 및 환경 변수는 공식 문서를 참조하세요).
  • 대안 – Linux/macOS/Windows용 tar.gz 패키지를 다운로드하고 번들된 바이너리를 실행합니다.

주요 사용 사례

  • 프라이버시를 포기하지 않으면서 AI 지원 정리를 원하는 가족을 위한 개인 사진 아카이브.
  • 온프레미스에서 검색 가능한 미디어 라이브러리가 필요한 소규모 비즈니스 또는 취미 사진가.
  • Google Photos와 같은 클라우드 서비스의 셀프 호스팅 대안을 원하는 모든 사람.

제한 사항 / 고려 사항

  • AI 모델은 사전 학습되었습니다. 일반적인 사물과 얼굴에는 잘 작동하지만 니치한 카테고리는 놓칠 수 있습니다.
  • 대규모 라이브러리의 경우 초기 인덱싱은 CPU 집약적일 수 있습니다. 적절한 CPU(또는 선택적 GPU 지원)를 갖춘 기기는 속도를 높여줍니다.
  • 무료 커뮤니티 에디션에는 유료 회원에게 제공되는 일부 프리미엄 기능(대화형 세계 지도, 프라이빗 지원)이 없습니다.
  • 내장된 협업 편집 기능이 없습니다. 변경 사항은 서버 인스턴스에 로컬로 저장됩니다.

더 알아보기


PhotoPrism은 AGPL-3.0 라이선스 하에 배포됩니다. 문서는 CC BY-NC-SA 4.0입니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트