Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Reference Codebases

The user-provided list plus additions, annotated with what each is best for studying. Clone the ones in active use to ~/repos/.

Your codebases (baseline)

RepoBest for
FalkorDB/FalkorDBSparse-matrix graph engine, redis module architecture
FalkorDB/falkordb-rs-next-genRust graph engine rewrite

From your list

RepoLangBest for
redis/redisCdict incremental rehash, skiplists, event loop, RESP, AOF/RDB, rax
valkey-io/valkeyCio-threads/multithreading evolution vs redis — diff the two!
qdrant/qdrantRustHNSW, filtered ANN, quantization, raft consensus
surrealdb/surrealdbRustmulti-model design, transaction layer over pluggable KV
facebook/rocksdbC++LSM at industrial scale: compaction, block cache, txn utilities
tursodatabase/tursoRustSQLite rewrite: B-tree, pager, WAL, io_uring, DST
neo4j/neo4jJavarecord-store graph layout, Cypher planner
HelixDB/helix-dbRustgraph+vector combined engine (young codebase, easy to read)
memgraph/memgraphC++in-memory graph, skip-list storage, MVCC
ravendb/ravendbC#Voron storage engine (COW B+tree), document DB design
fjall-rs/fjallRustthe readable Rust LSM — small enough to read fully
tidesdb/tidesdbCcompact C LSM, easy first read
duckdb/duckdbC++vectorized execution, optimizer, columnar compression — very readable
postgres/postgresCMVCC, WAL, buffer manager, planner — the canon

Suggested additions

RepoLangBest for
sqlite/sqliteCbtree.c, pager, VDBE — most-deployed DB on earth
LMDB (openldap/mdb)Ccopy-on-write B+tree, single-file mmap design
skyzh/mini-lsmRustguided course — build an LSM step by step (use in topic 4)
cmu-db/bustubC++CMU 15-445 teaching DB: buffer pool, B+tree, txn labs
erikgrinaker/toydbRustreference for the capstone: raft + MVCC + SQL, written to teach
apache/datafusionRustArrow-native query engine — planner + vectorized exec in Rust
pola-rs/polarsRustvectorized columnar engine: lazy optimizer, streaming exec, SIMD kernels — DuckDB’s Rust rival
kuzudb/kuzuC++columnar graph storage, worst-case optimal joins (topic 13)
cberner/redbRustclean embedded COW B-tree in Rust
spacejam/sledRustBw-tree-inspired engine; read its post-mortems too
tikv/tikvRustraft-rs, distributed txn (Percolator) — topic 15
apple/foundationdbC++deterministic simulation testing gold standard — topic 16
ClickHouse/ClickHouseC++columnar OLAP at the extreme; read specific MergeTree parts only
unum-cloud/usearchC++compact single-header HNSW — topic 14
DrTimothyAldenDavis/GraphBLASCSuiteSparse internals — go deeper than the API you already use
GraphBLAS/LAGraphCgraph algorithms as linear algebra — the reference library over GraphBLAS (topics 20, 24)
Z3Prover/z3C++SMT solver: query-equivalence proving, invariant checking (topic 16); also a perf-engineering masterclass
quickwit-oss/tantivyRustinverted index / full-text engine — the readable Lucene (topic 23)
apache/luceneJavathe canon of search: codecs, FSTs, segment merging (topic 23)
elastic/elasticsearchJavadistributed search architecture over Lucene: shards, scatter-gather (topic 23)
RediSearch/RediSearchCsearch as a redis module — your ecosystem’s approach (topic 23)
leanprover/lean4C++/Leantheorem proving + Perceus RC runtime (topic 21)
modular/mojoMojoSIMD-first language on MLIR, CPU+GPU kernels (topics 17, 18)
TimelyDataflow/differential-dataflowRustincremental computation — the real thing (topic 27)
neondatabase/neonRustdisaggregated postgres: pageserver, safekeepers, branching (topic 28)
slatedb/slatedbRustLSM directly on object storage — small, modern (topic 28)
prometheus/prometheusGotsdb/: readable time-series storage (topic 30)
influxdata/influxdbRustIOx: DataFusion+Parquet+object storage combined (topics 11/12/28/30)
RoaringBitmap/CRoaringCcompressed bitmaps: container switching, SIMD set ops (topics 23, 26)
automerge/automergeRustCRDT engine — state/op-based, columnar op storage (topic 31)
loro-dev/loroRustfast modern CRDT engine, great perf blog posts (topic 31)
graphistry/pygraphistryPythonGPU graph ETL/analytics on RAPIDS cuDF/cuGraph, GFQL query layer — production analog to Gunrock’s research code (topics 18, 24)

What the file:line anchors were read against

The reading guides quote a few thousand file:line anchors into the codebases above. A line number only means something next to the commit it was read at, so every clone the guides reference is pinned here — once, rather than in each of the 230 guides, so the record stays consistent instead of drifting per file.

Regenerate with python3 tools/pin-table.py, or --check to see whether your clones have moved since the table was written. Both read ~/repos (override with DLP_CLONES), so this is a local command — CI has no clones and does not check it.

Clone to ~/repos/<name> and git checkout the listed commit if you want the anchors to land exactly; on a newer commit expect the structure to match and the line numbers to have moved. The mention count is there to tell you which clones are worth fetching first.

cloneread atdatedmentionsorigin
postgres701f0212026-07-10511https://github.com/postgres/postgres
redisa176d12252026-03-24495https://github.com/redis/redis
FalkorDBaa75821ab2026-08-25347https://github.com/FalkorDB/FalkorDB
duckdb6c0c1a682026-07-10334https://github.com/duckdb/duckdb
rocksdb7c80a5a2026-07-09299https://github.com/facebook/rocksdb
neon8f60b042026-05-25207https://github.com/neondatabase/neon
sqlite951de302026-07-09200https://github.com/sqlite/sqlite
GraphBLAS1fd54756ca2026-02-05187https://github.com/DrTimothyAldenDavis/GraphBLAS
qdrant44ad62f2026-06-03171https://github.com/qdrant/qdrant
tursodd775bc2026-07-10170https://github.com/tursodatabase/turso
valkey8891441ab2026-05-03155https://github.com/valkey-io/valkey
datafusion1e77af82026-07-10145https://github.com/apache/datafusion
fjall80cf6bc2026-07-05143https://github.com/fjall-rs/fjall
eggf94c3462026-04-14135https://github.com/egraphs-good/egg
hashbrownd69025b2026-07-06126https://github.com/rust-lang/hashbrown
polarsf8bcc3d2026-07-10100https://github.com/pola-rs/polars
leanstore90fcf182025-09-1196https://github.com/leanstore/leanstore
z31d425e52026-07-0996https://github.com/Z3Prover/z3
memgraph8f87f6a2026-07-0993https://github.com/memgraph/memgraph
clickhouse4d598fb2c2026-07-1092https://github.com/ClickHouse/ClickHouse
LAGraphe2539e22025-09-0891https://github.com/GraphBLAS/LAGraph
lsm-tree8526dd32026-07-0585https://github.com/fjall-rs/lsm-tree
eggloge264c37a2026-08-2576https://github.com/egraphs-good/egglog
lmdb704dc702026-06-2471https://github.com/LMDB/lmdb
raft-rsad13f3d2026-05-1369https://github.com/tikv/raft-rs
tiflashb5093dd2026-07-0962https://github.com/pingcap/tiflash
prometheusf282b5c2026-07-1061https://github.com/prometheus/prometheus
materializeb06b3d62026-07-1056https://github.com/MaterializeInc/materialize
kuzu89f02632025-10-1055https://github.com/kuzudb/kuzu
tikveb8dd652026-07-0953https://github.com/tikv/tikv
hypothesis49a797bdf2026-08-2550https://github.com/HypothesisWorks/hypothesis
neo4jeccd584a2026-07-0250https://github.com/neo4j/neo4j
go-ycsbf030f992025-12-3149https://github.com/pingcap/go-ycsb
tantivy7152d532026-07-1049https://github.com/quickwit-oss/tantivy
BlockSci14ccc932020-11-1348https://github.com/citp/BlockSci
ligra87632022024-02-1846https://github.com/jshun/ligra
pgwire6bb62992026-06-2946https://github.com/sunng87/pgwire
cockroacha7e117882026-07-0645https://github.com/cockroachdb/cockroach
usearch9fd6b012026-05-2445https://github.com/unum-cloud/usearch
benchbase33c00472025-12-1340https://github.com/cmu-db/benchbase
rayon6d9e94b2026-06-2740https://github.com/rayon-rs/rayon
ALEX4370da62024-03-1239https://github.com/microsoft/ALEX
tidesdb810507a2026-07-1039https://github.com/tidesdb/tidesdb
slatedb323ed1b2026-07-1038https://github.com/slatedb/slatedb
cudf2f082a72026-07-1037https://github.com/rapidsai/cudf
gunrock748f79e2026-02-0935https://github.com/gunrock/gunrock
memchr5fdb40c2026-07-0735https://github.com/BurntSushi/memchr
SimSIMD63a254f2026-05-2335https://github.com/ashvardanian/SimSIMD
wgpuf945c782026-07-1034https://github.com/gfx-rs/wgpu
sqlanceraf6ae852026-06-2133https://github.com/sqlancer/sqlancer
gapbsb5e3e192024-05-1132https://github.com/sbeamer/gapbs
raft.tla6ecbdbc2025-02-1830https://github.com/ongardie/raft.tla
RediSearch87276ca2026-07-0930https://github.com/RediSearch/RediSearch
raphtory5d0d2862026-07-2129https://github.com/Pometry/Raphtory
foundationdb4c775a92026-07-1028https://github.com/apple/foundationdb
simdjsonc7838092026-07-1028https://github.com/simdjson/simdjson
tidbb94006d2026-07-1028https://github.com/pingcap/tidb
splink04189f52026-07-2327https://github.com/moj-analytical-services/splink
quickwita5ad5402026-07-0826https://github.com/quickwit-oss/quickwit
risingwave119de0a2026-07-1025https://github.com/risingwavelabs/risingwave
surrealdb9d9a5b02026-07-0225https://github.com/surrealdb/surrealdb
crossbeam6b7458d2026-07-1023https://github.com/crossbeam-rs/crossbeam
cr-sqlite891fe9e2024-10-2521https://github.com/vlcn-io/cr-sqlite
lorob81abfc2026-07-0720https://github.com/loro-dev/loro
diamond-typesad48b9c2026-05-2919https://github.com/josephg/diamond-types
sqlparser-rsaeb616f2026-07-0319https://github.com/apache/datafusion-sqlparser-rs
influxdbd7834112026-06-1718https://github.com/influxdata/influxdb
roaring-rs83caaca2026-04-2418https://github.com/RoaringBitmap/roaring-rs
spicedb84224832026-07-2416https://github.com/authzed/spicedb
cranelift-jit-demo3e5e9b62025-11-0715https://github.com/bytecodealliance/cranelift-jit-demo
VictoriaMetricsc1e39b22026-07-1015https://github.com/VictoriaMetrics/VictoriaMetrics
automergec39339d2026-07-1014https://github.com/automerge/automerge
GraphRAG-SDKf42ab3d2026-04-1214https://github.com/FalkorDB/GraphRAG-SDK
arrow-rsfed78622026-07-1013https://github.com/apache/arrow-rs
bloodhound19683882026-07-2413https://github.com/SpecterOps/BloodHound
felderabb490552026-07-1013https://github.com/feldera/feldera
falkordb-rs-next-gen9d28bdc62026-07-2910https://github.com/FalkorDB/falkordb-rs-next-gen
RedisBloomab734fa2026-07-059https://github.com/RedisBloom/RedisBloom
cuvs8b97b612026-07-107https://github.com/rapidsai/cuvs
differential-dataflow3f279da2026-05-295https://github.com/TimelyDataflow/differential-dataflow
falkordb-py122df792026-07-195https://github.com/FalkorDB/falkordb-py
PGM-indexc6fcf3d2024-11-285https://github.com/gvinciguerra/PGM-index
pytorch_geometric1f0661c2026-06-195https://github.com/pyg-team/pytorch_geometric
RustyTaintChain4e12fd02021-03-055https://github.com/TaintChain/RustyTaintChain
y-crdt03e14a02026-06-123https://github.com/y-crdt/y-crdt
antithesis-sdk-rust78c9db52026-06-122https://github.com/antithesishq/antithesis-sdk-rust
helix-db47191c62026-07-052https://github.com/HelixDB/helix-db
timely-dataflow15fc7c92026-06-122https://github.com/TimelyDataflow/timely-dataflow