A smart Lightroom Classic plugin for AI-powered tagging, describing, semantic search, and develop edits.
LrGeniusAI brings the power of modern Large Language Models (LLMs) directly into Adobe Lightroom Classic. It analyzes your photos, automatically generates accurate tags and detailed descriptions, creates AI-guided Lightroom develop edit recipes, and lets you rediscover your library with semantic free-text search using natural language.
Whether you prefer running local models to ensure maximum privacy or want to leverage powerful cloud APIs, LrGeniusAI seamlessly adapts to your photography workflow.
- 🤖 AI-Powered Tagging & Describing: Uses advanced LLMs to accurately recognize image content, generate metadata, and provide detailed descriptions of your photos.
- 🎛️ AI Lightroom Edit (Develop): Generates a structured Lightroom edit recipe per photo (global adjustments and optional masks) and can apply it directly in Develop mode. Includes per-photo review, style presets, style strength, composition/crop mode, and per-photo instruction overrides.
- 🔍 Semantic Free-Text Search (Advanced Search): Find images naturally through descriptive queries (e.g., "Red sports car parked in front of a garage" or "Sunset over the mountains"). LrGeniusAI automatically creates a relevance-sorted Collection in Lightroom based on your prompt.
- 📸 Image Culling: Group similar photos into bursts or near-duplicate stacks, automatically pick the strongest frames, and create Lightroom collections for picks, alternates, reject candidates, and optional duplicates.
- ☁️ Local & Cloud Models: Full support for local AI models via Ollama and LM Studio, as well as integration with cloud providers like ChatGPT/OpenAI, Google Gemini, and Vertex AI.
- 🎨 Customizable Prompts & Temperature Control: System prompts for the AI can be added, edited, and deleted directly within the Lightroom Plug-In Manager. Use the temperature slider to control whether the AI should be highly creative or strictly consistent.
- 📝 Photo Context (Contextual Info): Provide manual hints to the AI before analysis (e.g., names of people or specific background details) that aren't immediately obvious from the image itself. This can be done via a popup dialog or directly in Lightroom's metadata panel.
- 🗄️ Custom Python Backend & Database: The plugin utilizes a high-performance local server (
geniusai-server). Existing metadata from your Lightroom catalog can easily be imported prior to the first AI analysis.
- Download the latest release from the GitHub Releases page.
- Extract the ZIP file and add the plugin via the Plug-in Manager in Lightroom Classic.
- Backend Server Setup (First Launch):
- The backend starts automatically from Lightroom.
- Bypassing Security Warnings: Because the installers are currently not code-signed, you will see warnings from Windows SmartScreen or macOS Gatekeeper.
- Windows: Click More info -> Run anyway.
- macOS: Right-click the
.pkg-> Open -> Open anyway.
- Optional troubleshooting: if you want to start it manually, run
lrgenius-server/lrgenius-server.cmdon Windows orlrgenius-server/lrgenius-serveron macOS.
- Select photos in the library and choose one of the AI actions from Library -> Plug-in Extras:
- Analyze & Index Photos... for tags/descriptions/search index
- AI Edit Photos... to generate and apply Lightroom develop edits
- Advanced Search... for semantic free-text search
- For AI Edit, start with defaults, keep Review each proposed edit before applying it enabled, and tune style via Overall look + Style strength.
For comprehensive details, model setup guides, and tips, please visit lrgenius.com/help.
For detailed instructions on how to use Google Vertex AI, please see our Google Vertex AI Login Wiki Page.
The LrGeniusAI core, plugin, and backend are released under the GNU Affero General Public License v3 (AGPL-3.0).
This project is built on the belief that AI tooling for creatives should remain open, transparent, and community-driven. See the LICENSE file for the full license text.
- Frontend / Lightroom Plugin: Lua (Lightroom SDK)
- Backend / Server: Python (
geniusai-server) / FastAPI / Flask - AI & Embedding: Open-CLIP (SigLIP2), PyTorch, ONNX Runtime
- Identity & Faces: InsightFace
- Database: ChromaDB (Vector Search), SQLite (Metadata & Cache)
- Supported Interfaces: Google Gemini, Vertex AI, ChatGPT/OpenAI, Ollama, LM-Studio
For more detailed information on how to contribute, please see our CONTRIBUTING.md.
Developed with a passion for photography and IT by:
- Bastian Machek (LrGenius / Fokuspunk) – Creator & Lead Developer
- Community – Special thanks to all contributors and testers for your valuable input and support.
- Various AI agents - For the great support in developing this project.
This project leverages many incredible open-source libraries, including InsightFace, OpenCLIP, PyTorch, Hugging Face Transformers, ChromaDB, and Flask.
A huge thank you to the open-source community and the developers of the underlying AI frameworks that make this integration possible!