photoprism/README.md
2022-05-04 23:26:46 +02:00

11 KiB
Raw Blame History

PhotoPrism: Browse Your Life in Pictures

License: AGPL GitHub contributors Documentation Community Chat GitHub Discussions Twitter Reddit

PhotoPrism® is an AI-Powered Photos App for the Decentralized Web. It makes use of the latest technologies to tag and find pictures automatically without getting in your way. You can run it at home, on a private server, or in the cloud.

To get a first impression, you are welcome to play with our public demo. Be careful not to upload any private pictures.

Feature Overview

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 version and development preview have been built into a single multi-arch image for 64-bit AMD, Intel, and ARM processors. That means, Raspberry Pi 3 / 4 owners can pull from the same repository, enjoy the exact same functionality, and can follow the regular installation instructions after going through a short list of requirements.

Existing users are advised to update their docker-compose.yml config based on our examples available at dl.photoprism.app/docker.

PhotoPrism is 100% self-funded and independent. Your continued support helps us provide regular updates and services like world maps. Sponsors get access to additional features, receive direct technical support via email, and can join our private chat room on matrix.org.

We currently have the following sponsorship options:

  • GitHub Sponsors is priced in USD and also offers one-time donations
  • Patreon is priced in Euro and also offers yearly payments
  • Stripe will be available in early 2022, so you can sign up directly in the app without having a Patreon or GitHub account
  • You are welcome to contact us for crypto donations, bank account details, and business partnerships

Also, please leave a star on GitHub if you like this project. It provides additional motivation to keep going.

Upcoming Features and Improvements

Our vision is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible. The roadmap shows what tasks are in progress, what needs testing, and which features are going to be implemented next. Please give ideas you like a thumbs-up 👍 , so that we know what is most popular.

Ideas endorsed by silver, gold, and platinum sponsors receive a golden label and will be prioritized on the roadmap. Note that we have a zero bug policy and do our best to help users when they need support or have other questions. This comes at a price, as we can't give exact deadlines for new features. Our team will consider all requests, but is not obligated to implement the features, improvements, or other changes you request.

Having said that, funding really has the highest impact. So users can do their part and become a sponsor to get their favorite features as soon as possible.

Getting Support

If you need help installing our software at home, you can join us on Reddit, ask in our Community Chat, or post your question in GitHub Discussions. Common problems can be quickly diagnosed and solved using the Troubleshooting Checklists in Getting Started.

We'll do our best to answer all your questions. In return, we ask you to back us on Patreon or GitHub Sponsors. Think of "free software" as in "free speech," not as in "free beer". Thank you! 💜

In exchange for their continued support, Sponsors are also welcome to request direct technical support via email. Please bear with us if we are unable to get back to you immediately due to the high volume of emails and contact requests we receive.

GitHub Issues

We kindly ask you not to report bugs via GitHub Issues unless you are certain to have found a fully reproducible and previously unreported issue that must be fixed directly in the app. Thank you for your careful consideration!

  • When reporting a problem, always include the software versions you are using and other information about your environment such as browser, browser plugins, operating system, storage type, memory size, and processor
  • Note that all issue subscribers receive an email notification from GitHub for each new comment, so these should only be used for sharing important information and not for personal discussions/questions
  • Contact us or a community member if you need help, it could be a local configuration problem, or a misunderstanding in how the software works
  • This gives our team the opportunity to improve the docs and provide best-in-class support to you, instead of handling unclear/duplicate bug reports or triggering a flood of notifications by responding to comments

Join the Community

Follow us on Twitter and join the Community Chat to get regular updates, connect with other users, and discuss your ideas. Our Code of Conduct explains the "dos and donts."

An important part of our journey is to explore new directions in product development and build better software through consistent use of feedback.

Feel free to contact us with anything that is on your mind, even if you just want to say hello. It is our goal to answer all questions we receive from our users, customers, partners, and the developer community. Our team also welcomes feedback if you believe something can or should be improved.

Every Contribution Makes a Difference

We welcome contributions of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests. Our Developer Guide contains all the information necessary for you to get started.


PhotoPrism® is a registered trademark. By using the software and services we provide, you agree to our Terms of Service, Privacy Policy, and Code of Conduct. Docs are available under the CC BY-NC-SA 4.0 License; additional terms may apply.