Skip to content

iladub — íl · dub, the document-carrier

iladub

The document-carrier — compiling human documents into knowledge machines can read.

iladub (𒅍𒁾 · Sumerian íl "to lift, to carry, to bring forward" + dub "clay tablet, document") compiles human-addressed documents — reports, notes, papers, contracts, in any format — into FAIR, contract-defined semantic knowledge graphs, and, increasingly, into active, governed holons: knowledge units that carry their own boundary, interact with their context, and change state only through accountable decisions. It is the reference implementation of the ET(K)L method (Extract, Transform-with-(K)nowledge, Load), whose persistent namespace is https://w3id.org/iladub/etkl.

There is no unstructured data — only human-addressed structure a machine has not been taught to read. iladub recovers that structure and carries it forward, without flattening it into tokens at the input or rows at the output. Read the manifesto →

Note

Early development — APIs are not yet stable.

Why iladub

Five thousand years ago in Sumer, the first documents were clay tablets — and the sign 𒅍 (íl) that opens this project's name means carrier: one who lifts a value and brings it forward. We still write documents for humans; a machine, like a non-scribe before the clay, sees only marks. Reading a document means recovering the knowledge behind it — the concepts and how they relate — at the level knowledge actually lives: holonic graphs, on top of meta- and hypergraphs. iladub compiles human documents into that level, knowledge-first. Read the full story →

What it does

  • Compiles a whole document (prose, tables, figures) and lets a semantic contract decide what becomes a typed object, from wherever it lives.
  • Asserts only what it can ground in a provided ontology; everything else is proposed, never faked, and admitted only through an accountable promotion decision.
  • Carries provenance to the page and converges table, prose, and figure mentions onto the same concept IRIs.
  • Produces active, governed holons, not just static graphs — units whose boundary is both a semantic membrane and an access boundary: every state change at the interface is an accountable decision, and any agent inherits exactly the interacting user's access.

Explore

Installation

pip install iladub

Quickstart

# Compile a synthetic transplant organ offer into an M4 acceptance decision
# (live; needs ANTHROPIC_API_KEY)
iladub m4 examples/transplant/offer.txt

License

iladub is dual-licensed: