https://github.com/LibrePhotos/librephotos

A self-hosted open source photo management service. This is the repository of the backend.
https://github.com/LibrePhotos/librephotos

django exif hacktoberfest machine-learning photo python selfhosted

Last synced: about 1 month ago
JSON representation

A self-hosted open source photo management service. This is the repository of the backend.

• Host: GitHub
• URL: https://github.com/LibrePhotos/librephotos
• Owner: LibrePhotos
• License: mit
• Created: 2020-11-11T23:08:19.000Z (over 4 years ago)
• Default Branch: dev
• Last Pushed: 2024-10-29T15:20:14.000Z (6 months ago)
• Last Synced: 2024-10-29T15:26:46.467Z (6 months ago)
• Topics: django, exif, hacktoberfest, machine-learning, photo, python, selfhosted
• Language: Python
• Homepage:
• Size: 78.4 MB
• Stars: 6,938
• Watchers: 55
• Forks: 302
• Open Issues: 273
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-homelab - LibrePhotos - hosted open source photo management service. This is the repository of the backend. | (Apps / PhotoManagement)
• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/LibrePhotos/librephotos - Self-hosted photo management service (Privacy/Security / Other)
• awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/LibrePhotos/librephotos - Self-hosted photo management service (Jump To / Privacy/Security)
• awesome-repositories - LibrePhotos/librephotos - A self-hosted open source photo management service. This is the repository of the backend. (Python)
• awesome-tools - librephotos - A self-hosted open source photo management service. (File sharing / Photo galleries)
• awesome-privacy - LibrePhotos - hosted alternative to Google Photos based on Ownphotos. (Photo / Photo storage)
• awesome-starred - LibrePhotos/librephotos - A self-hosted open source photo management service. This is the repository of the backend. (Python)
• awesome-starred - LibrePhotos/librephotos - A self-hosted open source photo management service. This is the repository of the backend. (Python)
• definitive-opensource - LibrePhotos - hosted open source photo management service. This is the repository of the backend. | `SelfHost` | **7.2k** | (Table of Contents / Media Management)
• awesome - LibrePhotos/librephotos - A self-hosted open source photo management service. This is the repository of the backend. (Python)
• awesome-docker - LibrePhotos/librephotos
• awesome-docker - LibrePhotos/librephotos

README

        
[![Discord](https://img.shields.io/discord/784619049208250388?style=plastic)][discord] [![Website](https://img.shields.io/website?down_color=lightgrey&down_message=offline&style=plastic&up_color=blue&up_message=online&url=https%3A%2F%2Flibrephotos.com)](https://librephotos.com/)

[![Read the docs](https://img.shields.io/static/v1?label=Read&message=the%20docs&color=blue&style=plastic)](https://docs.librephotos.com/) [![GitHub contributors](https://img.shields.io/github/contributors/librephotos/librephotos?style=plastic)](https://github.com/LibrePhotos/librephotos/graphs/contributors)







# LibrePhotos

![](https://github.com/LibrePhotos/librephotos/blob/dev/screenshots/mockups_main_fhd.png?raw=true)

Mockup designed by rawpixel.com / Freepik

- **Stable** demo is available here:https://demo1.librephotos.com/ . User is ```demo```, password is ```demo1234``` (with sample images).

- Latest **development** demo is available here: https://demo2.librephotos.com/ (same user/password)

- You can watch development videos on [Niaz Faridani-Rad's channel](https://www.youtube.com/channel/UCZJ2pk2BPKxwbuCV9LWDR0w)

- You can join our [Discord][discord].

## Installation

Step-by-step installation instructions are available in our [documentation](https://docs.librephotos.com/docs/installation/standard-install)

## How to help out

- ⭐ **Star** this repository if you like this project!

- 🚀 **Developing**: Get started in less than 30 minutes by following [this guide](https://docs.librephotos.com/docs/development/dev-install).

- 🗒️ **Documentation**: Improving the documentation is as simple as submitting a pull request [here](https://github.com/LibrePhotos/librephotos.docs)

- 🧪 **Testing**: If you want to help find bugs, use the ```dev``` tag and update it regularly. If you find a bug, open an issue.

- 🧑‍🤝‍🧑 **Outreach**: Talk about this project with other people and help them to get started too!

- 🌐 **Translations**: Make LibrePhotos accessible to more people with [weblate](https://hosted.weblate.org/engage/librephotos/).

- 💸 [**Donate**](https://github.com/sponsors/derneuere) to the developers of LibrePhotos

## Features

  - Support for all types of photos including raw photos

  - Support for videos

  - Timeline view

  - Scans pictures on the file system

  - Multiuser support

  - Generate albums based on events like "Thursday in Berlin"

  - Face recognition / Face classification

  - Reverse geocoding

  - Object / Scene detection

  - Semantic image search

  - Search by metadata

## What does it use?

- **Image Conversion:** [ImageMagick](https://github.com/ImageMagick/ImageMagick) 

- **Video Conversion:** [FFmpeg](https://github.com/FFmpeg/FFmpeg)

- **Exif Support:** [ExifTool](https://github.com/exiftool/exiftool)

- **Face detection:** [face_recognition](https://github.com/ageitgey/face_recognition) 

- **Face classification/clusterization:** [scikit-learn](https://scikit-learn.org/) and [hdbscan](https://github.com/scikit-learn-contrib/hdbscan)

- **Image captioning:** [im2txt](https://github.com/HughKu/Im2txt), 

- **Scene classification** [places365](http://places.csail.mit.edu/)

- **Reverse geocoding:** [Mapbox](https://www.mapbox.com/): You need to have an API key. First 50,000 geocode lookups are free every month.

[discord]: https://discord.gg/xwRvtSDGWb