Skip to content

v1.0.34

Choose a tag to compare

@github-actions github-actions released this 12 Aug 16:33
· 9 commits to main since this release

LocalLens Agent v1.0.34

Organize your photo library by talking to Claude. Everything runs on your machine — no uploads, no cloud, not even metadata.

LocalLens MCP Agent connects Claude Desktop (or any MCP-compatible AI assistant) to your local LocalLens photo organizer.

✨ Highlights

  • LocalLens is in a free preview — every Pro feature is unlocked for everyone right now, no license required.
  • Anyone using LocalLens during the free preview keeps Pro permanently once paid plans launch. You will not be charged.
  • The assistant and tray no longer suggest upgrading to Pro for features that are already unlocked during the preview.

🔧 What Changed

Added

  • LocalLens is in a free preview — every Pro feature is unlocked for everyone right now, no license required.
  • Anyone using LocalLens during the free preview keeps Pro permanently once paid plans launch. You will not be charged.

Fixed

  • The assistant and tray no longer suggest upgrading to Pro for features that are already unlocked during the preview.

📦 Install

macOS — Homebrew (recommended)

brew install ashesbloom/locallens/locallens-agent

Homebrew clears Gatekeeper for you — there is nothing else to run. Launch LocalLens Agent from Applications and look for the LL icon in your menu bar.

macOS — DMG

  1. Download locallens-agent-v1.0.34-macos-arm64.dmg

  2. Open it and drag LocalLens Agent to Applications

  3. Clear Gatekeeper — the app is not yet notarized by Apple, so macOS will say it is damaged or from an unidentified developer until you do this:

    Double-click the Fix LocalLens Agent.command file included in the DMG, or run this once in Terminal:

    xattr -cr "/Applications/LocalLens Agent.app" && codesign --force --deep --sign - "/Applications/LocalLens Agent.app"
  4. Launch from Applications — the LL icon appears in your menu bar

Prefer Homebrew if you can. It skips this step entirely.

Windows

  1. Download locallens-agent-v1.0.34-windows-x86_64-setup.exe
  2. Run it. SmartScreen may warn about an unknown publisher — choose More info → Run anyway
  3. The tray icon appears in your notification area

MCP binary only (macOS / Linux / Windows)

For running the MCP server without the tray app:

# extract the archive for your platform, then:
./locallens-mcp --setup-claude

On Windows that is .\locallens-mcp.exe --setup-claude. Restart Claude Desktop to activate.


⬆️ Already have LocalLens Agent?

Open the LocalLens tray menu → Check for Updates → Install Update. It downloads, verifies the checksum and installs for you.

Homebrew users can instead run:

brew upgrade --cask locallens-agent

Installed from source or pip? pip install --upgrade locallens-mcp.


🎉 Free preview — everything is unlocked

There is no store yet, so there is nothing to buy. Every tool below runs for
everyone, with no license key:

Available now
Sort by Date, Location, or People
Find & Group — including by person
Folder analysis, saved path presets, stats
Batch face enrollment
Duplicate detection & cleanup
Export reports
Scheduled auto-organize & active folders

If you're using LocalLens now, you keep all of this for free, permanently
even after paid plans launch. That's not a trial period ending; it's a thank-you
for being here early. See locallensmcp.vercel.app/#pricing
for how it works.


📥 All downloads

Platform File Type
macOS (Apple Silicon) locallens-agent-v1.0.34-macos-arm64.dmg Menu Bar App
Windows (x64) locallens-agent-v1.0.34-windows-x86_64-setup.exe Installer
macOS (Apple Silicon) locallens-mcp-v1.0.34-macos-arm64.zip MCP Binary
Windows (x64) locallens-mcp-v1.0.34-windows-x86_64.zip MCP Binary
Linux (x64) locallens-mcp-v1.0.34-linux-x86_64.tar.gz MCP Binary

🚀 Getting started

  1. Install the LocalLens desktop app and run it once — download
  2. Install LocalLens Agent using any method above
  3. Restart Claude Desktop
  4. Ask Claude: "Check if LocalLens is running"

Then try "What can LocalLens do?" for a guided tour of all 26 tools.


🔗 Links


Built with privacy in mind. Your photos never leave your machine.


🔐 Verify your download

Both installers are unsigned, so it is worth checking the SHA256 before you run them.

Asset SHA256
locallens-agent-v1.0.34-macos-arm64.dmg 791a58277a61b7129b933a46f401bb00cc0c4c77d05dd895d4030d974b8cc029
locallens-agent-v1.0.34-windows-x86_64-setup.exe 8cdab99c9d7d273ae93d47079464f92cbe194c6fb732f96a5bebe3c8b12ca2aa
shasum -a 256 <file>                 # macOS / Linux
certutil -hashfile <file> SHA256     # Windows