Skip to contentShawn Oakley

Back to Design notes

Why the engine stays Python

Decision. Every check the site shows will be computed by the citecheck Python package, called through a thin FastAPI service. The site will never re-implement a check in TypeScript.

Why. The accuracy numbers the site publishes will be measured on the Python package. If the site ran a TypeScript port, those numbers would describe different code. Pinning the package version in api/pyproject.toml, and showing that version in the site footer, makes the link checkable.

What I rejected.

Cost. Keys pass through a server function. Request bodies are capped at 4.5 MB, so PDFs are read in the browser and only text is sent.