lilbee

lilbee v0.6.66b
Elastic License 2.0 100% coverage typed

A terminal-first local search engine for your files, code, the web, and scanned documents.

One install, no sidecar services, fully offline by default. Ships a TUI, MCP server, REST API, and Python library.

preview
lilbee chat . owner's manuals [qwen3:0.6b]
>what does the oil pressure warning mean?
the oil pressure warning indicates low oil pressure.[1]
when the light stays on, stop the engine immediately.[2]
─── sources ─────────────────────────────────
[1] owners-manual.pdf:42    [2] owners-manual.pdf:43
>
what it does

personal encyclopedia

Index PDFs, notes, ebooks, code. Every answer clicks back to the source line. Private Encarta you build from your own files.

grounding for AI agents

Plug into any MCP agent. It reads the code it's about to call, cites file and line, and says "I don't know" instead of guessing.

offline copies of websites

One command to crawl a docs site or wiki, convert to markdown, and index. Search and chat with it offline, even if it goes down.

scans & OCR

Paper archives and photos go through Tesseract or a local vision GGUF, landing as searchable markdown with layout preserved.

install
$ pip install --pre lilbee

extras: [crawler] websites   [litellm] frontier models   [graph] concept-graph search

uv: uv tool install --prerelease=allow lilbee

homebrew: brew tap tobocop2/lilbee && brew install lilbee

arch (AUR): paru -S lilbee

docker: docker run --rm ghcr.io/tobocop2/lilbee:latest

cuda (opt-in, NVIDIA-native): --extra-index-url https://tobocop2.github.io/lilbee/cu125/

beta: every release is a pre-release. latest on pypi →

go deeper
lilbee  .  Elastic License 2.0