Skip to content

v1.0.33

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Aug 16:24
· 13 commits to main since this release
v1.0.33
a903c01

LocalLens Agent v1.0.33

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

  • Pro licenses can now be subscriptions as well as one-time purchases — they renew automatically, and a 14-day offline grace period means a failed renewal check never locks you out mid-trip.
  • License terms and default config no longer point at the dead locallens.app domain.
  • Upgrade prompts in the tray, README and in-chat help updated for the new pricing model — no longer claim "no subscription" and no longer list Smart Album Suggestions.

🔧 What Changed

Added

  • Pro licenses can now be subscriptions as well as one-time purchases — they renew automatically, and a 14-day offline grace period means a failed renewal check never locks you out mid-trip.

Fixed

  • License terms and default config no longer point at the dead locallens.app domain.

Changed

  • Upgrade prompts in the tray, README and in-chat help updated for the new pricing model — no longer claim "no subscription" and no longer list Smart Album Suggestions.

📦 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.33-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.33-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 vs Pro

Free is a complete photo organizer, not a trial.

Free Pro
Sort by Date ✅ ✅
Sort by Location ✅ ✅
Sort by People (face recognition) ✅ ✅
Find & Group — including by person ✅ ✅
See who is enrolled ✅ ✅
Folder analysis, saved path presets, stats ✅ ✅
Batch face enrollment — ✅
Duplicate detection & cleanup — ✅
Export reports — ✅
Scheduled auto-organize & active folders — ✅

Upgrade from the tray menu → Plan, or see current plans and pricing at locallensmcp.vercel.app.

Already have a key? Ask Claude: "activate my pro license".

📥 All downloads

Platform File Type
macOS (Apple Silicon) locallens-agent-v1.0.33-macos-arm64.dmg Menu Bar App
Windows (x64) locallens-agent-v1.0.33-windows-x86_64-setup.exe Installer
macOS (Apple Silicon) locallens-mcp-v1.0.33-macos-arm64.zip MCP Binary
Windows (x64) locallens-mcp-v1.0.33-windows-x86_64.zip MCP Binary
Linux (x64) locallens-mcp-v1.0.33-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.33-macos-arm64.dmg a9c74a07ba560ab3f3929010fa841e3739a8ed5cf8a97faab6cf8a84db667ae3
locallens-agent-v1.0.33-windows-x86_64-setup.exe 124f61221e6c352ec620fe5273b5cba84f274969800b383111438dc5c73c6b0c 
shasum -a 256 <file>                 # macOS / Linux
certutil -hashfile <file> SHA256     # Windows
Assets 7
Loading