photoprism/photoprism
Photoprism
PhotoPrism is a self-hosted digital asset management platform designed to organize, classify, and manage large collections of photos and videos on personal infrastructure. It functions as a private alternative to cloud-based services, ensuring that all media remains under the user's control. The platform utilizes neural-network-based media analysis to automatically detect objects, faces, and locations, providing a comprehensive, AI-powered approach to library organization.
The project distinguishes itself through its containerized architecture, which simplifies deployment and lifecycle management across diverse hardware environments. It features an asynchronous background worker system that handles compute-intensive tasks like transcoding and thumbnail generation, ensuring the web interface remains responsive even during large-scale indexing operations. Furthermore, it employs a sidecar-based metadata persistence model, storing information in external files alongside original assets to maintain data portability and independence from the primary database.
Beyond its core organization capabilities, the platform provides a robust suite of tools for library management, including duplicate detection, geospatial mapping, and advanced metadata-based search. It supports secure, authenticated access through a responsive web interface and offers granular control over media sharing and privacy settings. Users can extend the platform's functionality through custom AI model configurations and integrate it with external identity providers for centralized authentication.
The application is distributed as a containerized service, typically managed via Docker Compose, and includes comprehensive documentation for deployment, database maintenance, and performance optimization on various hardware architectures.
Features
- Media Servers - Organizes, classifies, and manages large collections of photos and videos on personal infrastructure.
- Self-Hosted Media Managers - Builds a private, centralized library for photos and videos that keeps data under your control without relying on third-party cloud services.
- Automated Classification - Classifies images by identifying content, locations, and faces to simplify the organization and discovery of personal photo archives.
- Computer Vision Engines - Uses integrated computer vision to automatically identify objects, faces, and locations within media.
- Media Analysis Engines - Uses deep learning models to automatically classify images and generate descriptive tags.
- Facial Recognition Engines - Automatically identifies and groups faces in a photo library to simplify organization.
- Media Intelligence - Automates the classification, tagging, and facial recognition of large image collections using computer vision.
- Containerized Deployments - Packages the application and its dependencies into isolated environments to simplify deployment.
- Private Cloud Platforms - Provides full control over digital assets while ensuring independence from third-party cloud services.
- Private Hosting - Maintains full ownership and privacy of personal data by hosting media locally, ensuring no information is shared with third-party cloud providers.
- Face Detection - Identifies faces in images using neural networks to enable consistent organization across a media library.
- Identity Management Systems - Enables naming and identifying people across a collection by labeling face clusters.
- Search Engines - Allows filtering media libraries using metadata such as labels, location, color, and quality to quickly locate specific images or videos.
- Table of Contents - Processes and organizes large volumes of media files in the background to ensure metadata extraction and library maintenance happen without manual effort.
- Background Processing - Processes compute-intensive tasks like transcoding and thumbnail generation in parallel.
- Container Orchestration - Orchestrates services using container tools by configuring a YAML file to manage volumes and database connections.
- Media Metadata Managers - Enriches media with automated classification, facial recognition, and location data for improved searchability.
- Transcoding Engines - Automates the conversion of incompatible video formats to standard codecs for consistent playback and metadata extraction.
- Access Control Policies - Flags specific media as private to exclude them from public-facing views.
- Background Processing Services - Handles compute-intensive tasks like thumbnail generation and video transcoding in the background.
- REST APIs - Processes JSON-encoded requests to versioned endpoints to facilitate data processing.
- Computer Vision Libraries - Personal photo management powered by TensorFlow.
- Geospatial Data Infrastructure - Self-hosted application for organizing and browsing photo collections.
- Media and Communication - AI-powered photo management application.
- Media & Communication - Personal photo management.
- Photo Hosting - Personal photo library with AI-powered classification and organization.
- Go 项目 - Listed in the “Go 项目” section of the Great Open Source Project awesome list.
- Data Querying - Allows retrieving photo and file metadata by applying search filters and sorting criteria.
- Metadata Search Engines - Enables precise discovery of media by combining multiple metadata filters like location, camera, and keywords.
- Streaming and Broadcasting - Supports playing video files including transcoding and range requests for efficient streaming.
- Geospatial Visualizations - Visualizes photos with GPS metadata on interactive maps and 3D globes.
- Access Control - Provides controlled access to private photo and video collections through authenticated interfaces and granular permission management.
- API Authentication - Validates API requests using bearer tokens or custom headers to authorize client access.
- Media Browsers - Provides a graphical interface to navigate the file system and view original media files.
- Responsive Web Interfaces - Provides a responsive web interface that functions like a native application on any device to organize and view photo and video collections.
- Face Embeddings - Creates unique numerical vectors for detected faces to enable accurate matching and clustering.
- Content Filtering Heuristics - Enables filtering and viewing media collections based on assigned labels.
- Content Sharing and Embedding - Generates secure, time-limited web links for sharing specific photo collections and albums.
- Photo Management Systems - Organizes selected media files into new or existing albums for easier navigation.
- Thumbnail Services - Enables fetching thumbnail images for specific media files using unique identifiers.
- Media Synchronization - Transfers photos and videos from mobile devices to a central library using background synchronization.
- Single Sign-On Providers - Enables defining single sign-on settings to integrate with external identity providers.
- Library Maintenance - Performs a complete library rescan after major updates to ensure search filters and sorting options are correctly applied.
- Cross-Platform Access - Enables consistent browsing, streaming, and management of personal media libraries across various devices through a unified web-based interface.
- Privacy Control Systems - Allows excluding specific people from main recognition views while maintaining data accessibility.
- Tagging Systems - Allows manual assignment of custom labels to individual photos for better organization.
- Duplicate Detection Tools - Identifies and skips duplicate files during indexing by comparing checksums and file sizes.
- Event-Driven Pipelines - Triggers automated scanning and metadata extraction workflows whenever new media files are detected.
- Media Management Tools - Identifies and previews live photos within the library interface.
- Video Players - Provides an integrated interface for browsing and playing back video files directly within the browser.
- Content Moderation Filters - Applies automated safety filters to flag private images during indexing or reject unsafe files.
- OAuth2 Client Management - Allows registering and managing OAuth2 client credentials to enable external application authentication.
- Indexing Schedulers - Automates recurring library rescans or triggers indexing when new files are detected.
- Resource Optimization - Enables adjusting worker counts, database backends, and feature flags to maintain stability on hardware with limited processing power.
- Service Lifecycle Management - Updates a containerized instance by pulling the latest image and restarting the service using standard orchestration tools.
- API Interfaces - Exposes versioned endpoints for all client operations to facilitate secure communication between the frontend interface and the backend services.
