git404hub

what is findandseek-engine fr?

munashechitima/findandseek-engine — explained in plain English

Analysis updated 2026-05-18

8PythonAudience · developerComplexity · 4/5LicenseSetup · hard

tl;dr

A local-first search engine that lets AI assistants query your own files (documents, email, code) without any cloud involved.

vibe map

mindmap
  root((FindandSeek))
    What it does
      Indexes local files
      Exposes memory via MCP
      Runs fully on device
    Tech stack
      Python
      SQLite index
      MLX or Ollama
    Use cases
      Query personal documents
      AI assistant memory layer
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Let an AI assistant answer questions about your own documents, invoices, and emails without sending them to the cloud.

VIBE 2

Index a folder of files once so future AI queries are cheaper and faster than reading whole files each time.

VIBE 3

Search scanned documents and photos using built-in OCR support.

VIBE 4

Connect the engine to Claude Desktop or another MCP client as a private local memory layer.

what's the stack?

PythonMCPSQLiteMLXOllama

how it stacks up fr

munashechitima/findandseek-engine100/awesome-machine-learningadam-s/car-diagnosis
Stars888
LanguagePythonPythonPython
Last pushed2024-08-07
MaintenanceStale
Setup difficultyhardeasymoderate
Complexity4/51/53/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Apple silicon or a Linux machine with Ollama running, plus several GB of disk for model weights.

Source-available, but limits commercial or competing use until a future conversion date.

in plain english

FindandSeek Engine is a local-first tool that indexes the documents, code, and email sitting on your computer, then lets an AI assistant search through them using a protocol called MCP. Everything runs on your own machine using local AI models, with no cloud service involved and nothing ever sent off the device. The core idea is that each file gets understood once when it is first indexed, so later questions are cheap to answer. Instead of an AI assistant reading entire files every time you ask something, it gets back a short summary card with the key fact, the source filename, and a confidence level, and only pulls the full passage if that summary is not enough. The README reports that in their own testing over a large set of files, this approach used 56 percent fewer input tokens and cut costs roughly in half compared to an assistant that reads whole files for every question. The engine can read many common file types, including PDFs, Word documents, spreadsheets, presentations, emails, and even scanned documents or photos through optical character recognition. It requires either a Mac with Apple silicon, which runs the AI models directly on the chip, or a Linux machine running a tool called Ollama to run the models instead. Setup involves installing Python, running a setup command that downloads the needed model files, and starting a local server. Once running, a user tells the engine which folders to index, and it keeps watching those folders in the background, automatically re-indexing files as they change. The assistant connects to it as an MCP tool, gaining abilities like searching files, summarizing a document, looking up people or organizations mentioned in files, and drafting a folder cleanup plan, though the README stresses that no tool actually moves or deletes files on its own. Everything is also available as a plain web API for anyone who prefers not to use MCP. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Help me install findandseek-engine and index my Documents folder.
prompt 2
Show me how to connect findandseek-engine to Claude Desktop over MCP.
prompt 3
Explain how findandseek-engine's search_files and get_file_context tools work together.
prompt 4
Help me set up findandseek-engine to run automatically on boot.

Frequently asked questions

what is findandseek-engine fr?

A local-first search engine that lets AI assistants query your own files (documents, email, code) without any cloud involved.

What language is findandseek-engine written in?

Mainly Python. The stack also includes Python, MCP, SQLite.

What license does findandseek-engine use?

Source-available, but limits commercial or competing use until a future conversion date.

How hard is findandseek-engine to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is findandseek-engine for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.