Skip to content

fun facts

Bryan edited this page Jun 13, 2026 · 1 revision

Fun facts

This page collects a few small discoveries from the repository survey.

The name fits the job

"Lode" points at a vein of ore, which fits a tool that mines a local repository for symbols, paths, and dependency facts. The package name in pyproject.toml is lode-kg, where kg stands for knowledge graph.

The longest files are the hard parts

The largest source files line up with the core product questions:

File Lines Theme
src/lode/indexer.py 691 What facts are in the repo?
src/lode/graph.py 680 How do facts connect?
src/lode/storage.py 553 How are facts queried quickly?

The hot path is intentionally boring

The default runtime dependencies list in pyproject.toml is empty. SQLite from the Python standard library carries the main search, symbol, context, and graph hot path in src/lode/storage.py.

Optional graph and vector paths stay local

Kuzu is an optional extra in pyproject.toml, and embeddings point at a local TEI-compatible endpoint through src/lode/embeddings.py. The default design does not require a hosted code-search or vector service.

Related pages

Clone this wiki locally