# facet

> Self-hosted photo manager using AI to score, cull, and organize your library locally with face detection and natural-language search.

- **Category:** Photo Management
- **Licence:** Other
- **Latest version:** v1.25.0
- **Open source:** oss
- **Languages:** Typescript, Python
- **Platforms:** Docker Compose, Windows, macOS
- **Tags:** SQLite, Mcp, Machine Learning, Deep Learning, Pytorch, Webdav, Gallery, Semantic Search, Image Processing, Photography, Face Recognition, Docker, Angular, Python, Fastapi, Computer vision, Self Hosted, Photo Management, Photo, Image analysis, Clip, Image quality, Aesthetic Quality, Photo Scoring, Topiq, Photo Culling, Xmp Metadata, AI Scoring

## Description

Facet is a self-hosted photo analysis and culling engine that scores images across nine quality dimensions including aesthetic quality, composition, face quality, and technical sharpness. It provides a web-based gallery for browsing, filtering, and searching photos using natural language queries. Key features include burst detection and auto-culling, face recognition with blink detection, semantic search, timeline and map views, themed capsules (slideshows), album management, star ratings, and AI-powered critique. It works with Lightroom, darktable, and digiKam through XMP sidecars, supports phone auto-upload via WebDAV, and offers an MCP endpoint for AI agents. Facet runs on CPU or GPU (NVIDIA/Apple Silicon) via Docker or native Python installation. The code is MIT licensed, though some default models have non-commercial licenses.

## Links

- [Homepage](https://github.com/ncoevoet/facet)
- [Website](https://ncoevoet.github.io/facet/)
- [Docker](ghcr.io/ncoevoet/facet:latest)
- [GitHub Repository](https://github.com/ncoevoet/facet)
- [Documentation](https://github.com/ncoevoet/facet/blob/master/docs/INSTALLATION.md)
- [Getting Started Guide](https://github.com/ncoevoet/facet/blob/master/docs/GETTING_STARTED.md)
- [Commands Reference](https://github.com/ncoevoet/facet/blob/master/docs/COMMANDS.md)
- [Configuration Reference](https://github.com/ncoevoet/facet/blob/master/docs/CONFIGURATION.md)
- [Scoring Guide](https://github.com/ncoevoet/facet/blob/master/docs/SCORING.md)
- [Face Recognition Docs](https://github.com/ncoevoet/facet/blob/master/docs/FACE_RECOGNITION.md)
- [Viewer Documentation](https://github.com/ncoevoet/facet/blob/master/docs/VIEWER.md)
- [Interop Guide](https://github.com/ncoevoet/facet/blob/master/docs/INTEROP.md)
- [Immich Sync Docs](https://github.com/ncoevoet/facet/blob/master/docs/IMMICH.md)

---
Source: https://selfhost.directory/project/facet