LocalLensSemantic File Search for AI Agents

Index, search, and ask questions about your local files. Ships as a Python library, CLI, and MCP server. 100% offline.

Get Started

View on GitHub

PyPI

Python Library

from locallens import LocalLens -- import it, use it, done. No server, no Docker needed.

MCP Server

locallens serve --mcp -- one command to become a tool for Claude Code, Cursor, and any MCP client.

100% Offline

Qdrant Edge + local embeddings + Ollama. Your files never leave your machine. Zero network calls.

Install in 10 seconds

bash

pip install locallens

Quick Examples

PythonCLIMCP (Claude Desktop)

python

from locallens import LocalLens

lens = LocalLens("~/Documents")
lens.index()
results = lens.search("quarterly revenue report")
print(results[0].file_name, results[0].score)

bash

locallens index ~/Documents
locallens search "quarterly revenue report"
locallens ask "What was the Q3 revenue?"

json

// ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "locallens": {
      "command": "locallens",
      "args": ["serve", "--mcp"]
    }
  }
}

Powered by

Qdrant Edge|sentence-transformers|Ollama|PyO3 + Rust