# LrGeniusAI

LrGeniusAI is a free, open-source (AGPL-3.0) AI workflow plugin for Adobe Lightroom Classic.
Maintained by Bastian Machek (Fokuspunk). GitHub org: https://github.com/LrGenius

## Key Facts

- **License:** AGPL-3.0 — completely free, no subscription, no usage limits
- **Platforms:** macOS and Windows
- **Requires:** Adobe Lightroom Classic (not Lightroom CC)
- **Status:** Beta / active development (installers not yet code-signed)
- **Runs 100% locally out of the box** — the backend runs vision models itself via built-in
  llama.cpp and MLX engines, with no external AI app to install. Photos never leave your computer.
- **Also supports external local servers:** Ollama, LM Studio
- **Optional cloud AI:** OpenAI/ChatGPT, Google Gemini, Google Vertex AI
- **Backend:** `geniusai-server`, a single Rust binary (default `http://127.0.0.1:19819`)

## Features

- Built-in local vision models — pick one in the Plug-in Manager and click Download
- AI keyword generation (open-vocabulary, prompt-tunable)
- AI captions, titles, and alt-text for photos
- Semantic free-text search across your entire Lightroom library
- AI-powered photo culling with face-aware selection (beta)
- Face recognition and People management dialog
- Smart editing recipes ("Looks") trained on your personal editing style (beta)
- Keyword deduplication and de-clutter

## Supported AI Providers

| Provider | Type | Notes |
|---|---|---|
| llama.cpp (built in) | Local | In-process GGUF engine, no external app. macOS/Windows/Linux; Metal on macOS, Vulkan on Windows |
| MLX (built in) | Local | Apple silicon only, via a small Metal helper process |
| Ollama | Local | External server, 100% private, free, runs on your hardware |
| LM Studio | Local | External server, 100% private, free, runs on your hardware |
| OpenAI / ChatGPT | Cloud | Requires API key, billed by OpenAI |
| Google Gemini | Cloud | Requires API key, billed by Google |
| Google Vertex AI | Cloud | Requires GCP project, billed by Google |

## Key Pages

- Home: https://lrgenius.com
- Getting Started: https://lrgenius.com/help/docs/getting-started
- Built-In Local AI Models (llama.cpp & MLX): https://lrgenius.com/help/docs/help-local-ai-models
- FAQ: https://lrgenius.com/help/docs/faq
- Help & Documentation: https://lrgenius.com/help
- Downloads / Releases: https://github.com/LrGenius/LrGeniusAI/releases
- Compare AI plugins for Lightroom: https://lrgenius.com/compare
- LrGenius vs Excire, Peakto, Aftershoot and more: https://lrgenius.com/lrgenius-vs-excire

## Author / Maintainer

Bastian Machek — https://blog.fokuspunk.de
GitHub: https://github.com/bmachek
GitHub org: https://github.com/LrGenius