photoprism/README.md

PhotoPrism: Browse your life in pictures
========================================

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)][license]
[![Code Quality](https://goreportcard.com/badge/github.com/photoprism/photoprism)][code quality]
[![Build Status](https://travis-ci.org/photoprism/photoprism.png?branch=master)][ci]
[![Documentation](https://readthedocs.org/projects/photoprism-docs/badge/?version=latest&style=flat)][docs]

[license]: https://github.com/photoprism/photoprism/blob/master/LICENSE
[code quality]: https://goreportcard.com/report/github.com/photoprism/photoprism
[ci]: https://travis-ci.org/photoprism/photoprism
[docs]: https://docs.photoprism.org/en/latest/

PhotoPrism is a server-based application for browsing, organizing and sharing your personal photo collection.
It makes use of the latest technologies to automatically tag and find pictures without getting in your way.
Say goodbye to solutions that force you to upload your visual memories to the cloud or pay monthly fees.

![](https://photoprism.org/images/fulls/02.jpg)

More screenshots: https://photoprism.org/#screenshots

## What to expect

* Clearly structured Web interface for browsing, organizing and sharing your personal photo collection.
* Import everything without worrying about duplicates or RAW to JPEG conversion.
* Reverse geocoding and automated tagging based on Google TensorFlow.
* No monthly costs. No proprietary formats. No privacy concerns.

## For the early birds

You are welcome to get an impression and provide early feedback.
All you need is a Web browser and [Docker](https://store.docker.com/search?type=edition&offering=community) 
to run the server. It is available for Mac, Linux and Windows.

Note that we just started working on the UI and features are neither complete nor stable.
Step-by-step [instructions](https://docs.photoprism.org/en/latest/setup/) can be found 
in our User Guide on [docs.photoprism.org](https://docs.photoprism.org/en/latest/). 
Developers can skip this and move on to the [Developer Guide](https://github.com/photoprism/photoprism/wiki).

## Why this has to be free software

The development of every commercial product is focused on monetization.
We've built similar apps more than once and every single time the constraints of working
in a profit-oriented corporate environment were an impediment.
We are sure we can do better with only a fraction of the budget. Simplicity can be very powerful.
Go, the programming language we're using, is a great example. It is heavily influenced by the ideas of Niklaus Wirth.

> Simple, elegant solutions are more effective, but they are harder to find than complex ones, and they require more time, which we too often believe to be unaffordable.
> — NIKLAUS WIRTH, CACM, FEB. 1985

## How to contribute

We welcome contributions of any kind. If you have a bug or an idea, read our 
[guide](https://docs.photoprism.org/en/latest/contribute/) before opening an issue.
Issues labeled [help wanted](https://github.com/photoprism/photoprism/labels/help%20wanted) or
[good first issue](https://github.com/photoprism/photoprism/labels/good%20first%20issue) can be
good first contributions. Let us know if you need additional information or permissions on GitHub
to perform a task.

## Donations

Please leave a star if you like this project, it provides enough motivation to keep going.
Thank you very much! <3

## Sponsorship

We are open to sponsorship proposals to improve our funding while we continue working on our first release and beyond.
Ideally it also enables us to offer perks for contributions and explore new ways of organizing product development.

In exchange, we would love to share our knowledge and experience with you or your team, either on-site or remote. We can also
help you getting existing photo collections tagged or build an API that integrates with your infrastructure.

Please [contact us](mailto:hello@photoprism.org) if you're interested in pursuing this unique opportunity.