olean-export
Rust library to read Lean .olean files directly in Rust and emit the lean4export NDJSON stream for external kernel checkers without using Lean compiler directly.
The big idea is an .olean is already a compacted heap image of lean.h objects, so the reader walks those objects, hash-conses names, levels and expressions, and writes the same records lean4export would, in dependency order. But much faster.
The object layout is tied to the Lean release. This version reads olean format v2 as written by Lean 4.26 through 4.35, and refuses files from any other release.
Add --features mimalloc to build with the mimalloc allocator.
Example
examples/Hello.lean is compiled to an olean with plain lean:
def double (n : Nat) : Nat := n + n
theorem double_two : double 2 = 4 := rfl
Export one theorem with everything it depends on, then check it with a kernel such as nano-lean. Inside a Lake project, lake env sets LEAN_PATH for you, so you can run:
)
Without -c it exports every constant reachable from the module, like lean4export Hello.
BLean
Blean is a new binary format that is more efficient to mmap and read than NDJSON.
Add -f blean for the same stream in a compact binary form, see docs/BLEAN.md.
Performance
Modules decode in parallel on every core, and -j N sets the thread count. The output is identical for any -j. With -c, theorem values outside the cone stay undecoded. --rss shows peak resident memory.
Wall time:
| Target | lean4export | olean-export | Speedup |
|---|---|---|---|
Small model on Lean |
18.3s | 1.0s | 18x |
| All of Mathlib | 1526s | 18s | 85x |
One Mathlib theorem (-c) |
16.5s | 5.3s | 3x |
Peak memory:
| Target | lean4export | olean-export |
|---|---|---|
Small model on Lean |
1.3 GB | 0.5 GB |
| All of Mathlib | 9.4 GB | 4.3 GB |
One Mathlib theorem (-c) |
5.6 GB | 2.0 GB |
Mathlib is on Lean 4.35.0 (712,205 declarations, identical under compare), and the theorem is Fin.insertNth_apply_succAbove.
Inspect
inspect summarizes an olean's imports, constants and bytes per section. -c lists every constant.
)
)
)
Compare
compare diffs two exports, NDJSON or blean, ignoring record order, ids and binders.
Statement
statement prints every definition, structure and axiom a theorem's statement rests on, as raw terms with source lines and no proofs, so you can review the trusted base of, say, a Tau Ceti theorem without reading all of Tau Ceti. --trust hides what you already believe, and -f ndjson exports the cone for a checker.
License
MIT Licensed. Copyright 2026 Stephen Diehl. See LICENSE for details.