Skip to content

Examples

Every script below lives in examples/ in the repository and is independently runnable — each connects to a temporary SQLite database, runs, prints what it's doing, and cleans up after itself.

uv sync
uv run python examples/quickstart.py
uv run python examples/governance_and_review.py
uv run python examples/bitemporal_queries.py
uv run python examples/writing_a_plugin.py
uv run python examples/hybrid_search.py
uv run python examples/erasing_personal_data.py
Script Demonstrates Tutorial
quickstart.py Connecting, schema, principals, entities, literal/ref assertions, provenance Getting Started
governance_and_review.py AI-vs-human proposal paths, request_changes → resubmit → accept, contradiction routing Governance & Review
bitemporal_queries.py time_varying supersession, an injected FixedClock, as_of(t) time-travel Bitemporal Queries
writing_a_plugin.py Registering & calling a real reference plugin through the process-isolated sandbox Writing a Plugin
hybrid_search.py .semantic(), symbolic .where() intersection, .min_confidence() Hybrid Search
erasing_personal_data.py A redaction-mode knowledge base, personal schema marks, erase_subject, Assertion.redacted, confirming the bytes are gone from the file Erasing Personal Data

These same scripts are run in CI (ci.yml's "Tests" job) against every push to main, so they stay accurate as the API evolves — if one of them breaks, that's a CI failure, not a stale doc.