git404hub

what is local-recall fr?

anshupriyan/local-recall — explained in plain English

Analysis updated 2026-05-18

17PythonAudience · vibe coderComplexity · 4/5Setup · moderate

tl;dr

A local, privacy-first alternative to Windows Recall that screenshots your screen, reads the text, and lets you search or chat with your history offline.

vibe map

mindmap
  root((Local Recall))
    What it does
      Captures screenshots
      OCRs screen text
      Chats with local LLM
    Tech stack
      Python
      SQLite
      sentence-transformers
    Use cases
      Search screen history
      Chat about past activity
      Browse via local web UI
    Audience
      Privacy focused vibe coders

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

Semantically search your own screen history for something you remember seeing but can't locate.

VIBE 2

Chat with a local AI assistant about what you were doing on your computer, with no data leaving your machine.

VIBE 3

Browse a visual timeline of past screenshots through a local web interface.

what's the stack?

PythonSQLiteFlasksentence-transformerssqlite-vec

how it stacks up fr

anshupriyan/local-recall0petru/sentimoagi-eval-official/forte
Stars171717
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity4/53/54/5
Audiencevibe coderdeveloperdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Windows 10/11 only, and requires LM Studio running a local model before the chat features work.

in plain english

Local Recall is an early prototype that works like Microsoft's Windows Recall feature, but keeps everything on your own computer instead of sending anything to the cloud. It periodically takes screenshots of your screen, reads the text out of them, and lets you later search through your history by meaning, or ask a local AI assistant questions about what you were looking at. The README is upfront that this is an early proof of concept still under active development, with things like the database structure likely to change. The pipeline works in stages. A capture loop takes a screenshot every five seconds and compares it to the previous one using a perceptual hash, skipping duplicates so unchanged screens do not pile up in storage. A background worker then reads text out of new screenshots using Windows' built in OCR engine. Another background worker turns that extracted text into numerical representations, called embeddings, using a small local language model, and stores them in a SQLite database extended with a vector search add on, which allows fast similarity based searches over your history. A locally run large language model, connected through a tool called LM Studio, uses those search results to answer questions you type about your past screen activity. Because it relies on Windows' built in OCR and some Windows specific system calls, it only runs on Windows 10 or 11. Setting it up involves installing LM Studio and loading a language model in it, creating a Python virtual environment, installing the pinned dependencies, and editing a configuration file to set things like how often screenshots are taken and which local model to use. Once running, you can search your history from the command line, chat with an assistant about it in a terminal, or use a simple local web page that shows matching screenshots. The README does not mention a software license.

prompts (copy fr)

prompt 1
Help me set up Local Recall on Windows, including installing LM Studio and loading a compatible model.
prompt 2
Explain how Local Recall's capture, OCR, and embedding pipeline fits together across its background workers.
prompt 3
Walk me through configuring the .env file for Local Recall's capture interval and embedding model.
prompt 4
How do I search my screen history from the command line using query.py, and how is that different from chat.py?

Frequently asked questions

what is local-recall fr?

A local, privacy-first alternative to Windows Recall that screenshots your screen, reads the text, and lets you search or chat with your history offline.

What language is local-recall written in?

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

How hard is local-recall to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is local-recall for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.