git404hub

what is fidx fr?

williamliu-ai/fidx — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerLicenseSetup · moderate

tl;dr

A fast, fully local search engine for your own files that keyword and meaning based search into one SQLite file, ideal for AI agents.

vibe map

mindmap
  root((fidx))
    What it does
      Local file search
      Keyword plus meaning search
      Agent friendly output
    Tech stack
      Python
      SQLite
      FTS5
      ONNX embeddings
    Use cases
      Private RAG retrieval
      Search notes and code
      Agent memory backend
    Audience
      Developers
      AI agent builders
      Privacy focused users

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

Give an AI agent fast, private search over your notes, code, or chat exports without cloud calls.

VIBE 2

Search a large local collection of markdown or text files by meaning, not just exact keywords.

VIBE 3

Back up or move your entire search index by copying a single SQLite file.

what's the stack?

PythonSQLiteFTS5sqlite-vecONNX

how it stacks up fr

williamliu-ai/fidx0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity2/52/5
Audiencedevelopergeneralgeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Needs Python 3.11 or 3.12 with loadable SQLite extensions, macOS requires Homebrew Python, not the system default.

in plain english

fidx is a local search engine for your own files, built so that both people and AI agents can quickly find relevant documents without sending anything to the cloud. It indexes markdown files, plain text, chat exports, and code, then lets you search that content using a mix of exact keyword matching and meaning based matching, so a search can find a document even if it does not use the exact same words you typed. Everything runs on your own computer's processor, with no GPU and no API keys required. What makes fidx different from some other local search tools is speed. Many similar tools use an AI language model to rephrase your query or double check the results, which can take around ten seconds per search. fidx skips that step entirely, relying instead on a fast combination of keyword search and a single lightweight embedding calculation per query, which keeps most searches under a tenth of a second once the tool has warmed up. All of the indexed data, including the documents themselves, the keyword index, and the vector data used for meaning based search, lives inside one single SQLite database file that can be copied, backed up, or deleted as a unit. You use fidx from the command line. You register folders as named collections, run an indexing command that scans and processes the files, and then search either across everything or scoped to one collection. There is also a background mode that keeps the search model loaded in memory so that repeated searches run in milliseconds instead of needing to reload each time, which is especially useful when an AI agent is calling it repeatedly. Search results can be returned as JSON, making fidx easy to plug into an agent's toolset as a private retrieval layer. Installing it requires Python 3.11 or 3.12 with a specific SQLite feature enabled, and the project explains exactly how to check and fix this on Linux, Windows, and macOS, since macOS needs a Homebrew-installed Python rather than the default one. The first time you index files, it downloads a small embedding model, after which the tool works fully offline. It is released under the MIT license with an additional AI attribution clause.

prompts (copy fr)

prompt 1
Walk me through installing fidx on macOS with a Homebrew Python so the SQLite extensions work.
prompt 2
Show me how to register a folder as a collection and search it with fidx.
prompt 3
Explain the difference between fidx's default, knee, and calibrated truncation modes.
prompt 4
Help me wire fidx search --json into an agent tool so it can retrieve relevant documents.

Frequently asked questions

what is fidx fr?

A fast, fully local search engine for your own files that keyword and meaning based search into one SQLite file, ideal for AI agents.

What language is fidx written in?

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

How hard is fidx to set up?

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

Who is fidx for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.