README

PhotoPrism: Browse Your Life in Pictures
========================================








PhotoPrism® is an AI-powered, privacy-first app for browsing, organizing, and sharing photos and videos. It helps tag, search, and rediscover media without getting in your way, whether self-hosted or in the cloud.

!

To get a first impression, you are welcome to play with our public demo. Please be careful not to upload any private, unlawful or offensive pictures.

 Feature Overview 

Our mission is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible. That's why PhotoPrism was built from the ground up to run wherever you need it, without compromising freedom, privacy, or functionality:



 Browse all your pictures without worrying about RAW images or video formats
 Whether you're using a phone, tablet, or desktop computer, our intuitive PWA provides a native app-like experience and can be easily installed on your home screen
 Quickly find specific photos and videos with powerful search filters that can be combined and are available for many different properties, including labels, location, resolution, color, chroma, and quality
 Automatically labels your pictures based on content and location, and recognizes the faces of your family and friends
 Live Photos start playing when you hover over them and when viewing a slideshow
 Six high-resolution World Maps and our privacy-preserving geocoding service help bring back memories of your favorite trips and let you explore the world
 Metadata can be extracted and merged from Exif, XMP, and other sources like Google Photos
 Use compatible apps like PhotoSync to back up iOS and Android phones in the background
 WebDAV clients such as Microsoft's Windows Explorer and Apple's Finder can connect directly to PhotoPrism, allowing you to open, edit, and delete files from your computer as if they were local

Being completely self-funded and independent, we can promise you that we will never sell your data and that we will always be transparent about our software and services. Your data will never be shared with Google, Amazon, Microsoft or Apple unless you intentionally upload files to one of their services. 🔒

 Getting Started 

Step-by-step installation instructions for our self-hosted community edition can be found on docs.photoprism.app - all you need is a Web browser and Docker to run the server. It is available for Mac, Linux, and Windows.

The stable releases and development preview are available as a multi-arch image for 64-bit AMD, Intel, and ARM processors.
That means, Raspberry Pi and Apple Silicon users enjoy the exact same functionality and can follow the same installation steps.

See our Getting Started FAQ for alternative installation methods, for example using the tar.gz packages we provide.

 Support Our Mission 💎 

PhotoPrism is 100% self-funded and independent. Your continued support helps us provide more features to the public, release regular updates, 

Top issues

Discussions

Latest release

This release upgrades PhotoPrism's database layer and introduces experimental 🐘 PostgreSQL support, thanks to @keif888's hard work and numerous contributions.

AI assistants and other applications can now connect via 🔐 OAuth and use new 🤖 MCP tools to search and browse your library. Other improvements include a new ⬇️ Export dialog in the photo viewer for downloading images at selected resolutions and updated standard maps in Places, along with an enhanced 🌎 3D Earth view. This release also includes fixes for several metadata handling issues, as well as updates to libheif, Go, and ONNX Runti